google-apis-dialogflow_v2beta1 0.17.0 → 0.21.0

data/lib/google/apis/dialogflow_v2beta1/service.rb

@@ -151,7 +151,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified agent to a ZIP file.
+        # Exports the specified agent to a ZIP file. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportAgentResponse
         # @param [String] parent
         #   Required. The project that the agent to export is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -260,9 +265,16 @@ module Google
         # the import, the imported draft agent will be trained automatically (unless
         # disabled in agent settings). However, once the import is done, training may
         # not be completed yet. Please call TrainAgent and wait for the operation it
-        # returns in order to train explicitly. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # returns in order to train explicitly. This method is a [long-running operation]
+        # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: An empty [Struct message](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
+        # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        # empty) The operation only tracks when importing is complete, not when it is
+        # done training. Note: You should always train an agent prior to sending it
+        # queries. See the [training documentation](https://cloud.google.com/dialogflow/
+        # es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to import is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -301,9 +313,16 @@ module Google
         # are deleted. After the restore, the restored draft agent will be trained
         # automatically (unless disabled in agent settings). However, once the restore
         # is done, training may not be completed yet. Please call TrainAgent and wait
-        # for the operation it returns in order to train explicitly. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # for the operation it returns in order to train explicitly. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) The operation only tracks when restoring is
+        # complete, not when it is done training. Note: You should always train an agent
+        # prior to sending it queries. See the [training documentation](https://cloud.
+        # google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to restore is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -379,9 +398,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Trains the specified agent. Note: You should always train an agent prior to
-        # sending it queries. See the [training documentation](https://cloud.google.com/
-        # dialogflow/es/docs/training).
+        # Trains the specified agent. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
+        # `Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: You should always train an agent prior to sending it queries. See the [
+        # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to train is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -454,9 +478,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entity types in the specified agent. Note: You should always train an
-        # agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entity types in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Supported
         #   formats: - `projects//agent`, - `projects//locations//agent`.
@@ -490,9 +520,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple entity types in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple entity types in the specified agent. This method is a
+        # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create entity types in. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -729,9 +764,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates multiple new entities in the specified entity type. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Creates multiple new entities in the specified entity type. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to create entities in. Supported formats:
         #   - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
@@ -765,9 +806,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entities in the specified entity type. Note: You should always train
-        # an agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entities in the specified entity type. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to delete entries for. Supported formats:
         #   - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
@@ -805,7 +852,12 @@ module Google
         # does not affect entities in the entity type that aren't explicitly specified
         # in the request. Note: You should always train an agent prior to sending it
         # queries. See the [training documentation](https://cloud.google.com/dialogflow/
-        # es/docs/training).
+        # es/docs/training). This method is a [long-running operation](https://cloud.
+        # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
         # @param [String] parent
         #   Required. The name of the entity type to update or create entities in.
         #   Supported formats: - `projects//agent/entityTypes/` - `projects//locations//
@@ -1611,9 +1663,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes intents in the specified agent. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # Deletes intents in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -1647,9 +1705,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple intents in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple intents in the specified agent. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
+        # sending it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create intents in. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -2098,8 +2161,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Note: The `projects.agent.knowledgeBases.documents`
-        # resource is deprecated; only use `projects.knowledgeBases.documents`.
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
+        # knowledgeBases.documents` resource is deprecated; only use `projects.
+        # knowledgeBases.documents`.
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -2137,9 +2204,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
+        # only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -2254,9 +2325,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -2301,9 +2375,12 @@ module Google
         # effects because of internal implementation changes. Note: If the document
         # source is Google Cloud Storage URI, its metadata will be replaced with the
         # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
-        # field is set to true in the request. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # field is set to true in the request. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`
@@ -4112,8 +4189,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Note: The `projects.agent.knowledgeBases.documents`
-        # resource is deprecated; only use `projects.knowledgeBases.documents`.
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
+        # knowledgeBases.documents` resource is deprecated; only use `projects.
+        # knowledgeBases.documents`.
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -4151,9 +4232,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
+        # only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -4219,7 +4304,10 @@ module Google
         
         # Create documents by importing data from external sources. Dialogflow supports
         # up to 350 documents in each request. If you try to import more, Dialogflow
-        # will return an error.
+        # will return an error. This method is a [long-running operation](https://cloud.
+        # google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: ImportDocumentsResponse
         # @param [String] parent
         #   Required. The knowledge base to import documents into. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -4304,9 +4392,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -4351,9 +4442,12 @@ module Google
         # effects because of internal implementation changes. Note: If the document
         # source is Google Cloud Storage URI, its metadata will be replaced with the
         # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
-        # field is set to true in the request. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # field is set to true in the request. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`
@@ -4418,6 +4512,36 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets information about a location.
+        # @param [String] name
+        #   Resource name for the location.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudLocationLocation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudLocationLocation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2beta1/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudLocationLocation::Representation
+          command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudLocationLocation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves the specified agent.
         # @param [String] parent
         #   Required. The project that the agent to fetch is associated with. Format: `
