google-apis-dialogflow_v3 0.20.0 → 0.24.0

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

@@ -50,6 +50,79 @@ module Google
           @batch_path = 'batch'
         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::DialogflowV3::GoogleCloudLocationLocation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::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, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudLocationLocation::Representation
+          command.response_class = Google::Apis::DialogflowV3::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
+        
+        # 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::DialogflowV3::GoogleCloudLocationListLocationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::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, 'v3/{+name}/locations', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudLocationListLocationsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::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 an agent in the specified location. Note: You should always train
         # flows prior to sending them queries. See the [training documentation](https://
         # cloud.google.com/dialogflow/cx/docs/concept/training).
@@ -116,7 +189,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified agent to a binary file.
+        # Exports the specified agent to a binary file. 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`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportAgentResponse
         # @param [String] name
         #   Required. The name of the agent to export. Format: `projects//locations//
         #   agents/`.
@@ -295,9 +373,15 @@ module Google
         
         # Restores the specified agent from a binary file. Replaces the current agent
         # with a new one. Note that all existing resources in agent (e.g. intents,
-        # entity types, flows) will be removed. Note: You should always train flows
-        # prior to sending them queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/cx/docs/concept/training).
+        # entity types, flows) will be removed. 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`: 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 flows prior to sending them queries. See
+        # the [training documentation](https://cloud.google.com/dialogflow/cx/docs/
+        # concept/training).
         # @param [String] name
         #   Required. The name of the agent to restore into. Format: `projects//locations//
         #   agents/`.
@@ -366,6 +450,87 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves the specified Changelog.
+        # @param [String] name
+        #   Required. The name of the changelog to get. Format: `projects//locations//
+        #   agents//changelogs/`.
+        # @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::DialogflowV3::GoogleCloudDialogflowCxV3Changelog] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Changelog]
+        #
+        # @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_agent_changelog(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Changelog::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Changelog
+          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
+        
+        # Returns the list of Changelogs.
+        # @param [String] parent
+        #   Required. The agent containing the changelogs. Format: `projects//locations//
+        #   agents/`.
+        # @param [String] filter
+        #   The filter string. Supports filter by user_email, resource, type and
+        #   create_time. Some examples: 1. By user email: user_email = "someone@google.com"
+        #   2. By resource name: resource = "projects/123/locations/global/agents/456/
+        #   flows/789" 3. By resource display name: display_name = "my agent" 4. By action:
+        #   action = "Create" 5. By type: type = "flows" 6. By create time. Currently
+        #   predicates on `create_time` and `create_time_epoch_seconds` are supported:
+        #   create_time_epoch_seconds > 1551790877 AND create_time <= 2017-01-15T01:30:15.
+        #   01Z 7. Combination of above filters: resource = "projects/123/locations/global/
+        #   agents/456/flows/789" AND user_email = "someone@google.com" AND create_time <=
+        #   2017-01-15T01:30:15.01Z
+        # @param [Fixnum] page_size
+        #   The maximum number of items to return in a single page. By default 100 and at
+        #   most 1000.
+        # @param [String] page_token
+        #   The next_page_token value returned from a previous list request.
+        # @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::DialogflowV3::GoogleCloudDialogflowCxV3ListChangelogsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListChangelogsResponse]
+        #
+        # @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_location_agent_changelogs(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/changelogs', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListChangelogsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListChangelogsResponse
+          command.params['parent'] = parent unless parent.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 an entity type in the specified agent. Note: You should always train a
         # flow prior to sending it queries. See the [training documentation](https://
         # cloud.google.com/dialogflow/cx/docs/concept/training).
@@ -581,7 +746,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an Environment in the specified Agent.
+        # Creates an Environment in the specified Agent. 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`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # Environment
         # @param [String] parent
         #   Required. The Agent to create an Environment for. Format: `projects//locations/
         #   /agents/`.
