google-api-client 0.42.0 → 0.44.1

data/generated/google/apis/translate_v3/service.rb

@@ -49,14 +49,12 @@ module Google
         
         # Detects the language of text within a request.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`/locations/`location-id`` or
-        #   `projects/`project-number-or-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Only models within the same region (has same location-id) can be used.
-        #   Otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`/locations/`location-id`` or `
+        #   projects/`project-number-or-id``. For global calls, use `projects/`project-
+        #   number-or-id`/locations/global` or `projects/`project-number-or-id``. Only
+        #   models within the same region (has same location-id) can be used. Otherwise an
+        #   INVALID_ARGUMENT (400) error is returned.
         # @param [Google::Apis::TranslateV3::DetectLanguageRequest] detect_language_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -89,29 +87,25 @@ module Google
         
         # Returns a list of supported languages for translation.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`` or
-        #   `projects/`project-number-or-id`/locations/`location-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Non-global location is required for AutoML models.
-        #   Only models within the same region (have same location-id) can be used,
-        #   otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`` or `projects/`project-number-or-id`/
+        #   locations/`location-id``. For global calls, use `projects/`project-number-or-
+        #   id`/locations/global` or `projects/`project-number-or-id``. Non-global
+        #   location is required for AutoML models. Only models within the same region (
+        #   have same location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+        #   is returned.
         # @param [String] display_language_code
-        #   Optional. The language to use to return localized, human readable names
-        #   of supported languages. If missing, then display names are not returned
-        #   in a response.
+        #   Optional. The language to use to return localized, human readable names of
+        #   supported languages. If missing, then display names are not returned in a
+        #   response.
         # @param [String] model
-        #   Optional. Get supported languages of this model.
-        #   The format depends on model type:
-        #   - AutoML Translation models:
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/`model-id``
-        #   - General (built-in) models:
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/general/nmt`,
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/general/base`
-        #   Returns languages supported by the specified model.
-        #   If missing, we get supported languages of Google general base (PBMT) model.
+        #   Optional. Get supported languages of this model. The format depends on model
+        #   type: - AutoML Translation models: `projects/`project-number-or-id`/locations/`
+        #   location-id`/models/`model-id`` - General (built-in) models: `projects/`
+        #   project-number-or-id`/locations/`location-id`/models/general/nmt`, `projects/`
+        #   project-number-or-id`/locations/`location-id`/models/general/base` Returns
+        #   languages supported by the specified model. If missing, we get supported
+        #   languages of Google general base (PBMT) model.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -143,16 +137,13 @@ module Google
         
         # Translates input text and returns translated text.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`` or
-        #   `projects/`project-number-or-id`/locations/`location-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Non-global location is required for requests using AutoML models or
-        #   custom glossaries.
-        #   Models and glossaries must be within the same region (have same
-        #   location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`` or `projects/`project-number-or-id`/
+        #   locations/`location-id``. For global calls, use `projects/`project-number-or-
+        #   id`/locations/global` or `projects/`project-number-or-id``. Non-global
+        #   location is required for requests using AutoML models or custom glossaries.
+        #   Models and glossaries must be within the same region (have same location-id),
+        #   otherwise an INVALID_ARGUMENT (400) error is returned.
         # @param [Google::Apis::TranslateV3::TranslateTextRequest] translate_text_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -183,19 +174,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Translates a large volume of text in asynchronous batch mode.
-        # This function provides real-time output as the inputs are being processed.
-        # If caller cancels a request, the partial results (for an input file, it's
-        # all or nothing) may still be available on the specified output location.
-        # This call returns immediately and you can
-        # use google.longrunning.Operation.name to poll the status of the call.
+        # Translates a large volume of text in asynchronous batch mode. This function
+        # provides real-time output as the inputs are being processed. If caller cancels
+        # a request, the partial results (for an input file, it's all or nothing) may
+        # still be available on the specified output location. This call returns
+        # immediately and you can use google.longrunning.Operation.name to poll the
+        # status of the call.
         # @param [String] parent
