docs: [google-cloud-translate] minor formatting (#14023)

BEGIN_COMMIT_OVERRIDE
docs: Update hyperlink to the supported languages documentation page
docs: minor formatting
feat: add google.iam.v1.IAMPolicy API
feat: add google.cloud.location.Locations API
feat: add google.longrunning.Operations API
END_COMMIT_OVERRIDE

- [ ] Regenerate this pull request now.

feat: add google.iam.v1.IAMPolicy API
feat: add google.cloud.location.Locations API
feat: add google.longrunning.Operations API

PiperOrigin-RevId: 774751840

Source-Link:
googleapis/googleapis@728080d

Source-Link:
googleapis/googleapis-gen@6f9521c
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRyYW5zbGF0ZS8uT3dsQm90LnlhbWwiLCJoIjoiNmY5NTIxYzZkYjlmYTdmNGM1NzU1OWY5ZjlmMjk4MjdlOWVmNWI5MSJ9

BEGIN_NESTED_COMMIT
docs: [google-cloud-translate] Update hyperlink to the supported
languages documentation page
PiperOrigin-RevId: 773858816

Source-Link:
googleapis/googleapis@d5b7894

Source-Link:
googleapis/googleapis-gen@ceca9ea
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRyYW5zbGF0ZS8uT3dsQm90LnlhbWwiLCJoIjoiY2VjYTllYTdlYzMxMDFlMGM2NDE4ODI3YjMyYjZlMzQ3ZjNmZjEzMiJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
docs: [google-cloud-translate] Update hyperlink to the supported
languages documentation page
PiperOrigin-RevId: 773858401

Source-Link:
googleapis/googleapis@8b26dd3

Source-Link:
googleapis/googleapis-gen@145fb3f
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRyYW5zbGF0ZS8uT3dsQm90LnlhbWwiLCJoIjoiMTQ1ZmIzZjQxYTVkNzQzZTgxYzU4OTJmMDZkMmYxOTJkOTgzNGQ3NSJ9
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-translate/google/cloud/translate/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.20.3"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-translate/google/cloud/translate_v3/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.20.3"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/async_client.py

@@ -402,10 +402,10 @@ async def sample_translate_text():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             target_language_code (:class:`str`):
-                Required. The ISO-639 language code
-                to use for translation of the input
-                text, set to one of the language codes
-                listed in Language Support.
+                Required. The ISO-639 language code to use for
+                translation of the input text, set to one of the
+                language codes listed in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
 
                 This corresponds to the ``target_language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -455,14 +455,13 @@ async def sample_translate_text():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             source_language_code (:class:`str`):
-                Optional. The ISO-639 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 ISO-639 language code of the input text if
+                known, for example, "en-US" or "sr-Latn". Supported
+                language codes are listed in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
+                If the source language isn't specified, the API attempts
+                to identify the source language automatically and
+                returns the source language within the response.
 
                 This corresponds to the ``source_language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1314,10 +1313,11 @@ async def sample_batch_translate_document():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             target_language_codes (:class:`MutableSequence[str]`):
-                Required. The ISO-639 language code
-                to use for translation of the input
-                document. Specify up to 10 language
-                codes here.
+                Required. The ISO-639 language code to use for
+                translation of the input document. Specify up to 10
+                language codes here. Supported language codes are listed
+                in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
 
                 This corresponds to the ``target_language_codes`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/client.py

@@ -964,10 +964,10 @@ def sample_translate_text():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             target_language_code (str):
-                Required. The ISO-639 language code
-                to use for translation of the input
-                text, set to one of the language codes
-                listed in Language Support.
+                Required. The ISO-639 language code to use for
+                translation of the input text, set to one of the
+                language codes listed in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
 
                 This corresponds to the ``target_language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1017,14 +1017,13 @@ def sample_translate_text():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             source_language_code (str):
-                Optional. The ISO-639 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 ISO-639 language code of the input text if
+                known, for example, "en-US" or "sr-Latn". Supported
+                language codes are listed in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
+                If the source language isn't specified, the API attempts
+                to identify the source language automatically and
+                returns the source language within the response.
 
                 This corresponds to the ``source_language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1860,10 +1859,11 @@ def sample_batch_translate_document():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             target_language_codes (MutableSequence[str]):
-                Required. The ISO-639 language code
-                to use for translation of the input
-                document. Specify up to 10 language
-                codes here.
+                Required. The ISO-639 language code to use for
+                translation of the input document. Specify up to 10
+                language codes here. Supported language codes are listed
+                in `Language
+                Support <https://cloud.google.com/translate/docs/languages>`__.
 
                 This corresponds to the ``target_language_codes`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-translate/google/cloud/translate_v3/types/translation_service.py

@@ -109,17 +109,18 @@ class TranslateTextRequest(proto.Message):
             example, "text/html",  "text/plain". If left
             blank, the MIME type defaults to "text/html".
         source_language_code (str):
-            Optional. The ISO-639 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 ISO-639 language code of the input text if
+            known, for example, "en-US" or "sr-Latn". Supported language
+            codes are listed in `Language
+            Support <https://cloud.google.com/translate/docs/languages>`__.
+            If the source language isn't specified, the API attempts to
+            identify the source language automatically and returns the
+            source language within the response.
         target_language_code (str):
-            Required. The ISO-639 language code to use
-            for translation of the input text, set to one of
-            the language codes listed in Language Support.
+            Required. The ISO-639 language code to use for translation
+            of the input text, set to one of the language codes listed
+            in `Language
+            Support <https://cloud.google.com/translate/docs/languages>`__.
         parent (str):
             Required. Project or location to make a call. Must refer to
             a caller's project.
@@ -313,12 +314,13 @@ class RomanizeTextRequest(proto.Message):
             Required. The content of the input in string
             format.
         source_language_code (str):
-            Optional. The ISO-639 language code of the
-            input text if known, for example, "hi" or "zh".
-            If the source language isn't specified, the API
-            attempts to identify the source language
-            automatically and returns the source language
-            for each content in the response.
+            Optional. The ISO-639 language code of the input text if
+            known, for example, "hi" or "zh". Supported language codes
+            are listed in `Language
+            Support <https://cloud.google.com/translate/docs/languages#roman>`__.
+            If the source language isn't specified, the API attempts to
+            identify the source language automatically and returns the
+            source language for each content in the response.
     """
 
     parent: str = proto.Field(
@@ -939,20 +941,20 @@ class TranslateDocumentRequest(proto.Message):
             the same location-id), otherwise an INVALID_ARGUMENT (400)
             error is returned.
         source_language_code (str):
-            Optional. The ISO-639 language code of the
-            input document 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. Source
-            language must be specified if the request
-            contains a glossary or a custom model.
+            Optional. The ISO-639 language code of the input document if
+            known, for example, "en-US" or "sr-Latn". Supported language
+            codes are listed in [Language Support]
+            (https://cloud.google.com/translate/docs/languages). If the
+            source language isn't specified, the API attempts to
+            identify the source language automatically and returns the
+            source language within the response. Source language must be
+            specified if the request contains a glossary or a custom
+            model.
         target_language_code (str):
-            Required. The ISO-639 language code to use
-            for translation of the input document, set to
-            one of the language codes listed in Language
-            Support.
+            Required. The ISO-639 language code to use for translation
+            of the input document, set to one of the language codes
+            listed in [Language Support]
+            (https://cloud.google.com/translate/docs/languages).
         document_input_config (google.cloud.translate_v3.types.DocumentInputConfig):
             Required. Input configurations.
         document_output_config (google.cloud.translate_v3.types.DocumentOutputConfig):
@@ -1168,10 +1170,13 @@ class BatchTranslateTextRequest(proto.Message):
             region (have the same location-id) can be used, otherwise an
             INVALID_ARGUMENT (400) error is returned.
         source_language_code (str):
-            Required. Source language code.
+            Required. Source language code. Supported language codes are
+            listed in `Language
+            Support <https://cloud.google.com/translate/docs/languages>`__.
         target_language_codes (MutableSequence[str]):
-            Required. Specify up to 10 language codes
-            here.
+            Required. Specify up to 10 language codes here. Supported
+            language codes are listed in `Language
+            Support <https://cloud.google.com/translate/docs/languages>`__.
         models (MutableMapping[str, str]):
             Optional. The models to use for translation. Map's key is
             target language code. Map's value is model name. Value can
@@ -2077,9 +2082,10 @@ class BatchTranslateDocumentRequest(proto.Message):
             codes are listed in `Language
             Support <https://cloud.google.com/translate/docs/languages>`__.
         target_language_codes (MutableSequence[str]):
-            Required. The ISO-639 language code to use
-            for translation of the input document. Specify
-            up to 10 language codes here.
+            Required. The ISO-639 language code to use for translation
+            of the input document. Specify up to 10 language codes here.
+            Supported language codes are listed in `Language
+            Support <https://cloud.google.com/translate/docs/languages>`__.
         input_configs (MutableSequence[google.cloud.translate_v3.types.BatchDocumentInputConfig]):
             Required. Input configurations.
             The total number of files matched should be <=

packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.20.3"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}