@@ -646,6 +816,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deploys a flow to the specified Environment. 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`: DeployFlowMetadata - `response`: DeployFlowResponse
+        # @param [String] environment
+        #   Required. The environment to deploy the flow to. Format: `projects//locations//
+        #   agents// environments/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3DeployFlowRequest] google_cloud_dialogflow_cx_v3_deploy_flow_request_object
+        # @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::DialogflowV3::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleLongrunningOperation]
+        #
+        # @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 deploy_project_location_agent_environment_flow(environment, google_cloud_dialogflow_cx_v3_deploy_flow_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+environment}:deployFlow', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3DeployFlowRequest::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_deploy_flow_request_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleLongrunningOperation
+          command.params['environment'] = environment unless environment.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 Environment.
         # @param [String] name
         #   Required. The name of the Environment. Format: `projects//locations//agents//
@@ -753,7 +960,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified Environment.
+        # Updates the specified Environment. 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`: An empty [Struct message](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#struct) - `response`: Environment
         # @param [String] name
         #   The name of the environment. Format: `projects//locations//agents//
         #   environments/`.
@@ -790,7 +1001,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Kicks off a continuous test under the specified Environment.
+        # Kicks off a continuous test under the specified Environment. 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`: RunContinuousTestMetadata - `response`:
+        # RunContinuousTestResponse
         # @param [String] environment
         #   Required. Format: `projects//locations//agents//environments/`.
         # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RunContinuousTestRequest] google_cloud_dialogflow_cx_v3_run_continuous_test_request_object
@@ -861,6 +1076,75 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves the specified Deployment.
+        # @param [String] name
+        #   Required. The name of the Deployment. Format: `projects//locations//agents//
+        #   environments//deployments/`.
+        # @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::DialogflowV3::GoogleCloudDialogflowCxV3Deployment] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Deployment]
+        #
+        # @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_agent_environment_deployment(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Deployment::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Deployment
+          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
+        
+        # Returns the list of all deployments in the specified Environment.
+        # @param [String] parent
+        #   Required. The Environment to list all environments for. Format: `projects//
+        #   locations//agents//environments/`.
+        # @param [Fixnum] page_size
+        #   The maximum number of items to return in a single page. By default 20 and at
+        #   most 100.
+        # @param [String] page_token
+        #   The next_page_token value returned from a previous list request.
+        # @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::DialogflowV3::GoogleCloudDialogflowCxV3ListDeploymentsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListDeploymentsResponse]
+        #
+        # @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_location_agent_environment_deployments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/deployments', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListDeploymentsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListDeploymentsResponse
+          command.params['parent'] = parent unless parent.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 an Experiment in the specified Environment.
         # @param [String] parent
         #   Required. The Agent to create an Environment for. Format: `projects//locations/
