google-cloud-speech-v2 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf12e4d7b09605a803e9337cf9085e0e83db8d381e0c16de517c8d50dad3d88e
-  data.tar.gz: 7ff56273fd9befca33be9ebc2e342be9d8c7050f4a2be53c65b0126cb327382b
+  metadata.gz: 968563d525eccf954b107c73edfb327cc252d97912a5ca5ee688aa308ccafc04
+  data.tar.gz: cbba46b095a9649b5ebcefad32cf7fda937c76f1119e3792ff5e3ef41b49931a
 SHA512:
-  metadata.gz: 178fe7e5ce4d79f4f49a0cd64cb296e8afdb6b3507fe934c03369ab20ac7070aa0ef6fef8b81ec08510c69b2730008a42fc9d4a52581d710a68dcc99018f64f2
-  data.tar.gz: f0789fbd8ef72e18634fc27a4becc2fccba89f17e501399398d8519373e116f6e62bb2522fdce43e5393890f48c60c03aa111ad2810e5a43fa6a48cd94fa3d17
+  metadata.gz: 2cd7b6ecdce54170bdc1b7f35f0b0aee18e88a2cf6dc3dc8710bff3239b234a6154071c78a3fd49d8225a3dcfdca5d87aadf3d1c34ed722b1600e565f185f27a
+  data.tar.gz: 7e82039c8de923e79efe5e4e3ab8dba62c50db60e0a84b8cc194272b873ccbc0508a419ab6300b9dde3c483e0f17f8e500d64df510e8b4a8b7d6187ac6f5a4c8

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud Speech-to-Text V2 API
 
-API Client library for the Cloud Speech-to-Text V2 API
+Converts audio to text by applying powerful neural network models.
 
 Google Speech-to-Text enables developers to convert audio to text by applying powerful neural network models in an easy-to-use API. The API recognizes more than 120 languages and variants to support your global user base. You can enable voice command-and-control, transcribe audio from call centers, and more. It can process real-time streaming or prerecorded audio, using Google's machine learning technology.
 
@@ -47,7 +47,7 @@ for general usage information.
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

data/lib/google/cloud/speech/v2/bindings_override.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/config"
+
+module Google
+  module Cloud
+    module Speech
+      ##
+      # @example Loading just the REST part of this package, including all its services, and instantiating a REST client
+      #
+      #     require "google/cloud/speech/v2/rest"
+      #     client = ::Google::Cloud::Speech::V2::Speech::Rest::Client.new
+      #
+      module V2
+        ##
+        # @private
+        # Initialize the mixin bindings configuration
+        #
+        def self.configure
+          @configure ||= begin
+            namespace = ["Google", "Cloud", "Speech"]
+            parent_config = while namespace.any?
+                              parent_name = namespace.join "::"
+                              parent_const = const_get parent_name
+                              break parent_const.configure if parent_const.respond_to? :configure
+                              namespace.pop
+                            end
+
+            default_config = Configuration.new parent_config
+            default_config.bindings_override["google.cloud.location.Locations.GetLocation"] = [
+              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
+                uri_method: :get,
+                uri_template: "/v2/{name}",
+                matches: [
+                  ["name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
+                ],
+                body: nil
+              )
+            ]
+            default_config.bindings_override["google.cloud.location.Locations.ListLocations"] = [
+
+              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
+                uri_method: :get,
+                uri_template: "/v2/{name}/locations",
+                matches: [
+                  ["name", %r{^projects/[^/]+/?$}, false]
+                ],
+                body: nil
+              )
+            ]
+            default_config
+          end
+          yield @configure if block_given?
+          @configure
+        end
+
+        ##
+        # @private
+        # Configuration class for the google.cloud.speech.v2 package.
+        #
+        # This class contains common configuration for all services
+        # of the google.cloud.speech.v2 package.
+        #
+        # This configuration is for internal use of the client library classes,
+        # and it is not intended that the end-users will read or change it.
+        #
+        class Configuration
+          extend ::Gapic::Config
+
+          # @private
+          # Overrides for http bindings for the RPC of the mixins for this package.
+          # Services in this package should use these when creating clients for the mixin services.
+          # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+          config_attr :bindings_override, {}, ::Hash, nil
+
+          # @private
+          def initialize parent_config = nil
+            @parent_config = parent_config unless parent_config.nil?
+
+            yield self if block_given?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/speech/v2/cloud_speech_pb.rb

@@ -211,13 +211,32 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :config, :message, 4, "google.cloud.speech.v2.RecognitionConfig"
       optional :config_mask, :message, 5, "google.protobuf.FieldMask"
       repeated :files, :message, 3, "google.cloud.speech.v2.BatchRecognizeFileMetadata"
+      optional :recognition_output_config, :message, 6, "google.cloud.speech.v2.RecognitionOutputConfig"
+    end
+    add_message "google.cloud.speech.v2.GcsOutputConfig" do
+      optional :uri, :string, 1
+    end
+    add_message "google.cloud.speech.v2.InlineOutputConfig" do
+    end
+    add_message "google.cloud.speech.v2.RecognitionOutputConfig" do
+      oneof :output do
+        optional :gcs_output_config, :message, 1, "google.cloud.speech.v2.GcsOutputConfig"
+        optional :inline_response_config, :message, 2, "google.cloud.speech.v2.InlineOutputConfig"
+      end
     end
     add_message "google.cloud.speech.v2.BatchRecognizeResponse" do
       map :results, :string, :message, 1, "google.cloud.speech.v2.BatchRecognizeFileResult"
+      optional :total_billed_duration, :message, 2, "google.protobuf.Duration"
+    end
+    add_message "google.cloud.speech.v2.BatchRecognizeResults" do
+      repeated :results, :message, 1, "google.cloud.speech.v2.SpeechRecognitionResult"
+      optional :metadata, :message, 2, "google.cloud.speech.v2.RecognitionResponseMetadata"
     end
     add_message "google.cloud.speech.v2.BatchRecognizeFileResult" do
       optional :uri, :string, 1
       optional :error, :message, 2, "google.rpc.Status"
+      optional :metadata, :message, 3, "google.cloud.speech.v2.RecognitionResponseMetadata"
+      optional :transcript, :message, 4, "google.cloud.speech.v2.BatchRecognizeResults"
     end
     add_message "google.cloud.speech.v2.BatchRecognizeTranscriptionMetadata" do
       optional :progress_percent, :int32, 1
@@ -423,7 +442,11 @@ module Google
         StreamingRecognitionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.StreamingRecognitionConfig").msgclass
         StreamingRecognizeRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.StreamingRecognizeRequest").msgclass
         BatchRecognizeRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeRequest").msgclass
+        GcsOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.GcsOutputConfig").msgclass
+        InlineOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.InlineOutputConfig").msgclass
+        RecognitionOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.RecognitionOutputConfig").msgclass
         BatchRecognizeResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeResponse").msgclass
+        BatchRecognizeResults = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeResults").msgclass
         BatchRecognizeFileResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeFileResult").msgclass
         BatchRecognizeTranscriptionMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeTranscriptionMetadata").msgclass
         BatchRecognizeMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v2.BatchRecognizeMetadata").msgclass

data/lib/google/cloud/speech/v2/cloud_speech_services_pb.rb

@@ -39,7 +39,7 @@ module Google
             rpc :ListRecognizers, ::Google::Cloud::Speech::V2::ListRecognizersRequest, ::Google::Cloud::Speech::V2::ListRecognizersResponse
             # Returns the requested
             # [Recognizer][google.cloud.speech.v2.Recognizer]. Fails with
-            # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested recognizer doesn't
+            # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested Recognizer doesn't
             # exist.
             rpc :GetRecognizer, ::Google::Cloud::Speech::V2::GetRecognizerRequest, ::Google::Cloud::Speech::V2::Recognizer
             # Updates the [Recognizer][google.cloud.speech.v2.Recognizer].