@@ -4449,6 +4573,49 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists information about the supported locations for this service.
+        # @param [String] name
+        #   The resource that owns the locations collection, if applicable.
+        # @param [String] filter
+        #   A filter to narrow down results to a preferred subset. The filtering language
+        #   accepts strings like "displayName=tokyo", and is documented in more detail in [
+        #   AIP-160](https://google.aip.dev/160).
+        # @param [Fixnum] page_size
+        #   The maximum number of results to return. If not set, the service selects a
+        #   default.
+        # @param [String] page_token
+        #   A page token received from the `next_page_token` field in the response. Send
+        #   that page token to receive the subsequent page.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudLocationListLocationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudLocationListLocationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2beta1/{+name}/locations', options)
+          command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudLocationListLocationsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudLocationListLocationsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates/updates the specified agent. Note: You should always train an agent
         # prior to sending it queries. See the [training documentation](https://cloud.
         # google.com/dialogflow/es/docs/training).
@@ -4488,7 +4655,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified agent to a ZIP file.
+        # Exports the specified agent to a ZIP file. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportAgentResponse
         # @param [String] parent
         #   Required. The project that the agent to export is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -4597,9 +4769,16 @@ module Google
         # the import, the imported draft agent will be trained automatically (unless
         # disabled in agent settings). However, once the import is done, training may
         # not be completed yet. Please call TrainAgent and wait for the operation it
-        # returns in order to train explicitly. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # returns in order to train explicitly. This method is a [long-running operation]
+        # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: An empty [Struct message](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
+        # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        # empty) The operation only tracks when importing is complete, not when it is
+        # done training. Note: You should always train an agent prior to sending it
+        # queries. See the [training documentation](https://cloud.google.com/dialogflow/
+        # es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to import is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -4638,9 +4817,16 @@ module Google
         # are deleted. After the restore, the restored draft agent will be trained
         # automatically (unless disabled in agent settings). However, once the restore
         # is done, training may not be completed yet. Please call TrainAgent and wait
-        # for the operation it returns in order to train explicitly. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # for the operation it returns in order to train explicitly. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) The operation only tracks when restoring is
+        # complete, not when it is done training. Note: You should always train an agent
+        # prior to sending it queries. See the [training documentation](https://cloud.
+        # google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to restore is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -4716,9 +4902,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Trains the specified agent. Note: You should always train an agent prior to
-        # sending it queries. See the [training documentation](https://cloud.google.com/
-        # dialogflow/es/docs/training).
+        # Trains the specified agent. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
+        # `Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: You should always train an agent prior to sending it queries. See the [
+        # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to train is associated with. Format: `
         #   projects/` or `projects//locations/`.
@@ -4791,9 +4982,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entity types in the specified agent. Note: You should always train an
-        # agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entity types in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Supported
         #   formats: - `projects//agent`, - `projects//locations//agent`.
@@ -4827,9 +5024,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple entity types in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple entity types in the specified agent. This method is a
+        # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create entity types in. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -5066,9 +5268,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates multiple new entities in the specified entity type. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Creates multiple new entities in the specified entity type. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to create entities in. Supported formats:
         #   - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
@@ -5102,9 +5310,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entities in the specified entity type. Note: You should always train
-        # an agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entities in the specified entity type. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to delete entries for. Supported formats:
         #   - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
@@ -5142,7 +5356,12 @@ module Google
         # does not affect entities in the entity type that aren't explicitly specified
         # in the request. Note: You should always train an agent prior to sending it
         # queries. See the [training documentation](https://cloud.google.com/dialogflow/
-        # es/docs/training).
+        # es/docs/training). This method is a [long-running operation](https://cloud.
+        # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
         # @param [String] parent
         #   Required. The name of the entity type to update or create entities in.
         #   Supported formats: - `projects//agent/entityTypes/` - `projects//locations//
@@ -5948,9 +6167,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes intents in the specified agent. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # Deletes intents in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -5984,9 +6209,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple intents in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple intents in the specified agent. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
+        # sending it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create intents in. Supported
         #   formats: - `projects//agent` - `projects//locations//agent`
@@ -7919,8 +8149,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Note: The `projects.agent.knowledgeBases.documents`
-        # resource is deprecated; only use `projects.knowledgeBases.documents`.
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
+        # knowledgeBases.documents` resource is deprecated; only use `projects.
+        # knowledgeBases.documents`.
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -7958,9 +8192,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
+        # only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -8026,7 +8264,10 @@ module Google
         
         # Create documents by importing data from external sources. Dialogflow supports
         # up to 350 documents in each request. If you try to import more, Dialogflow
-        # will return an error.
+        # will return an error. This method is a [long-running operation](https://cloud.
+        # google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: ImportDocumentsResponse
         # @param [String] parent
         #   Required. The knowledge base to import documents into. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -8111,9 +8352,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -8158,9 +8402,12 @@ module Google
         # effects because of internal implementation changes. Note: If the document
         # source is Google Cloud Storage URI, its metadata will be replaced with the
         # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
-        # field is set to true in the request. Note: The `projects.agent.knowledgeBases.
-        # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
-        # .
+        # field is set to true in the request. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
+        # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
+        # projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`