google-cloud-speech-v1p1beta1 0.10.0 → 0.12.0

data/lib/google/cloud/speech/v1p1beta1/adaptation/client.rb

@@ -41,13 +41,12 @@ module Google
             # See {::Google::Cloud::Speech::V1p1beta1::Adaptation::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all Adaptation clients:
-            #
-            #     ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all Adaptation clients
+            #   ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -94,19 +93,15 @@ module Google
             ##
             # Create a new Adaptation client object.
             #
-            # ## Examples
-            #
-            # To create a new Adaptation client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
             #
-            # To create a new Adaptation client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Adaptation client.
             # @yieldparam config [Client::Configuration]
@@ -126,10 +121,9 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -171,9 +165,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource where this phrase set will be created.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets
+            #     Required. The parent resource where this phrase set will be created. Format:
+            #
+            #     `projects/{project}/locations/{location}/phraseSets`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param phrase_set_id [::String]
             #     Required. The ID to use for the phrase set, which will become the final
             #     component of the phrase set's resource name.
@@ -191,6 +191,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::CreatePhraseSetRequest.new
+            #
+            #   # Call the create_phrase_set method.
+            #   result = client.create_phrase_set request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::PhraseSet.
+            #   p result
+            #
             def create_phrase_set request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -208,16 +223,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_phrase_set.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_phrase_set.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :create_phrase_set, request, options: options do |response, operation|
@@ -247,9 +266,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the phrase set to retrieve.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+            #     Required. The name of the phrase set to retrieve. Format:
+            #
+            #     `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Speech::V1p1beta1::PhraseSet]
@@ -259,6 +284,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::GetPhraseSetRequest.new
+            #
+            #   # Call the get_phrase_set method.
+            #   result = client.get_phrase_set request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::PhraseSet.
+            #   p result
+            #
             def get_phrase_set request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -276,16 +316,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_phrase_set.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_phrase_set.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :get_phrase_set, request, options: options do |response, operation|
@@ -315,9 +359,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent, which owns this collection of phrase set.
-            #     Format:
-            #     projects/\\{project}/locations/\\{location}
+            #     Required. The parent, which owns this collection of phrase set. Format:
+            #
+            #     `projects/{project}/locations/{location}`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param page_size [::Integer]
             #     The maximum number of phrase sets to return. The service may return
             #     fewer than this value. If unspecified, at most 50 phrase sets will be
@@ -338,6 +388,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::ListPhraseSetRequest.new
+            #
+            #   # Call the list_phrase_set method.
+            #   result = client.list_phrase_set 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|
+            #     # Each element is of type ::Google::Cloud::Speech::V1p1beta1::PhraseSet.
+            #     p response
+            #   end
+            #
             def list_phrase_set request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -355,16 +426,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_phrase_set.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_phrase_set.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :list_phrase_set, request, options: options do |response, operation|
@@ -399,7 +474,14 @@ module Google
             #
             #     The phrase set's `name` field is used to identify the set to be
             #     updated. Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+            #
+            #     `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     The list of fields to be updated.
             #
@@ -411,6 +493,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::UpdatePhraseSetRequest.new
+            #
+            #   # Call the update_phrase_set method.
+            #   result = client.update_phrase_set request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::PhraseSet.
+            #   p result
+            #
             def update_phrase_set request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -428,16 +525,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "phrase_set.name" => request.phrase_set.name
-              }
+              header_params = {}
+              if request.phrase_set&.name
+                header_params["phrase_set.name"] = request.phrase_set.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_phrase_set.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_phrase_set.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :update_phrase_set, request, options: options do |response, operation|
@@ -467,9 +568,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the phrase set to delete.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+            #     Required. The name of the phrase set to delete. Format:
+            #
+            #     `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -479,6 +580,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::DeletePhraseSetRequest.new
+            #
+            #   # Call the delete_phrase_set method.
+            #   result = client.delete_phrase_set request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_phrase_set request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -496,16 +612,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_phrase_set.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_phrase_set.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :delete_phrase_set, request, options: options do |response, operation|
@@ -535,9 +655,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource where this custom class will be created.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses
+            #     Required. The parent resource where this custom class will be created. Format:
+            #
+            #     `projects/{project}/locations/{location}/customClasses`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param custom_class_id [::String]
             #     Required. The ID to use for the custom class, which will become the final
             #     component of the custom class' resource name.
