feat: added Speech-to-Text V2 API (#447)

* build: enable Speech v2 client library generation

PiperOrigin-RevId: 477910378

Source-Link: googleapis/googleapis@3fde7ab

Source-Link: googleapis/googleapis-gen@6369579
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNjM2OTU3OTA2Y2M3ODY4MDY1YTUwY2VmNjFmNWU5OTVhNzVhZTNlNiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* chore: regenerate docs/index.rst

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 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>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

packages/google-cloud-python-speech/docs/index.rst

@@ -2,33 +2,44 @@
 
 .. include:: multiprocessing.rst
 
+This package includes clients for multiple versions of Cloud Speech.
+By default, you will get version ``speech_v1``.
+
 
 API Reference
 -------------
-
 .. toctree::
-  :maxdepth: 2
+    :maxdepth: 2
 
-  speech_v1/services
-  speech_v1/types
+    speech_v1/services
+    speech_v1/types
 
-An API and type reference is provided the first beta also:
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
 
+    speech_v1p1beta1/services
+    speech_v1p1beta1/types
+
+API Reference
+-------------
 .. toctree::
-  :maxdepth: 2
+    :maxdepth: 2
+
+    speech_v2/services
+    speech_v2/types
 
-  speech_v1p1beta1/services
-  speech_v1p1beta1/types
 
 Migration Guide
 ---------------
 
-See the guide below for instructions on migrating to the 2.x release of this library.
+See the guide below for instructions on migrating to the latest version.
 
 .. toctree::
     :maxdepth: 2
 
-    UPGRADING
+    UPGRADING
 
 
 Changelog
@@ -37,6 +48,6 @@ Changelog
 For a list of all ``google-cloud-speech`` releases:
 
 .. toctree::
-  :maxdepth: 2
+    :maxdepth: 2
 
-  changelog
+    changelog

packages/google-cloud-python-speech/docs/speech_v2/services.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Speech v2 API
+=======================================
+.. toctree::
+    :maxdepth: 2
+
+    speech

packages/google-cloud-python-speech/docs/speech_v2/speech.rst

@@ -0,0 +1,10 @@
+Speech
+------------------------
+
+.. automodule:: google.cloud.speech_v2.services.speech
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.speech_v2.services.speech.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-python-speech/docs/speech_v2/types.rst

@@ -0,0 +1,7 @@
+Types for Google Cloud Speech v2 API
+====================================
+
+.. automodule:: google.cloud.speech_v2.types
+    :members:
+    :undoc-members:
+    :show-inheritance:

packages/google-cloud-python-speech/google/cloud/speech_v2/__init__.py

@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from .services.speech import SpeechClient
+from .services.speech import SpeechAsyncClient
+
+from .types.cloud_speech import AutoDetectDecodingConfig
+from .types.cloud_speech import BatchRecognizeFileMetadata
+from .types.cloud_speech import BatchRecognizeFileResult
+from .types.cloud_speech import BatchRecognizeMetadata
+from .types.cloud_speech import BatchRecognizeRequest
+from .types.cloud_speech import BatchRecognizeResponse
+from .types.cloud_speech import BatchRecognizeTranscriptionMetadata
+from .types.cloud_speech import Config
+from .types.cloud_speech import CreateCustomClassRequest
+from .types.cloud_speech import CreatePhraseSetRequest
+from .types.cloud_speech import CreateRecognizerRequest
+from .types.cloud_speech import CustomClass
+from .types.cloud_speech import DeleteCustomClassRequest
+from .types.cloud_speech import DeletePhraseSetRequest
+from .types.cloud_speech import DeleteRecognizerRequest
+from .types.cloud_speech import ExplicitDecodingConfig
+from .types.cloud_speech import GetConfigRequest
+from .types.cloud_speech import GetCustomClassRequest
+from .types.cloud_speech import GetPhraseSetRequest
+from .types.cloud_speech import GetRecognizerRequest
+from .types.cloud_speech import ListCustomClassesRequest
+from .types.cloud_speech import ListCustomClassesResponse
+from .types.cloud_speech import ListPhraseSetsRequest
+from .types.cloud_speech import ListPhraseSetsResponse
+from .types.cloud_speech import ListRecognizersRequest
+from .types.cloud_speech import ListRecognizersResponse
+from .types.cloud_speech import OperationMetadata
+from .types.cloud_speech import PhraseSet
+from .types.cloud_speech import RecognitionConfig
+from .types.cloud_speech import RecognitionFeatures
+from .types.cloud_speech import RecognitionResponseMetadata
+from .types.cloud_speech import Recognizer
+from .types.cloud_speech import RecognizeRequest
+from .types.cloud_speech import RecognizeResponse
+from .types.cloud_speech import SpeakerDiarizationConfig
+from .types.cloud_speech import SpeechAdaptation
+from .types.cloud_speech import SpeechRecognitionAlternative
+from .types.cloud_speech import SpeechRecognitionResult
+from .types.cloud_speech import StreamingRecognitionConfig
+from .types.cloud_speech import StreamingRecognitionFeatures
+from .types.cloud_speech import StreamingRecognitionResult
+from .types.cloud_speech import StreamingRecognizeRequest
+from .types.cloud_speech import StreamingRecognizeResponse
+from .types.cloud_speech import UndeleteCustomClassRequest
+from .types.cloud_speech import UndeletePhraseSetRequest
+from .types.cloud_speech import UndeleteRecognizerRequest
+from .types.cloud_speech import UpdateConfigRequest
+from .types.cloud_speech import UpdateCustomClassRequest
+from .types.cloud_speech import UpdatePhraseSetRequest
+from .types.cloud_speech import UpdateRecognizerRequest
+from .types.cloud_speech import WordInfo
+
+from google.cloud.speech_v1.helpers import SpeechHelpers
+
+
+class SpeechClient(SpeechHelpers, SpeechClient):
+    __doc__ = SpeechClient.__doc__
+
+
+__all__ = (
+    "SpeechAsyncClient",
+    "AutoDetectDecodingConfig",
+    "BatchRecognizeFileMetadata",
+    "BatchRecognizeFileResult",
+    "BatchRecognizeMetadata",
+    "BatchRecognizeRequest",
+    "BatchRecognizeResponse",
+    "BatchRecognizeTranscriptionMetadata",
+    "Config",
+    "CreateCustomClassRequest",
+    "CreatePhraseSetRequest",
+    "CreateRecognizerRequest",
+    "CustomClass",
+    "DeleteCustomClassRequest",
+    "DeletePhraseSetRequest",
+    "DeleteRecognizerRequest",
+    "ExplicitDecodingConfig",
+    "GetConfigRequest",
+    "GetCustomClassRequest",
+    "GetPhraseSetRequest",
+    "GetRecognizerRequest",
+    "ListCustomClassesRequest",
+    "ListCustomClassesResponse",
+    "ListPhraseSetsRequest",
+    "ListPhraseSetsResponse",
+    "ListRecognizersRequest",
+    "ListRecognizersResponse",
+    "OperationMetadata",
+    "PhraseSet",
+    "RecognitionConfig",
+    "RecognitionFeatures",
+    "RecognitionResponseMetadata",
+    "RecognizeRequest",
+    "RecognizeResponse",
+    "Recognizer",
+    "SpeakerDiarizationConfig",
+    "SpeechAdaptation",
+    "SpeechClient",
+    "SpeechRecognitionAlternative",
+    "SpeechRecognitionResult",
+    "StreamingRecognitionConfig",
+    "StreamingRecognitionFeatures",
+    "StreamingRecognitionResult",
+    "StreamingRecognizeRequest",
+    "StreamingRecognizeResponse",
+    "UndeleteCustomClassRequest",
+    "UndeletePhraseSetRequest",
+    "UndeleteRecognizerRequest",
+    "UpdateConfigRequest",
+    "UpdateCustomClassRequest",
+    "UpdatePhraseSetRequest",
+    "UpdateRecognizerRequest",
+    "WordInfo",
+)