google-cloud-speech-v2 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6dc0573ff1452b8d1557121bdb1480f17f7dc2f930940d28b1861cbfb13b50d
-  data.tar.gz: 60ac9504005da3d94d0a56a006aa91edbc20a7fa5c2215c3acdcf152bb80ec2f
+  metadata.gz: 968563d525eccf954b107c73edfb327cc252d97912a5ca5ee688aa308ccafc04
+  data.tar.gz: cbba46b095a9649b5ebcefad32cf7fda937c76f1119e3792ff5e3ef41b49931a
 SHA512:
-  metadata.gz: e682b0ec9905e8eb8550ed5b23c4b921f4db09308df56a7f17e40024c45a837c751598283b5cb994a2dab47406f1bacab12edc0d79a824d1628cc16aa6824c44
-  data.tar.gz: '01997b59151cdc1d2ef28f4ba418c1ffc3a3994d154a08cc391d06d5ec0fd994683e68e1bd41f308a7d7daf7c8826ca408848e3dd24d0e7c8e9034ba58d2f229'
+  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.
 
@@ -46,8 +46,8 @@ for general usage information.
 ## Enabling Logging
 
 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/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+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://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

@@ -0,0 +1,38 @@
+# 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 "google/cloud/speech/v2/speech/rest"
+require "google/cloud/speech/v2/bindings_override"
+require "google/cloud/speech/v2/version"
+
+module Google
+  module Cloud
+    module Speech
+      ##
+      # To load just the REST part of this package, including all its services, and instantiate a REST client:
+      #
+      # @example
+      #
+      #     require "google/cloud/speech/v2/rest"
+      #     client = ::Google::Cloud::Speech::V2::Speech::Rest::Client.new
+      #
+      module V2
+      end
+    end
+  end
+end

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
 
             ##
@@ -215,14 +229,14 @@ module Google
             #   # Call the create_recognizer method.
             #   result = client.create_recognizer request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def create_recognizer request, options = nil
@@ -323,13 +337,11 @@ module Google
             #   # Call the list_recognizers method.
             #   result = client.list_recognizers request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Speech::V2::Recognizer.
-            #     p response
+            #     p item
             #   end
             #
             def list_recognizers request, options = nil
@@ -377,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)
@@ -513,14 +525,14 @@ module Google
             #   # Call the update_recognizer method.
             #   result = client.update_recognizer request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def update_recognizer request, options = nil
@@ -617,14 +629,14 @@ module Google
             #   # Call the delete_recognizer method.
             #   result = client.delete_recognizer request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def delete_recognizer request, options = nil
@@ -718,14 +730,14 @@ module Google
             #   # Call the undelete_recognizer method.
             #   result = client.undelete_recognizer request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def undelete_recognizer request, options = nil
@@ -916,22 +928,22 @@ module Google
             #   # Create a client object. The client can be reused for multiple calls.
             #   client = Google::Cloud::Speech::V2::Speech::Client.new
             #
-            #   # Create an input stream
+            #   # Create an input stream.
             #   input = Gapic::StreamInput.new
             #
             #   # Call the streaming_recognize method to start streaming.
             #   output = client.streaming_recognize input
             #
-            #   # Send requests on the stream. For each request, pass in keyword
-            #   # arguments to set fields. Be sure to close the stream when done.
+            #   # Send requests on the stream. For each request object, set fields by
+            #   # passing keyword arguments. Be sure to close the stream when done.
             #   input << Google::Cloud::Speech::V2::StreamingRecognizeRequest.new
             #   input << Google::Cloud::Speech::V2::StreamingRecognizeRequest.new
             #   input.close
             #
-            #   # Handle streamed responses. These may be interleaved with inputs.
-            #   # Each response is of type ::Google::Cloud::Speech::V2::StreamingRecognizeResponse.
-            #   output.each do |response|
-            #     p response
+            #   # The returned object is a streamed enumerable yielding elements of type
+            #   # ::Google::Cloud::Speech::V2::StreamingRecognizeResponse
+            #   output.each do |current_response|
+            #     p current_response
             #   end
             #
             def streaming_recognize request, options = nil
@@ -987,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).
@@ -1017,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]
@@ -1038,14 +1053,14 @@ module Google
             #   # Call the batch_recognize method.
             #   result = client.batch_recognize request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def batch_recognize request, options = nil
@@ -1320,14 +1335,14 @@ module Google
             #   # Call the create_custom_class method.
             #   result = client.create_custom_class request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def create_custom_class request, options = nil
@@ -1429,13 +1444,11 @@ module Google
             #   # Call the list_custom_classes method.
             #   result = client.list_custom_classes request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Speech::V2::CustomClass.
-            #     p response
+            #     p item
             #   end
             #
             def list_custom_classes request, options = nil
@@ -1618,14 +1631,14 @@ module Google
             #   # Call the update_custom_class method.
             #   result = client.update_custom_class request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def update_custom_class request, options = nil
@@ -1723,14 +1736,14 @@ module Google
             #   # Call the delete_custom_class method.
             #   result = client.delete_custom_class request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def delete_custom_class request, options = nil
@@ -1825,14 +1838,14 @@ module Google
             #   # Call the undelete_custom_class method.
             #   result = client.undelete_custom_class request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def undelete_custom_class request, options = nil
@@ -1930,14 +1943,14 @@ module Google
             #   # Call the create_phrase_set method.
             #   result = client.create_phrase_set request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def create_phrase_set request, options = nil
@@ -2038,13 +2051,11 @@ module Google
             #   # Call the list_phrase_sets method.
             #   result = client.list_phrase_sets request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Speech::V2::PhraseSet.
-            #     p response
+            #     p item
             #   end
             #
             def list_phrase_sets request, options = nil
@@ -2226,14 +2237,14 @@ module Google
             #   # Call the update_phrase_set method.
             #   result = client.update_phrase_set request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def update_phrase_set request, options = nil
@@ -2330,14 +2341,14 @@ module Google
             #   # Call the delete_phrase_set method.
             #   result = client.delete_phrase_set request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def delete_phrase_set request, options = nil
@@ -2431,14 +2442,14 @@ module Google
             #   # Call the undelete_phrase_set method.
             #   result = client.undelete_phrase_set request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def undelete_phrase_set request, options = nil
@@ -2521,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