-        #   Required. Location to make a call. Must refer to a caller's project.
-        #   Format: `projects/`project-number-or-id`/locations/`location-id``.
-        #   The `global` location is not supported for batch translation.
-        #   Only AutoML Translation models or glossaries within the same region (have
-        #   the same location-id) can be used, otherwise an INVALID_ARGUMENT (400)
-        #   error is returned.
+        #   Required. Location to make a call. Must refer to a caller's project. Format: `
+        #   projects/`project-number-or-id`/locations/`location-id``. The `global`
+        #   location is not supported for batch translation. Only AutoML Translation
+        #   models or glossaries within the same region (have the same location-id) can be
+        #   used, otherwise an INVALID_ARGUMENT (400) error is returned.
         # @param [Google::Apis::TranslateV3::BatchTranslateTextRequest] batch_translate_text_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -228,14 +218,12 @@ module Google
         
         # Detects the language of text within a request.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`/locations/`location-id`` or
-        #   `projects/`project-number-or-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Only models within the same region (has same location-id) can be used.
-        #   Otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`/locations/`location-id`` or `
+        #   projects/`project-number-or-id``. For global calls, use `projects/`project-
+        #   number-or-id`/locations/global` or `projects/`project-number-or-id``. Only
+        #   models within the same region (has same location-id) can be used. Otherwise an
+        #   INVALID_ARGUMENT (400) error is returned.
         # @param [Google::Apis::TranslateV3::DetectLanguageRequest] detect_language_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -298,29 +286,25 @@ module Google
         
         # Returns a list of supported languages for translation.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`` or
-        #   `projects/`project-number-or-id`/locations/`location-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Non-global location is required for AutoML models.
-        #   Only models within the same region (have same location-id) can be used,
-        #   otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`` or `projects/`project-number-or-id`/
+        #   locations/`location-id``. For global calls, use `projects/`project-number-or-
+        #   id`/locations/global` or `projects/`project-number-or-id``. Non-global
+        #   location is required for AutoML models. Only models within the same region (
+        #   have same location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+        #   is returned.
         # @param [String] display_language_code
-        #   Optional. The language to use to return localized, human readable names
-        #   of supported languages. If missing, then display names are not returned
-        #   in a response.
+        #   Optional. The language to use to return localized, human readable names of
+        #   supported languages. If missing, then display names are not returned in a
+        #   response.
         # @param [String] model
-        #   Optional. Get supported languages of this model.
-        #   The format depends on model type:
-        #   - AutoML Translation models:
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/`model-id``
-        #   - General (built-in) models:
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/general/nmt`,
-        #   `projects/`project-number-or-id`/locations/`location-id`/models/general/base`
-        #   Returns languages supported by the specified model.
-        #   If missing, we get supported languages of Google general base (PBMT) model.
+        #   Optional. Get supported languages of this model. The format depends on model
+        #   type: - AutoML Translation models: `projects/`project-number-or-id`/locations/`
+        #   location-id`/models/`model-id`` - General (built-in) models: `projects/`
+        #   project-number-or-id`/locations/`location-id`/models/general/nmt`, `projects/`
+        #   project-number-or-id`/locations/`location-id`/models/general/base` Returns
+        #   languages supported by the specified model. If missing, we get supported
+        #   languages of Google general base (PBMT) model.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -391,16 +375,13 @@ module Google
         
         # Translates input text and returns translated text.
         # @param [String] parent
-        #   Required. Project or location to make a call. Must refer to a caller's
-        #   project.
-        #   Format: `projects/`project-number-or-id`` or
-        #   `projects/`project-number-or-id`/locations/`location-id``.
-        #   For global calls, use `projects/`project-number-or-id`/locations/global` or
-        #   `projects/`project-number-or-id``.
-        #   Non-global location is required for requests using AutoML models or
-        #   custom glossaries.
-        #   Models and glossaries must be within the same region (have same
-        #   location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
+        #   Required. Project or location to make a call. Must refer to a caller's project.
+        #   Format: `projects/`project-number-or-id`` or `projects/`project-number-or-id`/
+        #   locations/`location-id``. For global calls, use `projects/`project-number-or-
+        #   id`/locations/global` or `projects/`project-number-or-id``. Non-global
+        #   location is required for requests using AutoML models or custom glossaries.
+        #   Models and glossaries must be within the same region (have same location-id),
+        #   otherwise an INVALID_ARGUMENT (400) error is returned.
         # @param [Google::Apis::TranslateV3::TranslateTextRequest] translate_text_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -431,8 +412,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a glossary and returns the long-running operation. Returns
-        # NOT_FOUND, if the project doesn't exist.
+        # Creates a glossary and returns the long-running operation. Returns NOT_FOUND,
+        # if the project doesn't exist.
         # @param [String] parent
         #   Required. The project name.
         # @param [Google::Apis::TranslateV3::Glossary] glossary_object