data/lib/google/cloud/speech/v2/rest.rb

@@ -17,6 +17,7 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/speech/v2/speech/rest"
+require "google/cloud/speech/v2/bindings_override"
 require "google/cloud/speech/v2/version"
 
 module Google

data/lib/google/cloud/speech/v2/speech/client.rb

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/speech/v2/cloud_speech_pb"
+require "google/cloud/location"
 
 module Google
   module Cloud
@@ -144,6 +145,12 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @speech_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Speech::V2::Speech::Stub,
                 credentials:  credentials,
@@ -160,6 +167,13 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
             # Service calls
 
             ##
@@ -375,7 +389,7 @@ module Google
             ##
             # Returns the requested
             # {::Google::Cloud::Speech::V2::Recognizer Recognizer}. Fails with
-            # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested recognizer doesn't
+            # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested Recognizer doesn't
             # exist.
             #
             # @overload get_recognizer(request, options = nil)
@@ -985,7 +999,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload batch_recognize(recognizer: nil, config: nil, config_mask: nil, files: nil)
+            # @overload batch_recognize(recognizer: nil, config: nil, config_mask: nil, files: nil, recognition_output_config: nil)
             #   Pass arguments to `batch_recognize` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1015,6 +1029,9 @@ module Google
             #     request.
             #   @param files [::Array<::Google::Cloud::Speech::V2::BatchRecognizeFileMetadata, ::Hash>]
             #     Audio files with file metadata for ASR.
+            #     The maximum number of files allowed to be specified is 5.
+            #   @param recognition_output_config [::Google::Cloud::Speech::V2::RecognitionOutputConfig, ::Hash]
+            #     Configuration options for where to output the transcripts of each file.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -2515,9 +2532,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/speech/v2/speech/operations.rb

@@ -620,9 +620,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/speech/v2/speech/rest/client.rb

@@ -19,6 +19,7 @@
 require "google/cloud/errors"
 require "google/cloud/speech/v2/cloud_speech_pb"
 require "google/cloud/speech/v2/speech/rest/service_stub"
+require "google/cloud/location/rest"
 
 module Google
   module Cloud
@@ -141,6 +142,13 @@ module Google
                   config.endpoint = @config.endpoint
                 end
 
+                @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
+                  config.credentials = credentials
+                  config.quota_project = @quota_project_id
+                  config.endpoint = @config.endpoint
+                  config.bindings_override = @config.bindings_override
+                end
+
                 @speech_stub = ::Google::Cloud::Speech::V2::Speech::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
               end
 
@@ -151,6 +159,13 @@ module Google
               #
               attr_reader :operations_client
 
+              ##
+              # Get the associated client for mix-in of the Locations.
+              #
+              # @return [Google::Cloud::Location::Locations::Rest::Client]
+              #
+              attr_reader :location_client
+
               # Service calls
 
               ##
@@ -309,7 +324,7 @@ module Google
               ##
               # Returns the requested
               # {::Google::Cloud::Speech::V2::Recognizer Recognizer}. Fails with
-              # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested recognizer doesn't
+              # [NOT_FOUND][google.rpc.Code.NOT_FOUND] if the requested Recognizer doesn't
               # exist.
               #
               # @overload get_recognizer(request, options = nil)
@@ -704,7 +719,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload batch_recognize(recognizer: nil, config: nil, config_mask: nil, files: nil)
+              # @overload batch_recognize(recognizer: nil, config: nil, config_mask: nil, files: nil, recognition_output_config: nil)
               #   Pass arguments to `batch_recognize` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -734,6 +749,9 @@ module Google
               #     request.
               #   @param files [::Array<::Google::Cloud::Speech::V2::BatchRecognizeFileMetadata, ::Hash>]
               #     Audio files with file metadata for ASR.
+              #     The maximum number of files allowed to be specified is 5.
+              #   @param recognition_output_config [::Google::Cloud::Speech::V2::RecognitionOutputConfig, ::Hash]
+              #     Configuration options for where to output the transcripts of each file.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1818,9 +1836,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope
@@ -1866,6 +1884,13 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
 
