google-apis-dialogflow_v3 0.104.0 → 0.106.0

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

@@ -85,6 +85,9 @@ module Google
         # Lists information about the supported locations for this service.
         # @param [String] name
         #   The resource that owns the locations collection, if applicable.
+        # @param [Array<String>, String] extra_location_types
+        #   Optional. A list of extra location types that should be used as conditions for
+        #   controlling the visibility of the locations.
         # @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
@@ -112,11 +115,12 @@ module Google
         # @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)
+        def list_project_locations(name, extra_location_types: nil, 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['extraLocationTypes'] = extra_location_types unless extra_location_types.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?
@@ -3491,6 +3495,593 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a playbook in a specified agent.
+        # @param [String] parent
+        #   Required. The agent to create a playbook for. Format: `projects//locations//
+        #   agents/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook] google_cloud_dialogflow_cx_v3_playbook_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::GoogleCloudDialogflowCxV3Playbook] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook]
+        #
+        # @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 create_project_location_agent_playbook(parent, google_cloud_dialogflow_cx_v3_playbook_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/playbooks', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_playbook_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a specified playbook.
+        # @param [String] name
+        #   Required. The name of the playbook to delete. Format: `projects//locations//
+        #   agents//playbooks/`.
+        # @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::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleProtobufEmpty]
+        #
+        # @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 delete_project_location_agent_playbook(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleProtobufEmpty
+          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
+        
+        # Exports the specified playbook to a binary file. Note that resources (e.g.
+        # examples, tools) that the playbook references will also be exported.
+        # @param [String] name
+        #   Required. The name of the playbook to export. Format: `projects//locations//
+        #   agents//playbooks/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ExportPlaybookRequest] google_cloud_dialogflow_cx_v3_export_playbook_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 export_project_location_agent_playbook(name, google_cloud_dialogflow_cx_v3_export_playbook_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+name}:export', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ExportPlaybookRequest::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_export_playbook_request_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleLongrunningOperation
+          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 Playbook.
+        # @param [String] name
+        #   Required. The name of the playbook. Format: `projects//locations//agents//
+        #   playbooks/`.
+        # @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::GoogleCloudDialogflowCxV3Playbook] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook]
+        #
+        # @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_playbook(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook
+          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
+        
+        # Imports the specified playbook to the specified agent from a binary file.
+        # @param [String] parent
+        #   Required. The agent to import the playbook into. Format: `projects//locations//
+        #   agents/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ImportPlaybookRequest] google_cloud_dialogflow_cx_v3_import_playbook_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 import_project_location_agent_playbook(parent, google_cloud_dialogflow_cx_v3_import_playbook_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/playbooks:import', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ImportPlaybookRequest::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_import_playbook_request_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.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 a list of playbooks in the specified agent.
+        # @param [String] parent
+        #   Required. The agent to list playbooks from. Format: `projects//locations//
+        #   agents/`.
+        # @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::GoogleCloudDialogflowCxV3ListPlaybooksResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybooksResponse]
+        #
+        # @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_playbooks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/playbooks', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybooksResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybooksResponse
+          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
+        
+        # Updates the specified Playbook.
+        # @param [String] name
+        #   The unique identifier of the playbook. Format: `projects//locations//agents//
+        #   playbooks/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook] google_cloud_dialogflow_cx_v3_playbook_object
+        # @param [String] update_mask
+        #   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
+        #   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::GoogleCloudDialogflowCxV3Playbook] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook]
+        #
+        # @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 patch_project_location_agent_playbook(name, google_cloud_dialogflow_cx_v3_playbook_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v3/{+name}', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_playbook_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Playbook
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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 example in the specified playbook.
+        # @param [String] parent
+        #   Required. The playbook to create an example for. Format: `projects//locations//
+        #   agents//playbooks/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example] google_cloud_dialogflow_cx_v3_example_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::GoogleCloudDialogflowCxV3Example] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example]
+        #
+        # @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 create_project_location_agent_playbook_example(parent, google_cloud_dialogflow_cx_v3_example_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/examples', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_example_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the specified example.
+        # @param [String] name
+        #   Required. The name of the example to delete. Format: `projects//locations//
+        #   agents//playbooks//examples/`.
+        # @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::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleProtobufEmpty]
+        #
+        # @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 delete_project_location_agent_playbook_example(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleProtobufEmpty
+          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 example.
+        # @param [String] name
+        #   Required. The name of the example. Format: `projects//locations//agents//
+        #   playbooks//examples/`.
+        # @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::GoogleCloudDialogflowCxV3Example] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example]
+        #
+        # @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_playbook_example(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example
+          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 a list of examples in the specified playbook.
+        # @param [String] parent
+        #   Required. The playbook to list the examples from. Format: `projects//locations/
+        #   /agents//playbooks/`.
+        # @param [String] language_code
+        #   Optional. The language to list examples for. If not specified, list all
+        #   examples under the playbook. Note: languages must be enabled in the agent
+        #   before they can be used.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of items to return in a single page. By default
+        #   100 and at most 1000.
+        # @param [String] page_token
+        #   Optional. 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::GoogleCloudDialogflowCxV3ListExamplesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListExamplesResponse]
+        #
+        # @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_playbook_examples(parent, language_code: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/examples', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListExamplesResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListExamplesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['languageCode'] = language_code unless language_code.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
+        
+        # Update the specified example.
+        # @param [String] name
+        #   The unique identifier of the playbook example. Format: `projects//locations//
+        #   agents//playbooks//examples/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example] google_cloud_dialogflow_cx_v3_example_object
+        # @param [String] update_mask
+        #   Optional. 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
+        #   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::GoogleCloudDialogflowCxV3Example] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example]
+        #
+        # @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 patch_project_location_agent_playbook_example(name, google_cloud_dialogflow_cx_v3_example_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v3/{+name}', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_example_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Example
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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 for the specified Playbook.
+        # @param [String] parent
+        #   Required. The playbook to create a version for. Format: `projects//locations//
+        #   agents//playbooks/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion] google_cloud_dialogflow_cx_v3_playbook_version_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::GoogleCloudDialogflowCxV3PlaybookVersion] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion]
+        #
+        # @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 create_project_location_agent_playbook_version(parent, google_cloud_dialogflow_cx_v3_playbook_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/versions', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_playbook_version_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the specified version of the Playbook.
+        # @param [String] name
+        #   Required. The name of the playbook version to delete. Format: `projects//
+        #   locations//agents//playbooks//versions/`.
+        # @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::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleProtobufEmpty]
+        #
+        # @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 delete_project_location_agent_playbook_version(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleProtobufEmpty
+          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 version of the Playbook.
+        # @param [String] name
+        #   Required. The name of the playbook version. Format: `projects//locations//
+        #   agents//playbooks//versions/`.
+        # @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::GoogleCloudDialogflowCxV3PlaybookVersion] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion]
+        #
+        # @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_playbook_version(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3PlaybookVersion
+          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 versions for the specified Playbook.
+        # @param [String] parent
+        #   Required. The playbook to list versions for. Format: `projects//locations//
+        #   agents//playbooks/`.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of items to return in a single page. By default
+        #   100 and at most 1000.
+        # @param [String] page_token
+        #   Optional. 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::GoogleCloudDialogflowCxV3ListPlaybookVersionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybookVersionsResponse]
+        #
+        # @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_playbook_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/versions', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybookVersionsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListPlaybookVersionsResponse
+          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
+        
+        # Retrieves the specified version of the Playbook and stores it as the current
+        # playbook draft, returning the playbook with resources updated.
+        # @param [String] name
+        #   Required. The name of the playbook version. Format: `projects//locations//
+        #   agents//playbooks//versions/`.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RestorePlaybookVersionRequest] google_cloud_dialogflow_cx_v3_restore_playbook_version_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::GoogleCloudDialogflowCxV3RestorePlaybookVersionResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RestorePlaybookVersionResponse]
+        #
+        # @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 restore_project_location_agent_playbook_version(name, google_cloud_dialogflow_cx_v3_restore_playbook_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+name}:restore', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RestorePlaybookVersionRequest::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_restore_playbook_version_request_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RestorePlaybookVersionResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RestorePlaybookVersionResponse
+          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
+        
         # Processes a natural language query and returns structured, actionable data as
         # a result. This method is not idempotent, because it may cause session entity
         # types to be updated, which in turn might affect results of future queries.
@@ -4330,6 +4921,183 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a Tool in the specified agent.
+        # @param [String] parent
+        #   Required. The agent to create a Tool for. Format: `projects//locations//agents/
+        #   `.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool] google_cloud_dialogflow_cx_v3_tool_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::GoogleCloudDialogflowCxV3Tool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool]
+        #
+        # @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 create_project_location_agent_tool(parent, google_cloud_dialogflow_cx_v3_tool_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/tools', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_tool_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a specified Tool.
+        # @param [String] name
+        #   Required. The name of the Tool to be deleted. Format: `projects//locations//
+        #   agents//tools/`.
+        # @param [Boolean] force
+        #   This field has no effect for Tools not being used. For Tools that are used: *
+        #   If `force` is set to false, an error will be returned with message indicating
+        #   the referenced resources. * If `force` is set to true, Dialogflow will remove
+        #   the tool, as well as any references to the tool.
+        # @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::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleProtobufEmpty]
+        #
+        # @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 delete_project_location_agent_tool(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleProtobufEmpty
+          command.params['name'] = name unless name.nil?
+          command.query['force'] = force unless force.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 Tool.
+        # @param [String] name
+        #   Required. The name of the Tool. Format: `projects//locations//agents//tools/`.
+        # @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::GoogleCloudDialogflowCxV3Tool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool]
+        #
+        # @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_tool(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool
+          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 a list of Tools in the specified agent.
+        # @param [String] parent
+        #   Required. The agent to list the Tools from. Format: `projects//locations//
+        #   agents/`.
+        # @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::GoogleCloudDialogflowCxV3ListToolsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListToolsResponse]
+        #
+        # @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_tools(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/tools', options)
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListToolsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ListToolsResponse
+          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
+        
+        # Update the specified Tool.
+        # @param [String] name
+        #   The unique identifier of the Tool. Format: `projects//locations//agents//tools/
+        #   `.
+        # @param [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool] google_cloud_dialogflow_cx_v3_tool_object
+        # @param [String] update_mask
+        #   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
+        #   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::GoogleCloudDialogflowCxV3Tool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool]
+        #
+        # @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 patch_project_location_agent_tool(name, google_cloud_dialogflow_cx_v3_tool_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v3/{+name}', options)
+          command.request_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool::Representation
+          command.request_object = google_cloud_dialogflow_cx_v3_tool_object
+          command.response_representation = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool::Representation
+          command.response_class = Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Tool
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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 TransitionRouteGroup in the specified flow. 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).