google-cloud-speech-v1p1beta1 0.10.1 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20f63757c8cfc052d0d74875c69ce42acf77cec45a59c35f332dad3625fa5c24
-  data.tar.gz: 79923a57f03488321d859a7d0b132b51c1d38948aade2ab4ad6f94e6c262b772
+  metadata.gz: 180beb388724116bb984b0030921210424a17c90607f91439f24b4ee047a8a78
+  data.tar.gz: 9c067e63b3a6d9a3640212c19a419c43c5cfc683e7b8c0983ac6ec2d8dadf56d
 SHA512:
-  metadata.gz: bde0d60815c6a4cf07e3b42796fddc514fde3dace61b49ba4c48a0ee34d7fe79d748eab0e80c265e07aa7614a887c2e0d5519cdae186f71a8fe0f4dcdf8db857
-  data.tar.gz: 23e2cb90679b48e9cdacd61508ff9cee7089bec5760c90e8c9c503175ff591b385340236d7d2e74b61f113f2401e9feb91911e459940e7ebe3d19993d85a6430
+  metadata.gz: 76e27e18f6564f226bca8bc078be445d7ec8148f3bf042f7a175163209b14d87a3eebefee3b18bce5b75a0a27b32ea36abae976b95d4a4aa90e967ee2e345ccb
+  data.tar.gz: f9433ddd977051cdbbe81ecd0ce02b6d38d49dc4d827d7687da1ffc1d976ba8f429e6274acf98a1b3ef47ed47a674d48eba07f63129637e2279459e8b047cf50

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Cloud Speech-to-Text V1p1beta1 API
+--title="Cloud Speech-to-Text V1p1beta1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

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

@@ -165,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.
@@ -185,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?
 
@@ -202,9 +223,11 @@ 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
 
@@ -243,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]
@@ -255,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?
 
@@ -272,9 +316,11 @@ 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
 
@@ -313,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
@@ -336,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?
 
@@ -353,9 +426,11 @@ 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
 
@@ -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,9 +525,11 @@ 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
 
@@ -469,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]
@@ -481,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?
 
@@ -498,9 +612,11 @@ 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
 
@@ -539,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.
@@ -559,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?
 
@@ -576,9 +713,11 @@ 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
 
@@ -617,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]
@@ -629,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?
 
@@ -646,9 +800,11 @@ 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
 
@@ -687,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
@@ -710,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?
 
@@ -727,9 +910,11 @@ 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
 
@@ -773,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.
             #
@@ -785,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?
 
@@ -802,9 +1009,11 @@ 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
 
@@ -843,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]
@@ -855,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?
 
@@ -872,9 +1102,11 @@ 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
 

data/lib/google/cloud/speech/v1p1beta1/cloud_speech_adaptation_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/speech/v1p1beta1/cloud_speech_adaptation.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -10,6 +8,8 @@ require 'google/api/resource_pb'
 require 'google/cloud/speech/v1p1beta1/resource_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/speech/v1p1beta1/cloud_speech_adaptation.proto", :syntax => :proto3) do
     add_message "google.cloud.speech.v1p1beta1.CreatePhraseSetRequest" do

data/lib/google/cloud/speech/v1p1beta1/cloud_speech_adaptation_services_pb.rb

@@ -27,7 +27,7 @@ module Google
           # Service that implements Google Cloud Speech Adaptation API.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode