feat(translate): update the API

yoshi-automation · sofisl · commit b2cc28c90e1f · 2025-01-28T16:50:58.000-08:00
#### translate:v3beta1

The following keys were added:
- schemas.TranslateTextGlossaryConfig.properties.contextualTranslationEnabled.description
- schemas.TranslateTextGlossaryConfig.properties.contextualTranslationEnabled.type

The following keys were changed:
- resources.projects.resources.locations.methods.batchTranslateDocument.scopes
- resources.projects.resources.locations.methods.batchTranslateText.scopes
- resources.projects.resources.locations.resources.glossaries.methods.create.scopes
- resources.projects.resources.locations.resources.operations.methods.cancel.description
- schemas.TranslateTextGlossaryConfig.description

#### translate:v3

The following keys were added:
- schemas.GlossaryConfig.properties.contextualTranslationEnabled.description
- schemas.GlossaryConfig.properties.contextualTranslationEnabled.type
- schemas.TranslateTextGlossaryConfig.properties.contextualTranslationEnabled.description
- schemas.TranslateTextGlossaryConfig.properties.contextualTranslationEnabled.type

The following keys were changed:
- resources.projects.resources.locations.methods.batchTranslateDocument.scopes
- resources.projects.resources.locations.methods.batchTranslateText.scopes
- resources.projects.resources.locations.resources.operations.methods.cancel.description
diff --git a/discovery/translate-v3.json b/discovery/translate-v3.json
@@ -291,7 +291,8 @@
                 "$ref": "Operation"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform"