@@ -465,9 +446,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a glossary, or cancels glossary construction
-        # if the glossary isn't created yet.
-        # Returns NOT_FOUND, if the glossary doesn't exist.
+        # Deletes a glossary, or cancels glossary construction if the glossary isn't
+        # created yet. Returns NOT_FOUND, if the glossary doesn't exist.
         # @param [String] name
         #   Required. The name of the glossary to delete.
         # @param [String] fields
@@ -497,8 +477,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
-        # exist.
+        # Gets a glossary. Returns NOT_FOUND, if the glossary doesn't exist.
         # @param [String] name
         #   Required. The name of the glossary to retrieve.
         # @param [String] fields
@@ -528,22 +507,32 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
-        # exist.
+        # Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't exist.
         # @param [String] parent
         #   Required. The name of the project from which to list all of the glossaries.
         # @param [String] filter
-        #   Optional. Filter specifying constraints of a list operation.
-        #   Filtering is not supported yet, and the parameter currently has no effect.
-        #   If missing, no filtering is performed.
+        #   Optional. Filter specifying constraints of a list operation. Specify the
+        #   constraint by the format of "key=value", where key must be "src" or "tgt", and
+        #   the value must be a valid language code. For multiple restrictions,
+        #   concatenate them by "AND" (uppercase only), such as: "src=en-US AND tgt=zh-CN".
+        #   Notice that the exact match is used here, which means using 'en-US' and 'en'
+        #   can lead to different results, which depends on the language code you used
+        #   when you create the glossary. For the unidirectional glossaries, the "src" and
+        #   "tgt" add restrictions on the source and target language code separately. For
+        #   the equivalent term set glossaries, the "src" and/or "tgt" add restrictions on
+        #   the term set. For example: "src=en-US AND tgt=zh-CN" will only pick the
+        #   unidirectional glossaries which exactly match the source language code as "en-
+        #   US" and the target language code "zh-CN", but all equivalent term set
+        #   glossaries which contain "en-US" and "zh-CN" in their language set will be
+        #   picked. If missing, no filtering is performed.
         # @param [Fixnum] page_size
         #   Optional. Requested page size. The server may return fewer glossaries than
         #   requested. If unspecified, the server picks an appropriate default.
         # @param [String] page_token
         #   Optional. A token identifying a page of results the server should return.
         #   Typically, this is the value of [ListGlossariesResponse.next_page_token]
-        #   returned from the previous call to `ListGlossaries` method.
-        #   The first page is returned if `page_token`is empty or missing.
+        #   returned from the previous call to `ListGlossaries` method. The first page is
+        #   returned if `page_token`is empty or missing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -574,15 +563,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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,
+        # 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 [String] name
         #   The name of the operation resource to be cancelled.
@@ -616,10 +603,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -649,9 +636,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -681,15 +667,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -728,15 +713,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Waits for the specified long-running operation until it is done or reaches
-        # at most a specified timeout, returning the latest state.  If the operation
-        # is already done, the latest state is immediately returned.  If the timeout
-        # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
-        # timeout is used.  If the server does not support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
-        # Note that this method is on a best-effort basis.  It may return the latest
-        # state before the specified timeout (including immediately), meaning even an
-        # immediate response is no guarantee that the operation is done.
+        # Waits for the specified long-running operation until it is done or reaches at
+        # most a specified timeout, returning the latest state. If the operation is
+        # already done, the latest state is immediately returned. If the timeout
+        # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout
+        # is used. If the server does not support this method, it returns `google.rpc.
+        # Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may
+        # return the latest state before the specified timeout (including immediately),
+        # meaning even an immediate response is no guarantee that the operation is done.
         # @param [String] name
         #   The name of the operation resource to wait on.
         # @param [Google::Apis::TranslateV3::WaitOperationRequest] wait_operation_request_object

data/generated/google/apis/translate_v3beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/translate/docs/quickstarts
     module TranslateV3beta1
       VERSION = 'V3beta1'
-      REVISION = '20200221'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/translate_v3beta1/classes.rb

@@ -26,41 +26,38 @@ module Google
       class BatchTranslateTextRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. Glossaries to be applied for translation.
-        # It's keyed by target language code.
+        # Optional. Glossaries to be applied for translation. It's keyed by target
+        # language code.
         # Corresponds to the JSON property `glossaries`
         # @return [Hash<String,Google::Apis::TranslateV3beta1::TranslateTextGlossaryConfig>]
         attr_accessor :glossaries
       
