From f21616326215d914f9507103c2eb2bbd7dd4c68f Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Fri, 28 Jan 2022 18:01:48 -0500 Subject: [PATCH] docs: update comments for ListVoicesRequest (#244) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: update comments for ListVoicesRequest PiperOrigin-RevId: 424942023 Source-Link: https://github.com/googleapis/googleapis/commit/8ce193463ae79d1580533d636a6a016d4963867c Source-Link: https://github.com/googleapis/googleapis-gen/commit/40dbea34254aaedbe2f8c483a54e32d075d5fed9 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 --- .../services/text_to_speech/async_client.py | 14 ++++++-------- .../services/text_to_speech/client.py | 14 ++++++-------- .../cloud/texttospeech_v1/types/cloud_tts.py | 15 +++++++-------- 3 files changed, 19 insertions(+), 24 deletions(-) diff --git a/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py b/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py index e8bd0a8b86ed..4eefaf332e69 100644 --- a/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py +++ b/packages/google-cloud-texttospeech/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 `__ - 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/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/client.py b/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/client.py index 115c173a840d..742cf1af4985 100644 --- a/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/client.py +++ b/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/client.py @@ -398,15 +398,13 @@ def list_voices( language_code (str): Optional. Recommended. `BCP-47 `__ - 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/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py b/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py index 4360ff6166ce..fb0dd3b60d91 100644 --- a/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py +++ b/packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py @@ -63,14 +63,13 @@ class ListVoicesRequest(proto.Message): language_code (str): Optional. Recommended. `BCP-47 `__ - 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,)