docs: update generated docs (#981)
diff --git a/docs/dyn/translate_v3.projects.locations.html b/docs/dyn/translate_v3.projects.locations.html
index 13f3221..a4f9c24 100644
--- a/docs/dyn/translate_v3.projects.locations.html
+++ b/docs/dyn/translate_v3.projects.locations.html
@@ -94,10 +94,10 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets information about a location.</p>
<p class="toc_element">
- <code><a href="#getSupportedLanguages">getSupportedLanguages(parent, model=None, displayLanguageCode=None, x__xgafv=None)</a></code></p>
+ <code><a href="#getSupportedLanguages">getSupportedLanguages(parent, displayLanguageCode=None, model=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns a list of supported languages for translation.</p>
<p class="toc_element">
- <code><a href="#list">list(name, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(name, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists information about the supported locations for this service.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -131,6 +131,49 @@
{ # The batch translation request.
"sourceLanguageCode": "A String", # Required. Source language code.
+ "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/advanced/labels for more
+ # information.
+ "a_key": "A String",
+ },
+ "models": { # 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.
+ "a_key": "A String",
+ },
+ "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. The `glossary` to be applied for this translation.
+ #
+ # The format depends on glossary:
+ #
+ # - User provided custom glossary:
+ # `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`
+ "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
+ # Default value is false if missing.
+ },
+ },
"outputConfig": { # Output configuration for BatchTranslateText request. # Required. Output configuration.
# If 2 input configs match to the same file (that is, same input path),
# we don't generate output for duplicate inputs.
@@ -207,6 +250,9 @@
# returned.
},
},
+ "targetLanguageCodes": [ # Required. Specify up to 10 language codes here.
+ "A String",
+ ],
"inputConfigs": [ # Required. Input configurations.
# The total number of files matched should be <= 1000.
# The total content size should be <= 100M Unicode codepoints.
@@ -238,52 +284,6 @@
# 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. The `glossary` to be applied for this translation.
- #
- # The format depends on glossary:
- #
- # - User provided custom glossary:
- # `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`
- "ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
- # Default value is false if missing.
- },
- },
- "models": { # 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.
- "a_key": "A String",
- },
- "targetLanguageCodes": [ # Required. Specify up to 10 language codes here.
- "A String",
- ],
- "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/advanced/labels for more
- # information.
- "a_key": "A String",
- },
}
x__xgafv: string, V1 error format.
@@ -296,16 +296,6 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "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
- # `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`.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
"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}`.
@@ -336,6 +326,16 @@
"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
+ # `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`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
}</pre>
</div>
@@ -359,18 +359,6 @@
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".
"labels": { # Optional. The labels with user-defined metadata for the request.
#
# Label keys and values can be no longer than 63 characters
@@ -382,6 +370,18 @@
# information.
"a_key": "A String",
},
+ "content": "A String", # The content of the input stored as 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".
+ "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.
@@ -419,25 +419,25 @@
An object of the form:
{ # A resource that represents Google Cloud Platform location.
- "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.
- },
"labels": { # Cross-service attributes for the location. For example
#
# {"cloud.googleapis.com/region": "us-east1"}
"a_key": "A String",
},
+ "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
+ "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.
+ },
+ "name": "A String", # Resource name for the location, which may vary between implementations.
+ # For example: `"projects/example-project/locations/us-east1"`
}</pre>
</div>
<div class="method">
- <code class="details" id="getSupportedLanguages">getSupportedLanguages(parent, model=None, displayLanguageCode=None, x__xgafv=None)</code>
+ <code class="details" id="getSupportedLanguages">getSupportedLanguages(parent, displayLanguageCode=None, model=None, x__xgafv=None)</code>
<pre>Returns a list of supported languages for translation.
Args:
@@ -454,6 +454,9 @@
Only models within the same region (have same location-id) can be used,
otherwise an INVALID_ARGUMENT (400) error is returned. (required)
+ displayLanguageCode: string, 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.
model: string, Optional. Get supported languages of this model.
The format depends on model type:
@@ -468,9 +471,6 @@
Returns languages supported by the specified model.
If missing, we get supported languages of Google general base (PBMT) model.
- displayLanguageCode: string, 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.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -484,28 +484,28 @@
# 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.
+ "displayName": "A String", # Human readable name of the language localized in the display language
+ # specified in the request.
"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')
+ "supportSource": True or False, # Can be used as source language.
"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.
},
],
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(name, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(name, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists information about the supported locations for this service.
Args:
name: string, The resource that owns the locations collection, if applicable. (required)
- pageToken: string, The standard list page token.
pageSize: integer, The standard list page size.
filter: string, The standard list filter.
+ pageToken: string, The standard list page token.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -518,20 +518,20 @@
"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.
- "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.
- },
"labels": { # Cross-service attributes for the location. For example
#
# {"cloud.googleapis.com/region": "us-east1"}
"a_key": "A String",
},
+ "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
+ "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.
+ },
+ "name": "A String", # Resource name for the location, which may vary between implementations.
+ # For example: `"projects/example-project/locations/us-east1"`
},
],
}</pre>
@@ -574,13 +574,24 @@
The object takes the form of:
{ # The request message for synchronous translation.
- "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.
+ "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/advanced/labels for more
+ # information.
+ "a_key": "A String",
+ },
"sourceLanguageCode": "A String", # 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.
+ "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".
"model": "A String", # Optional. The `model` type requested for this translation.
#
# The format depends on model type:
@@ -603,8 +614,8 @@
# 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".
+ "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.
"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.
@@ -618,17 +629,6 @@
"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/advanced/labels for more
- # information.
- "a_key": "A String",
- },
}
x__xgafv: string, V1 error format.
@@ -646,19 +646,6 @@
# 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. The `glossary` to be applied for this translation.
@@ -670,25 +657,25 @@
"ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
# Default value is false if missing.
},
+ "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`.
+ "translatedText": "A String", # Text translated into the target language.
},
],
"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. The `glossary` to be applied for this translation.
@@ -700,6 +687,19 @@
"ignoreCase": True or False, # Optional. Indicates match is case-insensitive.
# Default value is false if missing.
},
+ "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`.
+ "translatedText": "A String", # Text translated into the target language.
},
],
}</pre>