docs: update comments for ListVoicesRequest (#244)

* docs: update comments for ListVoicesRequest PiperOrigin-RevId: 424942023 Source-Link: googleapis/googleapis@8ce1934 Source-Link: googleapis/googleapis-gen@40dbea3 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDBkYmVhMzQyNTRhYWVkYmUyZjhjNDgzYTU0ZTMyZDA3NWQ1ZmVkOSJ9 * 🦉 Updates from OwlBot See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jan 28, 2022 · bc5b73f · bc5b73f
1 parent 3b4f0d0
commit bc5b73f
Show file tree

Hide file tree

Showing 3 changed files with 19 additions and 24 deletions.
diff --git a/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py b/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py
@@ -213,15 +213,13 @@ async def list_voices(
             language_code (:class:`str`):
                 Optional. Recommended.
                 `BCP-47 <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__
-                language tag. If specified, the ListVoices call will
+                language tag. If not specified, the API will return all
+                supported voices. If specified, the ListVoices call will
                 only return voices that can be used to synthesize this
-                language_code. E.g. when specifying ``"en-NZ"``, you
-                will get supported ``"en-\*"`` voices; when specifying
-                ``"no"``, you will get supported ``"no-\*"`` (Norwegian)
-                and ``"nb-\*"`` (Norwegian Bokmal) voices; specifying
-                ``"zh"`` will also get supported ``"cmn-\*"`` voices;
-                specifying ``"zh-hk"`` will also get supported
-                ``"yue-\*"`` voices.
+                language_code. For example, if you specify ``"en-NZ"``,
+                all ``"en-NZ"`` voices will be returned. If you specify
+                ``"no"``, both ``"no-\*"`` (Norwegian) and ``"nb-\*"``
+                (Norwegian Bokmal) voices will be returned.
 
                 This corresponds to the ``language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/texttospeech_v1/services/text_to_speech/client.py b/google/cloud/texttospeech_v1/services/text_to_speech/client.py
@@ -398,15 +398,13 @@ def list_voices(
             language_code (str):
                 Optional. Recommended.
                 `BCP-47 <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__
-                language tag. If specified, the ListVoices call will
+                language tag. If not specified, the API will return all
+                supported voices. If specified, the ListVoices call will
                 only return voices that can be used to synthesize this
-                language_code. E.g. when specifying ``"en-NZ"``, you
-                will get supported ``"en-\*"`` voices; when specifying
-                ``"no"``, you will get supported ``"no-\*"`` (Norwegian)
-                and ``"nb-\*"`` (Norwegian Bokmal) voices; specifying
-                ``"zh"`` will also get supported ``"cmn-\*"`` voices;
-                specifying ``"zh-hk"`` will also get supported
-                ``"yue-\*"`` voices.
+                language_code. For example, if you specify ``"en-NZ"``,
+                all ``"en-NZ"`` voices will be returned. If you specify
+                ``"no"``, both ``"no-\*"`` (Norwegian) and ``"nb-\*"``
+                (Norwegian Bokmal) voices will be returned.
 
                 This corresponds to the ``language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/texttospeech_v1/types/cloud_tts.py b/google/cloud/texttospeech_v1/types/cloud_tts.py
@@ -63,14 +63,13 @@ class ListVoicesRequest(proto.Message):
         language_code (str):
             Optional. Recommended.
             `BCP-47 <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__
-            language tag. If specified, the ListVoices call will only
-            return voices that can be used to synthesize this
-            language_code. E.g. when specifying ``"en-NZ"``, you will
-            get supported ``"en-\*"`` voices; when specifying ``"no"``,
-            you will get supported ``"no-\*"`` (Norwegian) and
-            ``"nb-\*"`` (Norwegian Bokmal) voices; specifying ``"zh"``
-            will also get supported ``"cmn-\*"`` voices; specifying
-            ``"zh-hk"`` will also get supported ``"yue-\*"`` voices.
+            language tag. If not specified, the API will return all
+            supported voices. If specified, the ListVoices call will
+            only return voices that can be used to synthesize this
+            language_code. For example, if you specify ``"en-NZ"``, all
+            ``"en-NZ"`` voices will be returned. If you specify
+            ``"no"``, both ``"no-\*"`` (Norwegian) and ``"nb-\*"``
+            (Norwegian Bokmal) voices will be returned.
     """
 
     language_code = proto.Field(proto.STRING, number=1,)