+                # @private
+                # Overrides for http bindings for the RPCs of this service
+                # are only used when this service is used as mixin, and only
+                # by the host service.
+                # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+                config_attr :bindings_override, {}, ::Hash, nil
+
                 # @private
                 def initialize parent_config = nil
                   @parent_config = parent_config unless parent_config.nil?

data/lib/google/cloud/speech/v2/speech/rest/operations.rb

@@ -411,9 +411,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope

data/lib/google/cloud/speech/v2/speech/rest.rb

@@ -21,6 +21,7 @@ require "gapic/config"
 require "gapic/config/method"
 
 require "google/cloud/speech/v2/version"
+require "google/cloud/speech/v2/bindings_override"
 
 require "google/cloud/speech/v2/speech/credentials"
 require "google/cloud/speech/v2/speech/paths"

data/lib/google/cloud/speech/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Speech
       module V2
-        VERSION = "0.2.0"
+        VERSION = "0.3.0"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -240,8 +246,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute

data/proto_docs/google/cloud/speech/v2/cloud_speech.rb

@@ -275,22 +275,44 @@ module Google
         #       When using this model, the service will stop transcribing audio after the
         #       first utterance is detected and completed.
         #
-        #     When using this model,
-        #     {::Google::Cloud::Speech::V2::RecognitionFeatures::MultiChannelMode::SEPARATE_RECOGNITION_PER_CHANNEL SEPARATE_RECOGNITION_PER_CHANNEL}
-        #     is not supported; multi-channel audio is accepted, but only the first
-        #     channel will be processed and transcribed.
+        #       When using this model,
+        #       {::Google::Cloud::Speech::V2::RecognitionFeatures::MultiChannelMode::SEPARATE_RECOGNITION_PER_CHANNEL SEPARATE_RECOGNITION_PER_CHANNEL}
+        #       is not supported; multi-channel audio is accepted, but only the first
+        #       channel will be processed and transcribed.
+        #
+        #     - `telephony`
+        #
+        #       Best for audio that originated from a phone call (typically recorded at
+        #       an 8khz sampling rate).
+        #
+        #     - `medical_conversation`
+        #
+        #       For conversations between a medical provider—for example, a doctor or
+        #       nurse—and a patient. Use this model when both a provider and a patient
+        #       are speaking. Words uttered by each speaker are automatically detected
+        #       and labeled in the returned transcript.
+        #
+        #       For supported features please see [medical models
+        #       documentation](https://cloud.google.com/speech-to-text/docs/medical-models).
+        #
+        #     - `medical_dictation`
+        #
+        #       For dictated notes spoken by a single medical provider—for example, a
+        #       doctor dictating notes about a patient's blood test results.
+        #
+        #       For supported features please see [medical models
+        #       documentation](https://cloud.google.com/speech-to-text/docs/medical-models).
+        #
+        #     - `usm`
+        #
+        #       The next generation of Speech-to-Text models from Google.
         # @!attribute [rw] language_codes
         #   @return [::Array<::String>]
         #     Required. The language of the supplied audio as a
         #     [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
         #
-        #     Supported languages:
-        #
-        #     - `en-US`
-        #
-        #     - `en-GB`
-        #
-        #     - `fr-FR`
+        #     Supported languages for each model are listed at:
+        #     https://cloud.google.com/speech-to-text/docs/languages
         #
         #     If additional languages are provided, recognition result will contain
         #     recognition in the most likely language detected. The recognition result
@@ -373,14 +395,23 @@ module Google
 
         # Automatically detected decoding parameters.
         # Supported for the following encodings:
+        #
         # * WAV_LINEAR16: 16-bit signed little-endian PCM samples in a WAV container.
+        #
         # * WAV_MULAW: 8-bit companded mulaw samples in a WAV container.
+        #
         # * WAV_ALAW: 8-bit companded alaw samples in a WAV container.