@@ -555,6 +681,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::CreateCustomClassRequest.new
+            #
+            #   # Call the create_custom_class method.
+            #   result = client.create_custom_class request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::CustomClass.
+            #   p result
+            #
             def create_custom_class request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -572,16 +713,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_custom_class.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_custom_class.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :create_custom_class, request, options: options do |response, operation|
@@ -611,9 +756,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the custom class to retrieve.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+            #     Required. The name of the custom class to retrieve. Format:
+            #
+            #     `projects/{project}/locations/{location}/customClasses/{custom_class}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Speech::V1p1beta1::CustomClass]
@@ -623,6 +768,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::GetCustomClassRequest.new
+            #
+            #   # Call the get_custom_class method.
+            #   result = client.get_custom_class request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::CustomClass.
+            #   p result
+            #
             def get_custom_class request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -640,16 +800,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_custom_class.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_custom_class.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :get_custom_class, request, options: options do |response, operation|
@@ -679,9 +843,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent, which owns this collection of custom classes.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses
+            #     Required. The parent, which owns this collection of custom classes. Format:
+            #
+            #     `projects/{project}/locations/{location}/customClasses`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param page_size [::Integer]
             #     The maximum number of custom classes to return. The service may return
             #     fewer than this value. If unspecified, at most 50 custom classes will be
@@ -702,6 +872,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::ListCustomClassesRequest.new
+            #
+            #   # 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|
+            #     # Each element is of type ::Google::Cloud::Speech::V1p1beta1::CustomClass.
+            #     p response
+            #   end
+            #
             def list_custom_classes request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -719,16 +910,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_custom_classes.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_custom_classes.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :list_custom_classes, request, options: options do |response, operation|
@@ -763,7 +958,14 @@ module Google
             #
             #     The custom class's `name` field is used to identify the custom class to be
             #     updated. Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+            #
+            #     `projects/{project}/locations/{location}/customClasses/{custom_class}`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     The list of fields to be updated.
             #
@@ -775,6 +977,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::UpdateCustomClassRequest.new
+            #
+            #   # Call the update_custom_class method.
+            #   result = client.update_custom_class request
+            #
+            #   # The returned object is of type Google::Cloud::Speech::V1p1beta1::CustomClass.
+            #   p result
+            #
             def update_custom_class request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -792,16 +1009,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "custom_class.name" => request.custom_class.name
-              }
+              header_params = {}
+              if request.custom_class&.name
+                header_params["custom_class.name"] = request.custom_class.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_custom_class.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_custom_class.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :update_custom_class, request, options: options do |response, operation|
@@ -831,9 +1052,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the custom class to delete.
-            #     Format:
-            #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+            #     Required. The name of the custom class to delete. Format:
+            #
+            #     `projects/{project}/locations/{location}/customClasses/{custom_class}`
+            #
+            #     Speech-to-Text supports three locations: `global`, `us` (US North America),
+            #     and `eu` (Europe). If you are calling the `speech.googleapis.com`
+            #     endpoint, use the `global` location. To specify a region, use a
+            #     [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
+            #     `eu` location value.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -843,6 +1070,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/speech/v1p1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Speech::V1p1beta1::DeleteCustomClassRequest.new
+            #
+            #   # Call the delete_custom_class method.
+            #   result = client.delete_custom_class request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_custom_class request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -860,16 +1102,20 @@ module Google
                 gapic_version: ::Google::Cloud::Speech::V1p1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_custom_class.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_custom_class.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @adaptation_stub.call_rpc :delete_custom_class, request, options: options do |response, operation|
@@ -893,22 +1139,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for create_phrase_set
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_phrase_set.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_phrase_set.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # create_phrase_set to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_phrase_set.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Speech::V1p1beta1::Adaptation::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_phrase_set.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.