docs: update generated docs (#981)
diff --git a/docs/dyn/translate_v3beta1.projects.locations.html b/docs/dyn/translate_v3beta1.projects.locations.html
index 01242d5..e08f097 100644
--- a/docs/dyn/translate_v3beta1.projects.locations.html
+++ b/docs/dyn/translate_v3beta1.projects.locations.html
@@ -210,6 +210,10 @@
# The total content size should be <= 100M Unicode codepoints.
# The files must use UTF-8 encoding.
{ # Input configuration for BatchTranslateText request.
+ "mimeType": "A String", # 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.
"gcsSource": { # The Google Cloud Storage location for the input content. # Required. Google Cloud Storage location for the source input.
# This can be a single file (for example,
# `gs://translation-test/input.tsv`) or a wildcard (for example,
@@ -230,20 +234,16 @@
# treated as a single large chunk of text.
"inputUri": "A String", # Required. Source data URI. For example, `gs://my_bucket/my_object`.
},
- "mimeType": "A String", # 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.
},
],
"glossaries": { # Optional. Glossaries to be applied for translation.
# It's keyed by target language code.
"a_key": { # Configures which glossary should be used for a specific target language,
# and defines options for applying that glossary.
- "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
- # this format: projects/*/locations/*/glossaries/*
"ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
# Default value is false if missing.
+ "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
+ # this format: projects/*/locations/*/glossaries/*
},
},
"models": { # Optional. The models to use for translation. Map's key is target language
@@ -289,9 +289,6 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "done": True or False, # 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.
"response": { # 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
@@ -305,6 +302,15 @@
"name": "A String", # 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}`.
+ "done": True or False, # 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.
+ "metadata": { # 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.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
@@ -312,22 +318,16 @@
#
# 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).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # 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.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
- },
- "metadata": { # 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.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "message": "A String", # 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.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
}</pre>
</div>
@@ -352,18 +352,9 @@
The object takes the form of:
{ # The request message for language detection.
- "content": "A String", # The content of the input stored as a string.
- "model": "A String", # 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.
"mimeType": "A String", # Optional. The format of the source text, for example, "text/html",
# "text/plain". If left blank, the MIME type defaults to "text/html".
+ "content": "A String", # The content of the input stored as a string.
"labels": { # Optional. The labels with user-defined metadata for the request.
#
# Label keys and values can be no longer than 63 characters
@@ -374,6 +365,15 @@
# See https://cloud.google.com/translate/docs/labels for more information.
"a_key": "A String",
},
+ "model": "A String", # 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.
}
x__xgafv: string, V1 error format.
@@ -411,20 +411,20 @@
An object of the form:
{ # A resource that represents Google Cloud Platform location.
+ "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
+ "name": "A String", # Resource name for the location, which may vary between implementations.
+ # For example: `"projects/example-project/locations/us-east1"`
"labels": { # Cross-service attributes for the location. For example
#
# {"cloud.googleapis.com/region": "us-east1"}
"a_key": "A String",
},
- "name": "A String", # Resource name for the location, which may vary between implementations.
- # For example: `"projects/example-project/locations/us-east1"`
- "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
- "displayName": "A String", # The friendly name for this location, typically a nearby city name.
- # For example, "Tokyo".
"metadata": { # Service-specific metadata. For example the available capacity at the given
# location.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "displayName": "A String", # The friendly name for this location, typically a nearby city name.
+ # For example, "Tokyo".
}</pre>
</div>
@@ -476,14 +476,14 @@
# for each language the Translation API supports.
{ # A single supported language response corresponds to information related
# to one supported language.
- "supportSource": True or False, # Can be used as source language.
"languageCode": "A String", # 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')
- "supportTarget": True or False, # Can be used as target language.
"displayName": "A String", # Human readable name of the language localized in the display language
# specified in the request.
+ "supportSource": True or False, # Can be used as source language.
+ "supportTarget": True or False, # Can be used as target language.
},
],
}</pre>
@@ -507,25 +507,25 @@
An object of the form:
{ # The response message for Locations.ListLocations.
+ "nextPageToken": "A String", # The standard List next-page token.
"locations": [ # A list of locations that matches the specified filter in the request.
{ # A resource that represents Google Cloud Platform location.
+ "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
+ "name": "A String", # Resource name for the location, which may vary between implementations.
+ # For example: `"projects/example-project/locations/us-east1"`
"labels": { # Cross-service attributes for the location. For example
#
# {"cloud.googleapis.com/region": "us-east1"}
"a_key": "A String",
},
- "name": "A String", # Resource name for the location, which may vary between implementations.
- # For example: `"projects/example-project/locations/us-east1"`
- "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
- "displayName": "A String", # The friendly name for this location, typically a nearby city name.
- # For example, "Tokyo".
"metadata": { # Service-specific metadata. For example the available capacity at the given
# location.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "displayName": "A String", # The friendly name for this location, typically a nearby city name.
+ # For example, "Tokyo".
},
],
- "nextPageToken": "A String", # The standard List next-page token.
}</pre>
</div>
@@ -566,6 +566,16 @@
The object takes the form of:
{ # The request message for synchronous translation.
+ "labels": { # 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.
+ "a_key": "A String",
+ },
"targetLanguageCode": "A String", # 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.
"sourceLanguageCode": "A String", # Optional. The BCP-47 language code of the input text if
@@ -573,6 +583,22 @@
# 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.
+ "mimeType": "A String", # Optional. The format of the source text, for example, "text/html",
+ # "text/plain". If left blank, the MIME type defaults to "text/html".
+ "glossaryConfig": { # Configures which glossary should be used for a specific target language, # Optional. Glossary to be applied. The glossary must be
+ # within the same region (have the same location-id) as the model, otherwise
+ # an INVALID_ARGUMENT (400) error is returned.
+ # and defines options for applying that glossary.
+ "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
+ # Default value is false if missing.
+ "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
+ # this format: projects/*/locations/*/glossaries/*
+ },
+ "contents": [ # Required. The content of the input in string format.
+ # We recommend the total content be less than 30k codepoints.
+ # Use BatchTranslateText for larger text.
+ "A String",
+ ],
"model": "A String", # Optional. The `model` type requested for this translation.
#
# The format depends on model type:
@@ -590,32 +616,6 @@
# `projects/{project-number-or-id}/locations/global/models/general/nmt`.
#
# If missing, the system decides which google base model to use.
- "contents": [ # Required. The content of the input in string format.
- # We recommend the total content be less than 30k codepoints.
- # Use BatchTranslateText for larger text.
- "A String",
- ],
- "mimeType": "A String", # Optional. The format of the source text, for example, "text/html",
- # "text/plain". If left blank, the MIME type defaults to "text/html".
- "glossaryConfig": { # Configures which glossary should be used for a specific target language, # Optional. Glossary to be applied. The glossary must be
- # within the same region (have the same location-id) as the model, otherwise
- # an INVALID_ARGUMENT (400) error is returned.
- # and defines options for applying that glossary.
- "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
- # this format: projects/*/locations/*/glossaries/*
- "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
- # Default value is false if missing.
- },
- "labels": { # 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.
- "a_key": "A String",
- },
}
x__xgafv: string, V1 error format.
@@ -627,12 +627,42 @@
An object of the form:
{
+ "translations": [ # Text translation responses with no glossary applied.
+ # This field has the same length as
+ # `contents`.
+ { # A single translation response.
+ "detectedLanguageCode": "A String", # 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.
+ "model": "A String", # 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`.
+ "glossaryConfig": { # Configures which glossary should be used for a specific target language, # The `glossary_config` used for this translation.
+ # and defines options for applying that glossary.
+ "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
+ # Default value is false if missing.
+ "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
+ # this format: projects/*/locations/*/glossaries/*
+ },
+ "translatedText": "A String", # Text translated into the target language.
+ },
+ ],
"glossaryTranslations": [ # 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`.
{ # A single translation response.
+ "detectedLanguageCode": "A String", # 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.
"model": "A String", # Only present when `model` is present in the request.
# `model` here is normalized to have project number.
#
@@ -641,44 +671,14 @@
# `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`.
- "translatedText": "A String", # Text translated into the target language.
- "detectedLanguageCode": "A String", # 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.
"glossaryConfig": { # Configures which glossary should be used for a specific target language, # The `glossary_config` used for this translation.
# and defines options for applying that glossary.
- "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
- # this format: projects/*/locations/*/glossaries/*
"ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
# Default value is false if missing.
+ "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
+ # this format: projects/*/locations/*/glossaries/*
},
- },
- ],
- "translations": [ # Text translation responses with no glossary applied.
- # This field has the same length as
- # `contents`.
- { # A single translation response.
- "model": "A String", # 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`.
"translatedText": "A String", # Text translated into the target language.
- "detectedLanguageCode": "A String", # 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.
- "glossaryConfig": { # Configures which glossary should be used for a specific target language, # The `glossary_config` used for this translation.
- # and defines options for applying that glossary.
- "glossary": "A String", # Required. Specifies the glossary used for this translation. Use
- # this format: projects/*/locations/*/glossaries/*
- "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
- # Default value is false if missing.
- },
},
],
}</pre>