RubyGems - google-apis-dialogflow_v2beta1 - Versions diffs - 0.17.0 → 0.21.0 - Mend

google-apis-dialogflow_v2beta1 0.17.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +16 -0
data/lib/google/apis/dialogflow_v2beta1/classes.rb +473 -11
data/lib/google/apis/dialogflow_v2beta1/gem_version.rb +2 -2
data/lib/google/apis/dialogflow_v2beta1/representations.rb +204 -0
data/lib/google/apis/dialogflow_v2beta1/service.rb +340 -93
data/lib/google/apis/dialogflow_v2beta1.rb +1 -1
metadata +3 -3

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

@@ -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/`