+                "https://www.googleapis.com/auth/cloud-platform",
+                "https://www.googleapis.com/auth/cloud-translation"
               ]
             },
             "batchTranslateText": {
@@ -319,7 +320,8 @@
                 "$ref": "Operation"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform"
+                "https://www.googleapis.com/auth/cloud-platform",
+                "https://www.googleapis.com/auth/cloud-translation"
               ]
             },
             "detectLanguage": {
@@ -1550,7 +1552,7 @@
             "operations": {
               "methods": {
                 "cancel": {
-                  "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+                  "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
                   "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel",
                   "httpMethod": "POST",
                   "id": "translate.projects.locations.operations.cancel",
@@ -1708,7 +1710,7 @@
       }
     }
   },
-  "revision": "20240912",
+  "revision": "20241218",
   "rootUrl": "https://translation.googleapis.com/",
   "schemas": {
     "AdaptiveMtDataset": {
@@ -2372,6 +2374,10 @@
       "description": "Configures which glossary is used for a specific target language and defines options for applying that glossary.",
       "id": "GlossaryConfig",
       "properties": {
+        "contextualTranslationEnabled": {
+          "description": "Optional. If set to true, the glossary will be used for contextual translation.",
+          "type": "boolean"
+        },
         "glossary": {
           "description": "Required. The `glossary` to be applied for this translation. The format depends on the glossary: - User-provided custom glossary: `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`",
           "type": "string"
@@ -3123,6 +3129,10 @@
       "description": "Configures which glossary is used for a specific target language and defines options for applying that glossary.",
       "id": "TranslateTextGlossaryConfig",
       "properties": {
+        "contextualTranslationEnabled": {
+          "description": "Optional. If set to true, the glossary will be used for contextual translation.",
+          "type": "boolean"
+        },
         "glossary": {
           "description": "Required. The `glossary` to be applied for this translation. The format depends on the glossary: - User-provided custom glossary: `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`",
           "type": "string"
diff --git a/discovery/translate-v3beta1.json b/discovery/translate-v3beta1.json
@@ -233,7 +233,8 @@
                 "$ref": "Operation"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform"
+                "https://www.googleapis.com/auth/cloud-platform",
+                "https://www.googleapis.com/auth/cloud-translation"
               ]
             },
             "batchTranslateText": {
@@ -261,7 +262,8 @@
                 "$ref": "Operation"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform"
+                "https://www.googleapis.com/auth/cloud-platform",
+                "https://www.googleapis.com/auth/cloud-translation"
               ]
             },
             "detectLanguage": {
@@ -484,7 +486,8 @@
                     "$ref": "Operation"
                   },
                   "scopes": [
-                    "https://www.googleapis.com/auth/cloud-platform"
+                    "https://www.googleapis.com/auth/cloud-platform",
+                    "https://www.googleapis.com/auth/cloud-translation"
                   ]
                 },
                 "delete": {
@@ -586,7 +589,7 @@
             "operations": {
               "methods": {
                 "cancel": {
-                  "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+                  "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
                   "flatPath": "v3beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel",
                   "httpMethod": "POST",
                   "id": "translate.projects.locations.operations.cancel",
@@ -744,7 +747,7 @@
       }
     }
   },
-  "revision": "20230922",
+  "revision": "20241218",
   "rootUrl": "https://translation.googleapis.com/",
   "schemas": {
     "BatchDocumentInputConfig": {
@@ -1401,9 +1404,13 @@
       "type": "object"
     },
     "TranslateTextGlossaryConfig": {
-      "description": "Configures which glossary should be used for a specific target language, and defines options for applying that glossary.",
+      "description": "----------------------------------------------------------------------------- Configures which glossary should be used for a specific target language, and defines options for applying that glossary.",
       "id": "TranslateTextGlossaryConfig",
       "properties": {
+        "contextualTranslationEnabled": {
+          "description": "Optional. If set to true, the glossary will be used for contextual translation.",
+          "type": "boolean"
+        },
         "glossary": {
           "description": "Required. Specifies the glossary used for this translation. Use this format: projects/*/locations/*/glossaries/*",
           "type": "string"
diff --git a/src/apis/translate/v3.ts b/src/apis/translate/v3.ts
@@ -635,6 +635,10 @@ export namespace translate_v3 {
    * Configures which glossary is used for a specific target language and defines options for applying that glossary.
    */
   export interface Schema$GlossaryConfig {
+    /**
+     * Optional. If set to true, the glossary will be used for contextual translation.
+     */
+    contextualTranslationEnabled?: boolean | null;
     /**
      * Required. The `glossary` to be applied for this translation. The format depends on the glossary: - User-provided custom glossary: `projects/{project-number-or-id\}/locations/{location-id\}/glossaries/{glossary-id\}`
      */
@@ -1217,6 +1221,10 @@ export namespace translate_v3 {
    * Configures which glossary is used for a specific target language and defines options for applying that glossary.
    */
   export interface Schema$TranslateTextGlossaryConfig {
+    /**
+     * Optional. If set to true, the glossary will be used for contextual translation.
+     */
+    contextualTranslationEnabled?: boolean | null;
     /**
      * Required. The `glossary` to be applied for this translation. The format depends on the glossary: - User-provided custom glossary: `projects/{project-number-or-id\}/locations/{location-id\}/glossaries/{glossary-id\}`
      */
@@ -6063,7 +6071,7 @@ export namespace translate_v3 {
     }
 
     /**
-     * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
+     * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
diff --git a/src/apis/translate/v3beta1.ts b/src/apis/translate/v3beta1.ts
@@ -629,9 +629,13 @@ export namespace translate_v3beta1 {
     model?: string | null;
   }
   /**
-   * Configures which glossary should be used for a specific target language, and defines options for applying that glossary.
+   * ----------------------------------------------------------------------------- Configures which glossary should be used for a specific target language, and defines options for applying that glossary.
    */
   export interface Schema$TranslateTextGlossaryConfig {
+    /**
+     * Optional. If set to true, the glossary will be used for contextual translation.
+     */
+    contextualTranslationEnabled?: boolean | null;
     /**
      * Required. Specifies the glossary used for this translation. Use this format: projects/x/locations/x/glossaries/x
      */
@@ -2309,7 +2313,7 @@ export namespace translate_v3beta1 {
     }
 
     /**
-     * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
+     * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