-        # Required. Input configurations.
-        # The total number of files matched should be <= 1000.
-        # The total content size should be <= 100M Unicode codepoints.
-        # The files must use UTF-8 encoding.
+        # Required. Input configurations. The total number of files matched should be <=
+        # 1000. The total content size should be <= 100M Unicode codepoints. The files
+        # must use UTF-8 encoding.
         # Corresponds to the JSON property `inputConfigs`
         # @return [Array<Google::Apis::TranslateV3beta1::InputConfig>]
         attr_accessor :input_configs
       
-        # Optional. The labels with user-defined metadata for the request.
-        # Label keys and values can be no longer than 63 characters
-        # (Unicode codepoints), can only contain lowercase letters, numeric
-        # characters, underscores and dashes. International characters are allowed.
-        # Label values are optional. Label keys must start with a letter.
-        # See https://cloud.google.com/translate/docs/labels for more information.
+        # Optional. The labels with user-defined metadata for the request. Label keys
+        # and values can be no longer than 63 characters (Unicode codepoints), can only
+        # contain lowercase letters, numeric characters, underscores and dashes.
+        # International characters are allowed. Label values are optional. Label keys
+        # must start with a letter. See https://cloud.google.com/translate/docs/labels
+        # for more information.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Optional. The models to use for translation. Map's key is target language
-        # code. Map's value is model name. Value can be a built-in general model,
-        # or an AutoML Translation model.
-        # The value format depends on model type:
-        # - AutoML Translation models:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/`model-id``
-        # - General (built-in) models:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/general/nmt`,
-        # `projects/`project-number-or-id`/locations/`location-id`/models/general/base`
-        # If the map is empty or a specific model is
-        # not requested for a language pair, then default google model (nmt) is used.
+        # Optional. The models to use for translation. Map's key is target language code.
+        # Map's value is model name. Value can be a built-in general model, or an
+        # AutoML Translation model. The value format depends on model type: - AutoML
+        # Translation models: `projects/`project-number-or-id`/locations/`location-id`/
+        # models/`model-id`` - General (built-in) models: `projects/`project-number-or-
+        # id`/locations/`location-id`/models/general/nmt`, `projects/`project-number-or-
+        # id`/locations/`location-id`/models/general/base` If the map is empty or a
+        # specific model is not requested for a language pair, then default google model
+        # (nmt) is used.
         # Corresponds to the JSON property `models`
         # @return [Hash<String,String>]
         attr_accessor :models
@@ -118,30 +115,27 @@ module Google
         # @return [String]
         attr_accessor :content
       
-        # Optional. The labels with user-defined metadata for the request.
-        # Label keys and values can be no longer than 63 characters
-        # (Unicode codepoints), can only contain lowercase letters, numeric
-        # characters, underscores and dashes. International characters are allowed.
-        # Label values are optional. Label keys must start with a letter.
-        # See https://cloud.google.com/translate/docs/labels for more information.
+        # Optional. The labels with user-defined metadata for the request. Label keys
+        # and values can be no longer than 63 characters (Unicode codepoints), can only
+        # contain lowercase letters, numeric characters, underscores and dashes.
+        # International characters are allowed. Label values are optional. Label keys
+        # must start with a letter. See https://cloud.google.com/translate/docs/labels
+        # for more information.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Optional. The format of the source text, for example, "text/html",
-        # "text/plain". If left blank, the MIME type defaults to "text/html".
+        # Optional. The format of the source text, for example, "text/html", "text/plain"
+        # . If left blank, the MIME type defaults to "text/html".
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
       
-        # Optional. The language detection model to be used.
-        # Format:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/language-
-        # detection/`model-id``
-        # Only one language detection model is currently supported:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/language-
-        # detection/default`.
-        # If not specified, the default model is used.
+        # Optional. The language detection model to be used. Format: `projects/`project-
+        # number-or-id`/locations/`location-id`/models/language-detection/`model-id``
+        # Only one language detection model is currently supported: `projects/`project-
+        # number-or-id`/locations/`location-id`/models/language-detection/default`. If
+        # not specified, the default model is used.
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
@@ -205,13 +199,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -228,9 +220,9 @@ module Google
       class GcsDestination
         include Google::Apis::Core::Hashable
       