+        #
         # * RFC4867_5_AMR: AMR frames with an rfc4867.5 header.
+        #
         # * RFC4867_5_AMRWB: AMR-WB frames with an rfc4867.5 header.
+        #
         # * FLAC: FLAC frames in the "native FLAC" container format.
+        #
         # * MP3: MPEG audio frames with optional (ignored) ID3 metadata.
+        #
         # * OGG_OPUS: Opus audio frames in an Ogg container.
+        #
         # * WEBM_OPUS: Opus audio frames in a WebM container.
         class AutoDetectDecodingConfig
           include ::Google::Protobuf::MessageExts
@@ -398,16 +429,24 @@ module Google
         #     sampling rate of the audio source to 16000 Hz. If that's not possible, use
         #     the native sample rate of the audio source (instead of re-sampling).
         #     Supported for the following encodings:
+        #
         #     * LINEAR16: Headerless 16-bit signed little-endian PCM samples.
+        #
         #     * MULAW: Headerless 8-bit companded mulaw samples.
+        #
         #     * ALAW: Headerless 8-bit companded alaw samples.
         # @!attribute [rw] audio_channel_count
         #   @return [::Integer]
         #     Number of channels present in the audio data sent for recognition.
         #     Supported for the following encodings:
+        #
         #     * LINEAR16: Headerless 16-bit signed little-endian PCM samples.
+        #
         #     * MULAW: Headerless 8-bit companded mulaw samples.
+        #
         #     * ALAW: Headerless 8-bit companded alaw samples.
+        #
+        #     The maximum allowed value is 8.
         class ExplicitDecodingConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -433,7 +472,7 @@ module Google
         #   @return [::Integer]
         #     Required. Minimum number of speakers in the conversation. This range gives
         #     you more flexibility by allowing the system to automatically determine the
-        #     correct number of speakers. If not set, the default value is 2.
+        #     correct number of speakers.
         #
         #     To fix the number of speakers detected in the audio, set
         #     `min_speaker_count` = `max_speaker_count`.
@@ -521,28 +560,28 @@ module Google
         end
 
         # Provides "hints" to the speech recognizer to favor specific words and phrases
-        # in the results. Phrase sets can be specified as an inline resource, or a
-        # reference to an existing phrase set resource.
+        # in the results. PhraseSets can be specified as an inline resource, or a
+        # reference to an existing PhraseSet resource.
         # @!attribute [rw] phrase_sets
         #   @return [::Array<::Google::Cloud::Speech::V2::SpeechAdaptation::AdaptationPhraseSet>]
-        #     A list of inline or referenced phrase sets.
+        #     A list of inline or referenced PhraseSets.
         # @!attribute [rw] custom_classes
         #   @return [::Array<::Google::Cloud::Speech::V2::CustomClass>]
-        #     A list of inline custom classes. Existing custom class resources can be
-        #     referenced directly in a phrase set.
+        #     A list of inline CustomClasses. Existing CustomClass resources can be
+        #     referenced directly in a PhraseSet.
         class SpeechAdaptation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # A biasing phrase set, which can be either a string referencing the name of
-          # an existing phrase set resource, or an inline definition of a phrase set.
+          # A biasing PhraseSet, which can be either a string referencing the name of
+          # an existing PhraseSets resource, or an inline definition of a PhraseSet.
           # @!attribute [rw] phrase_set
           #   @return [::String]
-          #     The name of an existing phrase set resource. The user must have read
+          #     The name of an existing PhraseSet resource. The user must have read
           #     access to the resource and it must not be deleted.
           # @!attribute [rw] inline_phrase_set
           #   @return [::Google::Cloud::Speech::V2::PhraseSet]
-          #     An inline defined phrase set.
+          #     An inline defined PhraseSet.
           class AdaptationPhraseSet
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -651,9 +690,9 @@ module Google
         # @!attribute [rw] words
         #   @return [::Array<::Google::Cloud::Speech::V2::WordInfo>]
         #     A list of word-specific information for each recognized word.
