feat: [google-cloud-texttospeech] Add low latency journey option to proto (#13140)

- [ ] Regenerate this pull request now. BEGIN_COMMIT_OVERRIDE feat: Add CustomPronunciationParams for upcoming feature work feat: Add low latency journey option to proto END_COMMIT_OVERRIDE PiperOrigin-RevId: 684229364 Source-Link: googleapis/googleapis@10b8dc3 Source-Link: googleapis/googleapis-gen@deaa9f3 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRleHR0b3NwZWVjaC8uT3dsQm90LnlhbWwiLCJoIjoiZGVhYTlmMzE5ZjFjNmMxOWE5ZDM2ZWEyMzNhZTMwNzU2NmI2MGMwOSJ9 BEGIN_NESTED_COMMIT feat: [google-cloud-texttospeech] Add low latency journey option to proto feat: Add CustomPronunciationParams for upcoming feature work PiperOrigin-RevId: 684207737 Source-Link: googleapis/googleapis@d6f9dbc Source-Link: googleapis/googleapis-gen@42ac4d7 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRleHR0b3NwZWVjaC8uT3dsQm90LnlhbWwiLCJoIjoiNDJhYzRkNzViZWMxYjlkZWViYjA2OGZmODQyYzk1YTgxZGE5YjRkMCJ9 END_NESTED_COMMIT --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-texttospeech/google/cloud/texttospeech/__init__.py

@@ -31,8 +31,11 @@
  TextToSpeechLongAudioSynthesizeClient,
 )
 from google.cloud.texttospeech_v1.types.cloud_tts import (
+ AdvancedVoiceOptions,
  AudioConfig,
  AudioEncoding,
+ CustomPronunciationParams,
+ CustomPronunciations,
  CustomVoiceParams,
  ListVoicesRequest,
  ListVoicesResponse,
@@ -58,7 +61,10 @@
  "TextToSpeechAsyncClient",
  "TextToSpeechLongAudioSynthesizeClient",
  "TextToSpeechLongAudioSynthesizeAsyncClient",
+ "AdvancedVoiceOptions",
  "AudioConfig",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "CustomVoiceParams",
  "ListVoicesRequest",
  "ListVoicesResponse",

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

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

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/__init__.py

@@ -24,8 +24,11 @@
  TextToSpeechLongAudioSynthesizeClient,
 )
 from .types.cloud_tts import (
+ AdvancedVoiceOptions,
  AudioConfig,
  AudioEncoding,
+ CustomPronunciationParams,
+ CustomPronunciations,
  CustomVoiceParams,
  ListVoicesRequest,
  ListVoicesResponse,
@@ -49,8 +52,11 @@
 __all__ = (
  "TextToSpeechAsyncClient",
  "TextToSpeechLongAudioSynthesizeAsyncClient",
+ "AdvancedVoiceOptions",
  "AudioConfig",
  "AudioEncoding",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "CustomVoiceParams",
  "ListVoicesRequest",
  "ListVoicesResponse",

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/gapic_version.py

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

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/__init__.py

@@ -14,8 +14,11 @@
 # limitations under the License.
 #
 from .cloud_tts import (
+ AdvancedVoiceOptions,
  AudioConfig,
  AudioEncoding,
+ CustomPronunciationParams,
+ CustomPronunciations,
  CustomVoiceParams,
  ListVoicesRequest,
  ListVoicesResponse,
@@ -37,7 +40,10 @@
 )
 
 __all__ = (
+ "AdvancedVoiceOptions",
  "AudioConfig",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "CustomVoiceParams",
  "ListVoicesRequest",
  "ListVoicesResponse",

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py

@@ -27,7 +27,10 @@
  "ListVoicesRequest",
  "ListVoicesResponse",
  "Voice",
+ "AdvancedVoiceOptions",
  "SynthesizeSpeechRequest",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "SynthesisInput",
  "VoiceSelectionParams",
  "AudioConfig",
@@ -182,10 +185,34 @@ class Voice(proto.Message):
  )
 
 
+class AdvancedVoiceOptions(proto.Message):
+ r"""Used for advanced voice options.
+
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+ Attributes:
+ low_latency_journey_synthesis (bool):
+ Only for Journey voices. If false, the
+ synthesis will be context aware and have higher
+ latency.
+
+ This field is a member of `oneof`_ ``_low_latency_journey_synthesis``.
+ """
+
+ low_latency_journey_synthesis: bool = proto.Field(
+ proto.BOOL,
+ number=1,
+ optional=True,
+ )
+
+
 class SynthesizeSpeechRequest(proto.Message):
  r"""The top-level message sent by the client for the
  ``SynthesizeSpeech`` method.
 
+
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
  Attributes:
  input (google.cloud.texttospeech_v1.types.SynthesisInput):
  Required. The Synthesizer requires either
@@ -196,6 +223,10 @@ class SynthesizeSpeechRequest(proto.Message):
  audio_config (google.cloud.texttospeech_v1.types.AudioConfig):
  Required. The configuration of the
  synthesized audio.
+ advanced_voice_options (google.cloud.texttospeech_v1.types.AdvancedVoiceOptions):
+ Advanced voice options.
+
+ This field is a member of `oneof`_ ``_advanced_voice_options``.
  """
 
  input: "SynthesisInput" = proto.Field(
@@ -213,6 +244,87 @@ class SynthesizeSpeechRequest(proto.Message):
  number=3,
  message="AudioConfig",
  )
+ advanced_voice_options: "AdvancedVoiceOptions" = proto.Field(
+ proto.MESSAGE,
+ number=8,
+ optional=True,
+ message="AdvancedVoiceOptions",
+ )
+
+
+class CustomPronunciationParams(proto.Message):
+ r"""Pronunciation customization for a phrase.
+
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+ Attributes:
+ phrase (str):
+ The phrase to which the customization will be
+ applied. The phrase can be multiple words (in
+ the case of proper nouns etc), but should not
+ span to a whole sentence.
+
+ This field is a member of `oneof`_ ``_phrase``.
+ phonetic_encoding (google.cloud.texttospeech_v1.types.CustomPronunciationParams.PhoneticEncoding):
+ The phonetic encoding of the phrase.
+
+ This field is a member of `oneof`_ ``_phonetic_encoding``.
+ pronunciation (str):
+ The pronunciation of the phrase. This must be
+ in the phonetic encoding specified above.
+
+ This field is a member of `oneof`_ ``_pronunciation``.
+ """
+
+ class PhoneticEncoding(proto.Enum):
+ r"""The phonetic encoding of the phrase.
+
+ Values:
+ PHONETIC_ENCODING_UNSPECIFIED (0):
+ Not specified.
+ PHONETIC_ENCODING_IPA (1):
+ IPA. (e.g. apple -> ˈæpəl )
+ https://en.wikipedia.org/wiki/International_Phonetic_Alphabet
+ PHONETIC_ENCODING_X_SAMPA (2):
+ X-SAMPA (e.g. apple -> "{p@l" )
+ https://en.wikipedia.org/wiki/X-SAMPA
+ """
+ PHONETIC_ENCODING_UNSPECIFIED = 0
+ PHONETIC_ENCODING_IPA = 1
+ PHONETIC_ENCODING_X_SAMPA = 2
+
+ phrase: str = proto.Field(
+ proto.STRING,
+ number=1,
+ optional=True,
+ )
+ phonetic_encoding: PhoneticEncoding = proto.Field(
+ proto.ENUM,
+ number=2,
+ optional=True,
+ enum=PhoneticEncoding,
+ )
+ pronunciation: str = proto.Field(
+ proto.STRING,
+ number=3,
+ optional=True,
+ )
+
+
+class CustomPronunciations(proto.Message):
+ r"""A collection of pronunciation customizations.
+
+ Attributes:
+ pronunciations (MutableSequence[google.cloud.texttospeech_v1.types.CustomPronunciationParams]):
+ The pronunciation customizations to be
+ applied.
+ """
+
+ pronunciations: MutableSequence["CustomPronunciationParams"] = proto.RepeatedField(
+ proto.MESSAGE,
+ number=1,
+ message="CustomPronunciationParams",
+ )
 
 
 class SynthesisInput(proto.Message):
@@ -242,6 +354,22 @@ class SynthesisInput(proto.Message):
  `SSML <https://cloud.google.com/text-to-speech/docs/ssml>`__.
 
  This field is a member of `oneof`_ ``input_source``.
+ custom_pronunciations (google.cloud.texttospeech_v1.types.CustomPronunciations):
+ Optional. The pronunciation customizations to
+ be applied to the input. If this is set, the
+ input will be synthesized using the given
+ pronunciation customizations.
+
+ The initial support will be for EFIGS (English,
+ French, Italian, German, Spanish) languages, as
+ provided in VoiceSelectionParams. Journey and
+ Instant Clone voices are not supported yet.
+
+ In order to customize the pronunciation of a
+ phrase, there must be an exact match of the
+ phrase in the input types. If using SSML, the
+ phrase must not be inside a phoneme tag
+ (entirely or partially).
  """
 
  text: str = proto.Field(
@@ -254,6 +382,11 @@ class SynthesisInput(proto.Message):
  number=2,
  oneof="input_source",
  )
+ custom_pronunciations: "CustomPronunciations" = proto.Field(
+ proto.MESSAGE,
+ number=3,
+ message="CustomPronunciations",
+ )
 
 
 class VoiceSelectionParams(proto.Message):

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/__init__.py

@@ -24,8 +24,11 @@
  TextToSpeechLongAudioSynthesizeClient,
 )
 from .types.cloud_tts import (
+ AdvancedVoiceOptions,
  AudioConfig,
  AudioEncoding,
+ CustomPronunciationParams,
+ CustomPronunciations,
  CustomVoiceParams,
  ListVoicesRequest,
  ListVoicesResponse,
@@ -50,8 +53,11 @@
 __all__ = (
  "TextToSpeechAsyncClient",
  "TextToSpeechLongAudioSynthesizeAsyncClient",
+ "AdvancedVoiceOptions",
  "AudioConfig",
  "AudioEncoding",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "CustomVoiceParams",
  "ListVoicesRequest",
  "ListVoicesResponse",

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/gapic_version.py

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

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/types/__init__.py

@@ -14,8 +14,11 @@
 # limitations under the License.
 #
 from .cloud_tts import (
+ AdvancedVoiceOptions,
  AudioConfig,
  AudioEncoding,
+ CustomPronunciationParams,
+ CustomPronunciations,
  CustomVoiceParams,
  ListVoicesRequest,
  ListVoicesResponse,
@@ -38,7 +41,10 @@
 )
 
 __all__ = (
+ "AdvancedVoiceOptions",
  "AudioConfig",
+ "CustomPronunciationParams",
+ "CustomPronunciations",
  "CustomVoiceParams",
  "ListVoicesRequest",
  "ListVoicesResponse",