-        # Required. There must be no files under 'output_uri_prefix'.
-        # 'output_uri_prefix' must end with "/" and start with "gs://", otherwise an
-        # INVALID_ARGUMENT (400) error is returned.
+        # Required. There must be no files under 'output_uri_prefix'. 'output_uri_prefix'
+        # must end with "/" and start with "gs://", otherwise an INVALID_ARGUMENT (400)
+        # error is returned.
         # Corresponds to the JSON property `outputUriPrefix`
         # @return [String]
         attr_accessor :output_uri_prefix
@@ -293,8 +285,8 @@ module Google
         # @return [Google::Apis::TranslateV3beta1::LanguageCodePair]
         attr_accessor :language_pair
       
-        # Required. The resource name of the glossary. Glossary names have the form
-        # `projects/`project-number-or-id`/locations/`location-id`/glossaries/`glossary-
+        # Required. The resource name of the glossary. Glossary names have the form `
+        # projects/`project-number-or-id`/locations/`location-id`/glossaries/`glossary-
         # id``.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -349,9 +341,8 @@ module Google
         # @return [Google::Apis::TranslateV3beta1::GcsSource]
         attr_accessor :gcs_source
       
-        # Optional. Can be "text/plain" or "text/html".
-        # For `.tsv`, "text/html" is used if mime_type is missing.
-        # For `.html`, this field must be "text/html" or empty.
+        # Optional. Can be "text/plain" or "text/html". For `.tsv`, "text/html" is used
+        # if mime_type is missing. For `.html`, this field must be "text/html" or empty.
         # For `.txt`, this field must be "text/plain" or empty.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
@@ -372,14 +363,14 @@ module Google
       class LanguageCodePair
         include Google::Apis::Core::Hashable
       
-        # Required. The BCP-47 language code of the input text, for example,
-        # "en-US". Expected to be an exact match for GlossaryTerm.language_code.
+        # Required. The BCP-47 language code of the input text, for example, "en-US".
+        # Expected to be an exact match for GlossaryTerm.language_code.
         # Corresponds to the JSON property `sourceLanguageCode`
         # @return [String]
         attr_accessor :source_language_code
       
-        # Required. The BCP-47 language code for translation output, for example,
-        # "zh-CN". Expected to be an exact match for GlossaryTerm.language_code.
+        # Required. The BCP-47 language code for translation output, for example, "zh-CN"
+        # . Expected to be an exact match for GlossaryTerm.language_code.
         # Corresponds to the JSON property `targetLanguageCode`
         # @return [String]
         attr_accessor :target_language_code
@@ -399,9 +390,9 @@ module Google
       class LanguageCodesSet
         include Google::Apis::Core::Hashable
       
-        # The BCP-47 language code(s) for terms defined in the glossary.
-        # All entries are unique. The list contains at least two entries.
-        # Expected to be an exact match for GlossaryTerm.language_code.
+        # The BCP-47 language code(s) for terms defined in the glossary. All entries are
+        # unique. The list contains at least two entries. Expected to be an exact match
+        # for GlossaryTerm.language_code.
         # Corresponds to the JSON property `languageCodes`
         # @return [Array<String>]
         attr_accessor :language_codes
@@ -425,9 +416,9 @@ module Google
         # @return [Array<Google::Apis::TranslateV3beta1::Glossary>]
         attr_accessor :glossaries
       
-        # A token to retrieve a page of results. Pass this value in the
-        # [ListGlossariesRequest.page_token] field in the subsequent call to
-        # `ListGlossaries` method to retrieve the next page of results.
+        # A token to retrieve a page of results. Pass this value in the [
+        # ListGlossariesRequest.page_token] field in the subsequent call to `
+        # ListGlossaries` method to retrieve the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -497,14 +488,14 @@ module Google
       class Location
         include Google::Apis::Core::Hashable
       
-        # The friendly name for this location, typically a nearby city name.
-        # For example, "Tokyo".
+        # The friendly name for this location, typically a nearby city name. For example,
+        # "Tokyo".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Cross-service attributes for the location. For example
-        # `"cloud.googleapis.com/region": "us-east1"`
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
+        # region": "us-east1"`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -520,8 +511,8 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
-        # Resource name for the location, which may vary between implementations.
-        # For example: `"projects/example-project/locations/us-east1"`
+        # Resource name for the location, which may vary between implementations. For
+        # example: `"projects/example-project/locations/us-east1"`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -545,47 +536,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::TranslateV3beta1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -623,12 +612,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -637,15 +626,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -662,8 +651,8 @@ module Google
         end
       end
       
