docs: Add documentation for enums (#256)

* docs: Add documentation for enums fix: Add context manager return types chore: Update gapic-generator-python to v1.8.1 PiperOrigin-RevId: 503210727 Source-Link: googleapis/googleapis@a391fd1 Source-Link: https://github.com/googleapis/googleapis-gen/commit/0080f830dec37c3384157082bce279e37079ea58 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9 * 🦉 Updates from OwlBot post-processor 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>

Author: gcf-owl-bot[bot]

google/cloud/mediatranslation_v1beta1/services/speech_translation_service/client.py

@@ -519,7 +519,7 @@ def request_generator():
  # Done; return the response.
  return response
 
- def __enter__(self):
+ def __enter__(self) -> "SpeechTranslationServiceClient":
  return self
 
  def __exit__(self, type, value, traceback):

google/cloud/mediatranslation_v1beta1/types/media_translation.py

@@ -277,7 +277,26 @@ class StreamingTranslateSpeechResponse(proto.Message):
  """
 
  class SpeechEventType(proto.Enum):
- r"""Indicates the type of speech event."""
+ r"""Indicates the type of speech event.
+
+ Values:
+ SPEECH_EVENT_TYPE_UNSPECIFIED (0):
+ No speech event specified.
+ END_OF_SINGLE_UTTERANCE (1):
+ This event indicates that the server has detected the end of
+ the user's speech utterance and expects no additional
+ speech. Therefore, the server will not process additional
+ audio (although it may subsequently return additional
+ results). When the client receives 'END_OF_SINGLE_UTTERANCE'
+ event, the client should stop sending the requests. However,
+ clients should keep receiving remaining responses until the
+ stream is terminated. To construct the complete sentence in
+ a streaming way, one should override (if 'is_final' of
+ previous response is false), or append (if 'is_final' of
+ previous response is true). This event is only sent if
+ ``single_utterance`` was set to ``true``, and is not used
+ otherwise.
+ """
  SPEECH_EVENT_TYPE_UNSPECIFIED = 0
  END_OF_SINGLE_UTTERANCE = 1
 

samples/generated_samples/snippet_metadata_google.cloud.mediatranslation.v1beta1.json

@@ -8,7 +8,7 @@
  ],
  "language": "PYTHON",
  "name": "google-cloud-media-translation",
- "version": "0.11.0"
+ "version": "0.1.0"
  },
  "snippets": [
  {