google-cloud-dialogflow-v2 0.3.0 → 0.4.0

data/lib/google/cloud/dialogflow/v2/entity_types/paths.rb

@@ -24,6 +24,20 @@ module Google
         module EntityTypes
           # Path helper methods for the EntityTypes API.
           module Paths
+            ##
+            # Create a fully-qualified Agent resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/agent`
+            #
+            # @param project [String]
+            #
+            # @return [String]
+            def agent_path project:
+              "projects/#{project}/agent"
+            end
+
             ##
             # Create a fully-qualified EntityType resource string.
             #

data/lib/google/cloud/dialogflow/v2/intents.rb

@@ -16,6 +16,66 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/dialogflow/v2/intents/client"
-require "google/cloud/dialogflow/v2/intents/operations"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/dialogflow/v2/version"
+
 require "google/cloud/dialogflow/v2/intents/credentials"
+require "google/cloud/dialogflow/v2/intents/paths"
+require "google/cloud/dialogflow/v2/intents/operations"
+require "google/cloud/dialogflow/v2/intents/client"
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        ##
+        # An intent represents a mapping between input from a user and an action to
+        # be taken by your application. When you pass user input to the
+        # {Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
+        # {Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method, the
+        # Dialogflow API analyzes the input and searches
+        # for a matching intent. If no match is found, the Dialogflow API returns a
+        # fallback intent (`is_fallback` = true).
+        #
+        # You can provide additional information for the Dialogflow API to use to
+        # match user input to an intent by adding the following to your intent.
+        #
+        # *   **Contexts** - provide additional context for intent analysis. For
+        #     example, if an intent is related to an object in your application that
+        #     plays music, you can provide a context to determine when to match the
+        #     intent if the user input is "turn it off". You can include a context
+        #     that matches the intent when there is previous user input of
+        #     "play music", and not when there is previous user input of
+        #     "turn on the light".
+        #
+        # *   **Events** - allow for matching an intent by using an event name
+        #     instead of user input. Your application can provide an event name and
+        #     related parameters to the Dialogflow API to match an intent. For
+        #     example, when your application starts, you can send a welcome event
+        #     with a user name parameter to the Dialogflow API to match an intent with
+        #     a personalized welcome message for the user.
+        #
+        # *   **Training phrases** - provide examples of user input to train the
+        #     Dialogflow API agent to better match intents.
+        #
+        # For more information about intents, see the
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/dialogflow/v2/intents"
+        #     client = Google::Cloud::Dialogflow::V2::Intents::Client.new
+        #
+        module Intents
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "intents", "helpers.rb"
+require "google/cloud/dialogflow/v2/intents/helpers" if ::File.file? helper_path

data/lib/google/cloud/dialogflow/v2/intents/client.rb

@@ -16,16 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/dialogflow/v2/version"
 require "google/cloud/dialogflow/v2/intent_pb"
-require "google/cloud/dialogflow/v2/intents/credentials"
-require "google/cloud/dialogflow/v2/intents/paths"
-require "google/cloud/dialogflow/v2/intents/operations"
 
 module Google
   module Cloud
@@ -228,12 +220,20 @@ module Google
             # Returns the list of all intents in the specified agent.
             #
             # @overload list_intents(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::ListIntentsRequest | Hash]
-            #     Returns the list of all intents in the specified agent.
+            #   Pass arguments to `list_intents` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::ListIntentsRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::ListIntentsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_intents(parent: nil, language_code: nil, intent_view: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_intents` 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).
+            #
             #   @param parent [String]
             #     Required. The agent to list all intents from.
             #     Format: `projects/<Project ID>/agent`.
@@ -251,7 +251,6 @@ module Google
             #   @param page_token [String]
             #     Optional. The next_page_token value returned from a previous list request.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dialogflow::V2::Intent>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -302,12 +301,20 @@ module Google
             # Retrieves the specified intent.
             #
             # @overload get_intent(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::GetIntentRequest | Hash]
-            #     Retrieves the specified intent.
+            #   Pass arguments to `get_intent` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::GetIntentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::GetIntentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_intent(name: nil, language_code: nil, intent_view: nil)
+            #   Pass arguments to `get_intent` 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).
+            #
             #   @param name [String]
             #     Required. The name of the intent.
             #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
@@ -320,7 +327,6 @@ module Google
             #   @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
             #     Optional. The resource view to apply to the returned intent.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::Intent]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -370,16 +376,24 @@ module Google
             # Creates an intent in the specified agent.
             #
             # @overload create_intent(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::CreateIntentRequest | Hash]
-            #     Creates an intent in the specified agent.
+            #   Pass arguments to `create_intent` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::CreateIntentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::CreateIntentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload create_intent(parent: nil, intent: nil, language_code: nil, intent_view: nil)
+            #   Pass arguments to `create_intent` 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).
+            #
             #   @param parent [String]
             #     Required. The agent to create a intent for.
             #     Format: `projects/<Project ID>/agent`.
-            #   @param intent [Google::Cloud::Dialogflow::V2::Intent | Hash]
+            #   @param intent [Google::Cloud::Dialogflow::V2::Intent, Hash]
             #     Required. The intent to create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -390,7 +404,6 @@ module Google
             #   @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
             #     Optional. The resource view to apply to the returned intent.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::Intent]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -440,13 +453,21 @@ module Google
             # Updates the specified intent.
             #
             # @overload update_intent(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::UpdateIntentRequest | Hash]
-            #     Updates the specified intent.
+            #   Pass arguments to `update_intent` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::UpdateIntentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::UpdateIntentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload update_intent(intent: nil, language_code: nil, update_mask: nil, intent_view: nil)
-            #   @param intent [Google::Cloud::Dialogflow::V2::Intent | Hash]
+            #   Pass arguments to `update_intent` 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).
+            #
+            #   @param intent [Google::Cloud::Dialogflow::V2::Intent, Hash]
             #     Required. The intent to update.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -454,12 +475,11 @@ module Google
             #     For more information, see
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
-            #   @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   @param update_mask [Google::Protobuf::FieldMask, Hash]
             #     Optional. The mask to control which fields get updated.
             #   @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
             #     Optional. The resource view to apply to the returned intent.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::Intent]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -509,18 +529,25 @@ module Google
             # Deletes the specified intent and its direct or indirect followup intents.
             #
             # @overload delete_intent(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::DeleteIntentRequest | Hash]
-            #     Deletes the specified intent and its direct or indirect followup intents.
+            #   Pass arguments to `delete_intent` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::DeleteIntentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::DeleteIntentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_intent(name: nil)
+            #   Pass arguments to `delete_intent` 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).
+            #
             #   @param name [String]
             #     Required. The name of the intent to delete. If this intent has direct or
             #     indirect followup intents, we also delete them.
             #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -572,14 +599,20 @@ module Google
             # Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}>
             #
             # @overload batch_update_intents(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest | Hash]
-            #     Updates/Creates multiple intents in the specified agent.
+            #   Pass arguments to `batch_update_intents` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload batch_update_intents(parent: nil, intent_batch_uri: nil, intent_batch_inline: nil, language_code: nil, update_mask: nil, intent_view: nil)
+            #   Pass arguments to `batch_update_intents` 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).
+            #
             #   @param parent [String]
             #     Required. The name of the agent to update or create intents in.
             #     Format: `projects/<Project ID>/agent`.
@@ -587,7 +620,7 @@ module Google
             #     The URI to a Google Cloud Storage file containing intents to update or
             #     create. The file format can either be a serialized proto (of IntentBatch
             #     type) or JSON object. Note: The URI must start with "gs://".
-            #   @param intent_batch_inline [Google::Cloud::Dialogflow::V2::IntentBatch | Hash]
+            #   @param intent_batch_inline [Google::Cloud::Dialogflow::V2::IntentBatch, Hash]
             #     The collection of intents to update or create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -595,12 +628,11 @@ module Google
             #     For more information, see
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
-            #   @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   @param update_mask [Google::Protobuf::FieldMask, Hash]
             #     Optional. The mask to control which fields get updated.
             #   @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
             #     Optional. The resource view to apply to the returned intent.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -653,22 +685,27 @@ module Google
             # Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
             #
             # @overload batch_delete_intents(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest | Hash]
-            #     Deletes intents in the specified agent.
+            #   Pass arguments to `batch_delete_intents` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload batch_delete_intents(parent: nil, intents: nil)
+            #   Pass arguments to `batch_delete_intents` 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).
+            #
             #   @param parent [String]
             #     Required. The name of the agent to delete all entities types for. Format:
             #     `projects/<Project ID>/agent`.
-            #   @param intents [Array<Google::Cloud::Dialogflow::V2::Intent | Hash>]
+            #   @param intents [Array<Google::Cloud::Dialogflow::V2::Intent, Hash>]
             #     Required. The collection of intents to delete. Only intent `name` must be
             #     filled in.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -910,13 +947,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/dialogflow/v2/intents/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions

data/lib/google/cloud/dialogflow/v2/intents/operations.rb

@@ -16,11 +16,7 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
 require "gapic/operation"
-
-require "google/cloud/dialogflow/v2/version"
-require "google/cloud/dialogflow/v2/intents/client"
 require "google/longrunning/operations_pb"
 
 module Google
@@ -109,16 +105,20 @@ module Google
             # to use different resource name schemes, such as `users/*/operations`.
             #
             # @overload list_operations(request, options = nil)
-            #   @param request [Google::Longrunning::ListOperationsRequest | Hash]
-            #     Lists operations that match the specified filter in the request. If the
-            #     server doesn't support this method, it returns `UNIMPLEMENTED`.
+            #   Pass arguments to `list_operations` via a request object, either of type
+            #   {Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
             #
-            #     NOTE: the `name` binding below allows API services to override the binding
-            #     to use different resource name schemes, such as `users/*/operations`.
+            #   @param request [Google::Longrunning::ListOperationsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_operations` 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).
+            #
             #   @param name [String]
             #     The name of the operation collection.
             #   @param filter [String]
@@ -128,7 +128,6 @@ module Google
             #   @param page_token [String]
             #     The standard list page token.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Gapic::Operation>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -182,18 +181,23 @@ module Google
             # service.
             #
             # @overload get_operation(request, options = nil)
-            #   @param request [Google::Longrunning::GetOperationRequest | Hash]
-            #     Gets the latest state of a long-running operation.  Clients can use this
-            #     method to poll the operation result at intervals as recommended by the API
-            #     service.
+            #   Pass arguments to `get_operation` via a request object, either of type
+            #   {Google::Longrunning::GetOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::GetOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_operation(name: nil)
+            #   Pass arguments to `get_operation` 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).
+            #
             #   @param name [String]
             #     The name of the operation resource.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -247,19 +251,23 @@ module Google
             # `google.rpc.Code.UNIMPLEMENTED`.
             #
             # @overload delete_operation(request, options = nil)
-            #   @param request [Google::Longrunning::DeleteOperationRequest | Hash]
-            #     Deletes a long-running operation. This method indicates that the client is
-            #     no longer interested in the operation result. It does not cancel the
-            #     operation. If the server doesn't support this method, it returns
-            #     `google.rpc.Code.UNIMPLEMENTED`.
+            #   Pass arguments to `delete_operation` via a request object, either of type
+            #   {Google::Longrunning::DeleteOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::DeleteOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_operation(name: nil)
+            #   Pass arguments to `delete_operation` 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).
+            #
             #   @param name [String]
             #     The name of the operation resource to be deleted.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -318,25 +326,23 @@ module Google
             # corresponding to `Code.CANCELLED`.
             #
             # @overload cancel_operation(request, options = nil)
-            #   @param request [Google::Longrunning::CancelOperationRequest | Hash]
-            #     Starts asynchronous cancellation on a long-running operation.  The server
-            #     makes a best effort to cancel the operation, but success is not
-            #     guaranteed.  If the server doesn't support this method, it returns
-            #     `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
-            #     Operations.GetOperation or
-            #     other methods to check whether the cancellation succeeded or whether the
-            #     operation completed despite cancellation. On successful cancellation,
-            #     the operation is not deleted; instead, it becomes an operation with
-            #     an {Google::Longrunning::Operation#error Operation.error} value with a {Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            #     corresponding to `Code.CANCELLED`.
+            #   Pass arguments to `cancel_operation` via a request object, either of type
+            #   {Google::Longrunning::CancelOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::CancelOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload cancel_operation(name: nil)
+            #   Pass arguments to `cancel_operation` 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).
+            #
             #   @param name [String]
             #     The name of the operation resource to be cancelled.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]