-      # A single supported language response corresponds to information related
-      # to one supported language.
+      # A single supported language response corresponds to information related to one
+      # supported language.
       class SupportedLanguage
         include Google::Apis::Core::Hashable
       
@@ -673,10 +662,9 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
-        # Supported language code, generally consisting of its ISO 639-1
-        # identifier, for example, 'en', 'ja'. In certain cases, BCP-47 codes
-        # including language and region identifiers are returned (for example,
-        # 'zh-TW' and 'zh-CN')
+        # Supported language code, generally consisting of its ISO 639-1 identifier, for
+        # example, 'en', 'ja'. In certain cases, BCP-47 codes including language and
+        # region identifiers are returned (for example, 'zh-TW' and 'zh-CN')
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -710,8 +698,8 @@ module Google
       class SupportedLanguages
         include Google::Apis::Core::Hashable
       
-        # A list of supported language responses. This list contains an entry
-        # for each language the Translation API supports.
+        # A list of supported language responses. This list contains an entry for each
+        # language the Translation API supports.
         # Corresponds to the JSON property `languages`
         # @return [Array<Google::Apis::TranslateV3beta1::SupportedLanguage>]
         attr_accessor :languages
@@ -726,19 +714,19 @@ module Google
         end
       end
       
-      # 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.
       class TranslateTextGlossaryConfig
         include Google::Apis::Core::Hashable
       
-        # Required. Specifies the glossary used for this translation. Use
-        # this format: projects/*/locations/*/glossaries/*
+        # Required. Specifies the glossary used for this translation. Use this format:
+        # projects/*/locations/*/glossaries/*
         # Corresponds to the JSON property `glossary`
         # @return [String]
         attr_accessor :glossary
       
-        # Optional. Indicates match is case-insensitive.
-        # Default value is false if missing.
+        # Optional. Indicates match is case-insensitive. Default value is false if
+        # missing.
         # Corresponds to the JSON property `ignoreCase`
         # @return [Boolean]
         attr_accessor :ignore_case
@@ -759,61 +747,57 @@ module Google
       class TranslateTextRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The content of the input in string format.
-        # We recommend the total content be less than 30k codepoints.
-        # Use BatchTranslateText for larger text.
+        # Required. The content of the input in string format. We recommend the total
+        # content be less than 30k codepoints. Use BatchTranslateText for larger text.
         # Corresponds to the JSON property `contents`
         # @return [Array<String>]
         attr_accessor :contents
       
-        # 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.
         # Corresponds to the JSON property `glossaryConfig`
         # @return [Google::Apis::TranslateV3beta1::TranslateTextGlossaryConfig]
         attr_accessor :glossary_config
       
-        # Optional. The labels with user-defined metadata for the request.
-        # Label keys and values can be no longer than 63 characters
-        # (Unicode codepoints), can only contain lowercase letters, numeric
-        # characters, underscores and dashes. International characters are allowed.
-        # Label values are optional. Label keys must start with a letter.
-        # See https://cloud.google.com/translate/docs/labels for more information.
+        # Optional. The labels with user-defined metadata for the request. Label keys
+        # and values can be no longer than 63 characters (Unicode codepoints), can only
+        # contain lowercase letters, numeric characters, underscores and dashes.
+        # International characters are allowed. Label values are optional. Label keys
+        # must start with a letter. See https://cloud.google.com/translate/docs/labels
+        # for more information.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Optional. The format of the source text, for example, "text/html",
-        # "text/plain". If left blank, the MIME type defaults to "text/html".
+        # Optional. The format of the source text, for example, "text/html", "text/plain"
+        # . If left blank, the MIME type defaults to "text/html".
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
       
-        # Optional. The `model` type requested for this translation.
-        # The format depends on model type:
-        # - AutoML Translation models:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/`model-id``
-        # - General (built-in) models:
-        # `projects/`project-number-or-id`/locations/`location-id`/models/general/nmt`,
-        # `projects/`project-number-or-id`/locations/`location-id`/models/general/base`
-        # For global (non-regionalized) requests, use `location-id` `global`.
-        # For example,
-        # `projects/`project-number-or-id`/locations/global/models/general/nmt`.
+        # Optional. The `model` type requested for this translation. The format depends
+        # on model type: - AutoML Translation models: `projects/`project-number-or-id`/
+        # locations/`location-id`/models/`model-id`` - General (built-in) models: `
+        # projects/`project-number-or-id`/locations/`location-id`/models/general/nmt`, `
+        # projects/`project-number-or-id`/locations/`location-id`/models/general/base`
+        # For global (non-regionalized) requests, use `location-id` `global`. For
+        # example, `projects/`project-number-or-id`/locations/global/models/general/nmt`.
         # If missing, the system decides which google base model to use.
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
       