-        #     When
-        #     [enable_speaker_diarization][google.cloud.speech.v2.SpeakerDiarizationConfig.enable_speaker_diarization]
-        #     is true, you will see all the words from the beginning of the audio.
+        #     When the
+        #     {::Google::Cloud::Speech::V2::SpeakerDiarizationConfig SpeakerDiarizationConfig}
+        #     is set, you will see all the words from the beginning of the audio.
         class SpeechRecognitionAlternative
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -694,8 +733,8 @@ module Google
         #     A distinct label is assigned for every speaker within the audio. This field
         #     specifies which one of those speakers was detected to have spoken this
         #     word. `speaker_label` is set if
-        #     [enable_speaker_diarization][google.cloud.speech.v2.SpeakerDiarizationConfig.enable_speaker_diarization]
-        #     is `true` and only in the top alternative.
+        #     {::Google::Cloud::Speech::V2::SpeakerDiarizationConfig SpeakerDiarizationConfig}
+        #     is given and only in the top alternative.
         class WordInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -795,9 +834,9 @@ module Google
         #     of the recognizer during this recognition request. If no mask is provided,
         #     all non-default valued fields in
         #     {::Google::Cloud::Speech::V2::StreamingRecognitionConfig#config config} override
-        #     the values in the recognizer for this recognition request. If a mask is
+        #     the values in the Recognizer for this recognition request. If a mask is
         #     provided, only the fields listed in the mask override the config in the
-        #     recognizer for this recognition request. If a wildcard (`*`) is provided,
+        #     Recognizer for this recognition request. If a wildcard (`*`) is provided,
         #     {::Google::Cloud::Speech::V2::StreamingRecognitionConfig#config config}
         #     completely overrides and replaces the config in the recognizer for this
         #     recognition request.
@@ -841,6 +880,7 @@ module Google
         # @!attribute [rw] audio
         #   @return [::String]
         #     Inline audio bytes to be Recognized.
+        #     Maximum size for this field is 15 KB per request.
         class StreamingRecognizeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -878,17 +918,57 @@ module Google
         # @!attribute [rw] files
         #   @return [::Array<::Google::Cloud::Speech::V2::BatchRecognizeFileMetadata>]
         #     Audio files with file metadata for ASR.
+        #     The maximum number of files allowed to be specified is 5.
+        # @!attribute [rw] recognition_output_config
+        #   @return [::Google::Cloud::Speech::V2::RecognitionOutputConfig]
+        #     Configuration options for where to output the transcripts of each file.
         class BatchRecognizeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Output configurations for Cloud Storage.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     The Cloud Storage URI prefix with which recognition results will be
+        #     written.
+        class GcsOutputConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Output configurations for inline response.
+        class InlineOutputConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Configuration options for the output(s) of recognition.
+        # @!attribute [rw] gcs_output_config
+        #   @return [::Google::Cloud::Speech::V2::GcsOutputConfig]
+        #     If this message is populated, recognition results are written to the
+        #     provided Google Cloud Storage URI.
+        # @!attribute [rw] inline_response_config
+        #   @return [::Google::Cloud::Speech::V2::InlineOutputConfig]
+        #     If this message is populated, recognition results are provided in the
+        #     {::Google::Cloud::Speech::V2::BatchRecognizeResponse BatchRecognizeResponse}
+        #     message of the Operation when completed. This is only supported when
+        #     calling {::Google::Cloud::Speech::V2::Speech::Client#batch_recognize BatchRecognize}
+        #     with just one audio file.
+        class RecognitionOutputConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Response message for
         # {::Google::Cloud::Speech::V2::Speech::Client#batch_recognize BatchRecognize} that is
         # packaged into a longrunning {::Google::Longrunning::Operation Operation}.
         # @!attribute [rw] results
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Speech::V2::BatchRecognizeFileResult}]
         #     Map from filename to the final result for that file.
+        # @!attribute [rw] total_billed_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     When available, billed audio seconds for the corresponding request.
         class BatchRecognizeResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -903,13 +983,36 @@ module Google
           end
         end
 