@@ -1495,8 +1779,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified flow to a binary file. Note that resources (e.g. intents,
-        # entities, webhooks) that the flow references will also be exported.
+        # Exports the specified flow to a binary file. 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`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportFlowResponse Note that resources (e.g. intents, entities, webhooks) that
+        # the flow references will also be exported.
         # @param [String] name
         #   Required. The name of the flow to export. Format: `projects//locations//agents/
         #   /flows/`.
@@ -1606,9 +1895,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Imports the specified flow to the specified agent from a binary file. Note:
-        # You should always train a flow prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+        # Imports the specified flow to the specified agent from a binary file. 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`: An empty [Struct message](
+        # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        # struct) - `response`: ImportFlowResponse Note: You should always train a flow
+        # prior to sending it queries. See the [training documentation](https://cloud.
+        # google.com/dialogflow/cx/docs/concept/training).
         # @param [String] parent
         #   Required. The agent to import the flow into. Format: `projects//locations//
         #   agents/`.
@@ -1706,8 +2000,8 @@ module Google
         #   com/dialogflow/cx/docs/reference/language) are supported. Note: languages must
         #   be enabled in the agent before they can be used.
         # @param [String] update_mask
-        #   Required. The mask to control which fields get updated. If `update_mask` is
-        #   not specified, an error will be returned.
+        #   The mask to control which fields get updated. If the mask is not present, all
+        #   fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1740,9 +2034,14 @@ module Google
         end
         
         # Trains the specified flow. Note that only the flow in 'draft' environment is
-        # trained. Note: You should always train a flow prior to sending it queries. See
-        # the [training documentation](https://cloud.google.com/dialogflow/cx/docs/
-        # concept/training).
+        # trained. 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`: 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 a flow prior to sending it queries. See the [training
+        # documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
         # @param [String] name
         #   Required. The flow to train. Format: `projects//locations//agents//flows/`.
         # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3TrainFlowRequest] google_cloud_dialogflow_cx_v3_train_flow_request_object
@@ -2276,7 +2575,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Version in the specified Flow.
+        # Compares the specified base version with target version.
+        # @param [String] base_version
+        #   Required. Name of the base flow version to compare with the target version.
+        #   Use version ID `0` to indicate the draft version of the specified flow. Format:
+        #   `projects//locations//agents/ /flows//versions/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsRequest] google_cloud_dialogflow_cx_v3_compare_versions_request_object
+        # @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::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsResponse]
+        #
+        # @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 compare_project_location_agent_flow_version_versions(base_version, google_cloud_dialogflow_cx_v3_compare_versions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+baseVersion}:compareVersions', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsRequest::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_compare_versions_request_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3CompareVersionsResponse
+          command.params['baseVersion'] = base_version unless base_version.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 a Version in the specified Flow. 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`: CreateVersionOperationMetadata - `response`: Version
         # @param [String] parent
         #   Required. The Flow to create an Version for. Format: `projects//locations//
         #   agents//flows/`.
@@ -2410,7 +2747,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Loads resources in the specified version to the draft flow.
+        # Loads resources in the specified version to the draft flow. 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`: 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] name
         #   Required. The Version to be loaded to draft flow. Format: `projects//locations/
         #   /agents//flows//versions/`.
@@ -3035,7 +3378,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Kicks off a batch run of test cases.
+        # Kicks off a batch run of test cases. 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`: BatchRunTestCasesMetadata - `response`: BatchRunTestCasesResponse
         # @param [String] parent
         #   Required. Agent name. Format: `projects//locations//agents/ `.
         # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3BatchRunTestCasesRequest] google_cloud_dialogflow_cx_v3_batch_run_test_cases_request_object
@@ -3137,7 +3483,11 @@ module Google
         end
         
         # Exports the test cases under the agent to a Cloud Storage bucket or a local
-        # file. Filter can be applied to export a subset of test cases.
+        # file. Filter can be applied to export a subset of test cases. 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`: ExportTestCasesMetadata - `response`:
+        # ExportTestCasesResponse
         # @param [String] parent
         #   Required. The agent where to export test cases from. Format: `projects//
         #   locations//agents/`.
@@ -3204,7 +3554,11 @@ module Google
         
         # Imports the test cases from a Cloud Storage bucket or a local file. It always
         # creates new test cases and won't overwite any existing ones. The provided ID
-        # in the imported test case is neglected.
+        # in the imported test case is neglected. 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`: ImportTestCasesMetadata - `response`:
+        # ImportTestCasesResponse
         # @param [String] parent
         #   Required. The agent to import test cases to. Format: `projects//locations//
         #   agents/`.
@@ -3319,7 +3673,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Kicks off a test case run.
+        # Kicks off a test case run. 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`:
+        # RunTestCaseMetadata - `response`: RunTestCaseResponse
         # @param [String] name
         #   Required. Format of test case name to run: `projects//locations/ /agents//
         #   testCases/`.
@@ -3869,7 +4226,9 @@ module Google
         
         # Updates the specified SecuritySettings.
         # @param [String] name
-        #   Required. Resource name of the settings. Format: `projects//locations//
+        #   Resource name of the settings. Required for the SecuritySettingsService.
+        #   UpdateSecuritySettings method. SecuritySettingsService.CreateSecuritySettings
+        #   populates the name automatically. Format: `projects//locations//
         #   securitySettings/`.
         # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3SecuritySettings] google_cloud_dialogflow_cx_v3_security_settings_object
         # @param [String] update_mask

data/lib/google/apis/dialogflow_v3.rb

@@ -30,7 +30,7 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V3'
 
-      # See, edit, configure, and delete your Google Cloud Platform data
+      # See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 
       # View, manage and query your Dialogflow agents

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-dialogflow_v3
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-09 00:00:00.000000000 Z
+date: 2021-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-dialogflow_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-dialogflow_v3/v0.20.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-dialogflow_v3
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-dialogflow_v3/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-dialogflow_v3/v0.24.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-dialogflow_v3
 post_install_message: 
 rdoc_options: []
 require_paths: