google-cloud-dialogflow-v2 0.3.0 → 0.4.0

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

@@ -16,6 +16,62 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/dialogflow/v2/entity_types/client"
-require "google/cloud/dialogflow/v2/entity_types/operations"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/dialogflow/v2/version"
+
 require "google/cloud/dialogflow/v2/entity_types/credentials"
+require "google/cloud/dialogflow/v2/entity_types/paths"
+require "google/cloud/dialogflow/v2/entity_types/operations"
+require "google/cloud/dialogflow/v2/entity_types/client"
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        ##
+        # Entities are extracted from user input and represent parameters that are
+        # meaningful to your application. For example, a date range, a proper name
+        # such as a geographic location or landmark, and so on. Entities represent
+        # actionable data for your application.
+        #
+        # When you define an entity, you can also include synonyms that all map to
+        # that entity. For example, "soft drink", "soda", "pop", and so on.
+        #
+        # There are three types of entities:
+        #
+        # *   **System** - entities that are defined by the Dialogflow API for common
+        #     data types such as date, time, currency, and so on. A system entity is
+        #     represented by the `EntityType` type.
+        #
+        # *   **Custom** - entities that are defined by you that represent
+        #     actionable data that is meaningful to your application. For example,
+        #     you could define a `pizza.sauce` entity for red or white pizza sauce,
+        #     a `pizza.cheese` entity for the different types of cheese on a pizza,
+        #     a `pizza.topping` entity for different toppings, and so on. A custom
+        #     entity is represented by the `EntityType` type.
+        #
+        # *   **User** - entities that are built for an individual user such as
+        #     favorites, preferences, playlists, and so on. A user entity is
+        #     represented by the {Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityType} type.
+        #
+        # For more information about entity types, see the
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/dialogflow/v2/entity_types"
+        #     client = Google::Cloud::Dialogflow::V2::EntityTypes::Client.new
+        #
+        module EntityTypes
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "entity_types", "helpers.rb"
+require "google/cloud/dialogflow/v2/entity_types/helpers" if ::File.file? helper_path

data/lib/google/cloud/dialogflow/v2/entity_types/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/entity_type_pb"
-require "google/cloud/dialogflow/v2/entity_types/credentials"
-require "google/cloud/dialogflow/v2/entity_types/paths"
-require "google/cloud/dialogflow/v2/entity_types/operations"
 
 module Google
   module Cloud
@@ -236,12 +228,20 @@ module Google
             # Returns the list of all entity types in the specified agent.
             #
             # @overload list_entity_types(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::ListEntityTypesRequest | Hash]
-            #     Returns the list of all entity types in the specified agent.
+            #   Pass arguments to `list_entity_types` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::ListEntityTypesRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::ListEntityTypesRequest, 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_entity_types(parent: nil, language_code: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_entity_types` 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 entity types from.
             #     Format: `projects/<Project ID>/agent`.
@@ -257,7 +257,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::EntityType>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -308,12 +307,20 @@ module Google
             # Retrieves the specified entity type.
             #
             # @overload get_entity_type(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::GetEntityTypeRequest | Hash]
-            #     Retrieves the specified entity type.
+            #   Pass arguments to `get_entity_type` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::GetEntityTypeRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::GetEntityTypeRequest, 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_entity_type(name: nil, language_code: nil)
+            #   Pass arguments to `get_entity_type` 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 entity type.
             #     Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`.
@@ -324,7 +331,6 @@ module Google
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::EntityType]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -374,16 +380,24 @@ module Google
             # Creates an entity type in the specified agent.
             #
             # @overload create_entity_type(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest | Hash]
-            #     Creates an entity type in the specified agent.
+            #   Pass arguments to `create_entity_type` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest, 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_entity_type(parent: nil, entity_type: nil, language_code: nil)
+            #   Pass arguments to `create_entity_type` 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 entity type for.
             #     Format: `projects/<Project ID>/agent`.
-            #   @param entity_type [Google::Cloud::Dialogflow::V2::EntityType | Hash]
+            #   @param entity_type [Google::Cloud::Dialogflow::V2::EntityType, Hash]
             #     Required. The entity type to create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -392,7 +406,6 @@ module Google
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::EntityType]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -442,13 +455,21 @@ module Google
             # Updates the specified entity type.
             #
             # @overload update_entity_type(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest | Hash]
-            #     Updates the specified entity type.
+            #   Pass arguments to `update_entity_type` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest, 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_entity_type(entity_type: nil, language_code: nil, update_mask: nil)
-            #   @param entity_type [Google::Cloud::Dialogflow::V2::EntityType | Hash]
+            #   Pass arguments to `update_entity_type` 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 entity_type [Google::Cloud::Dialogflow::V2::EntityType, Hash]
             #     Required. The entity type to update.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -456,10 +477,9 @@ 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.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Dialogflow::V2::EntityType]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -509,17 +529,24 @@ module Google
             # Deletes the specified entity type.
             #
             # @overload delete_entity_type(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest | Hash]
-            #     Deletes the specified entity type.
+            #   Pass arguments to `delete_entity_type` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest, 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_entity_type(name: nil)
+            #   Pass arguments to `delete_entity_type` 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 entity type to delete.
             #     Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -571,14 +598,20 @@ module Google
             # Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}>
             #
             # @overload batch_update_entity_types(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesRequest | Hash]
-            #     Updates/Creates multiple entity types in the specified agent.
+            #   Pass arguments to `batch_update_entity_types` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesRequest, 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_entity_types(parent: nil, entity_type_batch_uri: nil, entity_type_batch_inline: nil, language_code: nil, update_mask: nil)
+            #   Pass arguments to `batch_update_entity_types` 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 entity types in.
             #     Format: `projects/<Project ID>/agent`.
@@ -587,7 +620,7 @@ module Google
             #     or create. The file format can either be a serialized proto (of
             #     EntityBatch type) or a JSON object. Note: The URI must start with
             #     "gs://".
-            #   @param entity_type_batch_inline [Google::Cloud::Dialogflow::V2::EntityTypeBatch | Hash]
+            #   @param entity_type_batch_inline [Google::Cloud::Dialogflow::V2::EntityTypeBatch, Hash]
             #     The collection of entity types to update or create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -595,10 +628,9 @@ 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.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -651,14 +683,20 @@ module Google
             # Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
             #
             # @overload batch_delete_entity_types(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteEntityTypesRequest | Hash]
-            #     Deletes entity types in the specified agent.
+            #   Pass arguments to `batch_delete_entity_types` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchDeleteEntityTypesRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteEntityTypesRequest, 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_entity_types(parent: nil, entity_type_names: nil)
+            #   Pass arguments to `batch_delete_entity_types` 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`.
@@ -666,7 +704,6 @@ module Google
             #     Required. The names entity types to delete. All names must point to the
             #     same agent as `parent`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -719,18 +756,24 @@ module Google
             # Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
             #
             # @overload batch_create_entities(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchCreateEntitiesRequest | Hash]
-            #     Creates multiple new entities in the specified entity type.
+            #   Pass arguments to `batch_create_entities` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchCreateEntitiesRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchCreateEntitiesRequest, 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_create_entities(parent: nil, entities: nil, language_code: nil)
+            #   Pass arguments to `batch_create_entities` 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 entity type to create entities in. Format:
             #     `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
-            #   @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity | Hash>]
+            #   @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity, Hash>]
             #     Required. The entities to create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -739,7 +782,6 @@ module Google
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -795,21 +837,24 @@ module Google
             # Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
             #
             # @overload batch_update_entities(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateEntitiesRequest | Hash]
-            #     Updates or creates multiple entities in the specified entity type. This
-            #     method does not affect entities in the entity type that aren't explicitly
-            #     specified in the request.
+            #   Pass arguments to `batch_update_entities` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchUpdateEntitiesRequest} or an equivalent Hash.
             #
-            #
-            #     Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchUpdateEntitiesRequest, 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_entities(parent: nil, entities: nil, language_code: nil, update_mask: nil)
+            #   Pass arguments to `batch_update_entities` 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 entity type to update or create entities in.
             #     Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
-            #   @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity | Hash>]
+            #   @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity, Hash>]
             #     Required. The entities to update or create.
             #   @param language_code [String]
             #     Optional. The language used to access language-specific data.
@@ -817,10 +862,9 @@ 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.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -874,15 +918,20 @@ module Google
             # Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
             #
             # @overload batch_delete_entities(request, options = nil)
-            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteEntitiesRequest | Hash]
-            #     Deletes entities in the specified entity type.
-            #
+            #   Pass arguments to `batch_delete_entities` via a request object, either of type
+            #   {Google::Cloud::Dialogflow::V2::BatchDeleteEntitiesRequest} or an equivalent Hash.
             #
-            #     Operation <response: {Google::Protobuf::Empty google.protobuf.Empty}>
+            #   @param request [Google::Cloud::Dialogflow::V2::BatchDeleteEntitiesRequest, 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_entities(parent: nil, entity_values: nil, language_code: nil)
+            #   Pass arguments to `batch_delete_entities` 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 entity type to delete entries for. Format:
             #     `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
@@ -897,7 +946,6 @@ module Google
             #     [Multilingual intent and entity
             #     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1160,13 +1208,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/entity_types/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions

data/lib/google/cloud/dialogflow/v2/entity_types/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/entity_types/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]