-        # Optional. The BCP-47 language code of the input text if
-        # known, for example, "en-US" or "sr-Latn". Supported language codes are
-        # listed in Language Support. If the source language isn't specified, the API
-        # attempts to identify the source language automatically and returns the
-        # source language within the response.
+        # Optional. The BCP-47 language code of the input text if known, for example, "
+        # en-US" or "sr-Latn". Supported language codes are listed in Language Support.
+        # If the source language isn't specified, the API attempts to identify the
+        # source language automatically and returns the source language within the
+        # response.
         # Corresponds to the JSON property `sourceLanguageCode`
         # @return [String]
         attr_accessor :source_language_code
       
-        # Required. The BCP-47 language code to use for translation of the input
-        # text, set to one of the language codes listed in Language Support.
+        # Required. The BCP-47 language code to use for translation of the input text,
+        # set to one of the language codes listed in Language Support.
         # Corresponds to the JSON property `targetLanguageCode`
         # @return [String]
         attr_accessor :target_language_code
@@ -838,18 +822,15 @@ module Google
       class TranslateTextResponse
         include Google::Apis::Core::Hashable
       
-        # Text translation responses if a glossary is provided in the request.
-        # This can be the same as
-        # `translations` if no terms apply.
-        # This field has the same length as
-        # `contents`.
+        # Text translation responses if a glossary is provided in the request. This can
+        # be the same as `translations` if no terms apply. This field has the same
+        # length as `contents`.
         # Corresponds to the JSON property `glossaryTranslations`
         # @return [Array<Google::Apis::TranslateV3beta1::Translation>]
         attr_accessor :glossary_translations
       
-        # Text translation responses with no glossary applied.
-        # This field has the same length as
-        # `contents`.
+        # Text translation responses with no glossary applied. This field has the same
+        # length as `contents`.
         # Corresponds to the JSON property `translations`
         # @return [Array<Google::Apis::TranslateV3beta1::Translation>]
         attr_accessor :translations
@@ -870,26 +851,24 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The BCP-47 language code of source text in the initial request, detected
-        # automatically, if no source language was passed within the initial
-        # request. If the source language was passed, auto-detection of the language
-        # does not occur and this field is empty.
+        # automatically, if no source language was passed within the initial request. If
+        # the source language was passed, auto-detection of the language does not occur
+        # and this field is empty.
         # Corresponds to the JSON property `detectedLanguageCode`
         # @return [String]
         attr_accessor :detected_language_code
       
-        # 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.
         # Corresponds to the JSON property `glossaryConfig`
         # @return [Google::Apis::TranslateV3beta1::TranslateTextGlossaryConfig]
         attr_accessor :glossary_config
       
-        # Only present when `model` is present in the request.
-        # `model` here is normalized to have project number.
-        # For example:
-        # If the `model` requested in TranslationTextRequest is
-        # `projects/`project-id`/locations/`location-id`/models/general/nmt` then
-        # `model` here would be normalized to
-        # `projects/`project-number`/locations/`location-id`/models/general/nmt`.
+        # Only present when `model` is present in the request. `model` here is
+        # normalized to have project number. For example: If the `model` requested in
+        # TranslationTextRequest is `projects/`project-id`/locations/`location-id`/
+        # models/general/nmt` then `model` here would be normalized to `projects/`
+        # project-number`/locations/`location-id`/models/general/nmt`.
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
@@ -916,9 +895,9 @@ module Google
       class WaitOperationRequest
         include Google::Apis::Core::Hashable
       
-        # The maximum duration to wait before timing out. If left blank, the wait
-        # will be at most the time permitted by the underlying HTTP/RPC protocol.
-        # If RPC context deadline is also specified, the shorter one will be used.
+        # The maximum duration to wait before timing out. If left blank, the wait will
+        # be at most the time permitted by the underlying HTTP/RPC protocol. If RPC
+        # context deadline is also specified, the shorter one will be used.
         # Corresponds to the JSON property `timeout`
         # @return [String]
         attr_accessor :timeout