+        # Output type for Cloud Storage of BatchRecognize transcripts. Though this
+        # proto isn't returned in this API anywhere, the Cloud Storage transcripts will
+        # be this proto serialized and should be parsed as such.
+        # @!attribute [rw] results
+        #   @return [::Array<::Google::Cloud::Speech::V2::SpeechRecognitionResult>]
+        #     Sequential list of transcription results corresponding to sequential
+        #     portions of audio.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Cloud::Speech::V2::RecognitionResponseMetadata]
+        #     Metadata about the recognition.
+        class BatchRecognizeResults
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Final results for a single file.
         # @!attribute [rw] uri
         #   @return [::String]
-        #     The GCS URI to which recognition results were written.
+        #     The Cloud Storage URI to which recognition results were written.
         # @!attribute [rw] error
         #   @return [::Google::Rpc::Status]
         #     Error if one was encountered.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Cloud::Speech::V2::RecognitionResponseMetadata]
+        # @!attribute [rw] transcript
+        #   @return [::Google::Cloud::Speech::V2::BatchRecognizeResults]
+        #     The transcript for the audio file. This is populated only when
+        #     {::Google::Cloud::Speech::V2::InlineOutputConfig InlineOutputConfig} is set in
+        #     the
+        #     [RecognitionOutputConfig][[google.cloud.speech.v2.RecognitionOutputConfig].
         class BatchRecognizeFileResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -925,7 +1028,7 @@ module Google
         #     Error if one was encountered.
         # @!attribute [rw] uri
         #   @return [::String]
-        #     The GCS URI to which recognition results will be written.
+        #     The Cloud Storage URI to which recognition results will be written.
         class BatchRecognizeTranscriptionMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1290,7 +1393,8 @@ module Google
         #     phrase will be recognized over other similar sounding phrases. The higher
         #     the boost, the higher the chance of false positive recognition as well.
         #     Valid `boost` values are between 0 (exclusive) and 20. We recommend using a
-        #     binary search approach to finding the optimal value for your use case.
+        #     binary search approach to finding the optimal value for your use case as
+        #     well as adding phrases both with and without boost to your requests.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     User-settable, human-readable name for the PhraseSet. Must be 63
@@ -1358,11 +1462,11 @@ module Google
           #     be recognized over other similar sounding phrases. The higher the boost,
           #     the higher the chance of false positive recognition as well. Negative
           #     boost values would correspond to anti-biasing. Anti-biasing is not
-          #     enabled, so negative boost will simply be ignored. Though `boost` can
-          #     accept a wide range of positive values, most use cases are best served
-          #     with values between 0 and 20. We recommend using a binary search approach
-          #     to finding the optimal value for your use case. Speech recognition
-          #     will skip PhraseSets with a boost value of 0.
+          #     enabled, so negative boost values will return an error. Boost values must
+          #     be between 0 and 20. Any values outside that range will return an error.
+          #     We recommend using a binary search approach to finding the optimal value
+          #     for your use case as well as adding phrases both with and without boost
+          #     to your requests.
           class Phrase
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-speech-v2
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-23 00:00:00.000000000 Z
+date: 2023-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.17.1
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.17.1
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -44,6 +44,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: google-cloud-location
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
@@ -175,6 +195,7 @@ files:
 - README.md
 - lib/google-cloud-speech-v2.rb
 - lib/google/cloud/speech/v2.rb
+- lib/google/cloud/speech/v2/bindings_override.rb
 - lib/google/cloud/speech/v2/cloud_speech_pb.rb
 - lib/google/cloud/speech/v2/cloud_speech_services_pb.rb
 - lib/google/cloud/speech/v2/rest.rb
@@ -223,5 +244,5 @@ requirements: []
 rubygems_version: 3.4.2
 signing_key: 
 specification_version: 4
-summary: API Client library for the Cloud Speech-to-Text V2 API
+summary: Converts audio to text by applying powerful neural network models.
 test_files: []