Dialogflow CX V3 API - Class Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Client (v0.15.0)

Reference documentation and code samples for the Dialogflow CX V3 API class Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Client.

REST client for the Versions service.

Service for managing Versions.

Inherits

Object

Includes

Google::Cloud::Dialogflow::CX::V3::Versions::Paths

Methods

.configure

def self.configure() { |config| ... } -> Client::Configuration

Configure the Versions Client class.

See Configuration for a description of the configuration fields.

Yields

(config) — Configure the Client client.

Yield Parameter

config (Client::Configuration)

Returns

(Client::Configuration)

Example

# Modify the configuration for all Versions clients
::Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Client.configure do |config|
  config.timeout = 10.0
end

#compare_versions

def compare_versions(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse
def compare_versions(base_version: nil, target_version: nil, language_code: nil) -> ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse

Compares the specified base version with target version.

Overloads

def compare_versions(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse

Pass arguments to compare_versions via a request object, either of type CompareVersionsRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def compare_versions(base_version: nil, target_version: nil, language_code: nil) -> ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse

Pass arguments to compare_versions via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameters

base_version (::String) — 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/<Project ID>/locations/<Location ID>/agents/ <Agent ID>/flows/<Flow ID>/versions/<Version ID>.
target_version (::String) — Required. Name of the target flow version to compare with the base version. Use version ID 0 to indicate the draft version of the specified flow. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>.
language_code (::String) — The language to compare the flow versions for.

If not specified, the agent's default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#configure

def configure() { |config| ... } -> Client::Configuration

Configure the Versions Client instance.

The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.

See Configuration for a description of the configuration fields.

Yields

(config) — Configure the Client client.

Yield Parameter

config (Client::Configuration)

Returns

(Client::Configuration)

#create_version

def create_version(request, options = nil) -> ::Gapic::Operation
def create_version(parent: nil, version: nil) -> ::Gapic::Operation

Creates a Version in the specified Flow.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: CreateVersionOperationMetadata
response: Version

Overloads

def create_version(request, options = nil) -> ::Gapic::Operation

Pass arguments to create_version via a request object, either of type CreateVersionRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::CreateVersionRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def create_version(parent: nil, version: nil) -> ::Gapic::Operation

Pass arguments to create_version via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameters

parent (::String) — Required. The Flow to create an Version for. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>.
version (::Google::Cloud::Dialogflow::CX::V3::Version, ::Hash) — Required. The version to create.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Gapic::Operation)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Gapic::Operation)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#delete_version

def delete_version(request, options = nil) -> ::Google::Protobuf::Empty
def delete_version(name: nil) -> ::Google::Protobuf::Empty

Deletes the specified Version.

Overloads

def delete_version(request, options = nil) -> ::Google::Protobuf::Empty

Pass arguments to delete_version via a request object, either of type DeleteVersionRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::DeleteVersionRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def delete_version(name: nil) -> ::Google::Protobuf::Empty

Pass arguments to delete_version via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameter

name (::String) — Required. The name of the Version to delete. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Google::Protobuf::Empty)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Protobuf::Empty)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#get_version

def get_version(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version
def get_version(name: nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Retrieves the specified Version.

Overloads

def get_version(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Pass arguments to get_version via a request object, either of type GetVersionRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::GetVersionRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def get_version(name: nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Pass arguments to get_version via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameter

name (::String) — Required. The name of the Version. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Google::Cloud::Dialogflow::CX::V3::Version)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dialogflow::CX::V3::Version)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#initialize

def initialize() { |config| ... } -> Client

Create a new Versions REST client object.

Yields

(config) — Configure the Versions client.

Yield Parameter

config (Client::Configuration)

Returns

(Client) — a new instance of Client

Example

# Create a client using the default configuration
client = ::Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Client.new

# Create a client using a custom configuration
client = ::Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Client.new do |config|
  config.timeout = 10.0
end

#list_versions

def list_versions(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>
def list_versions(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>

Returns the list of all versions in the specified Flow.

Overloads

def list_versions(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>

Pass arguments to list_versions via a request object, either of type ListVersionsRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::ListVersionsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def list_versions(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>

Pass arguments to list_versions via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameters

parent (::String) — Required. The Flow to list all versions for. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>.
page_size (::Integer) — The maximum number of items to return in a single page. By default 20 and at most 100.
page_token (::String) — The next_page_token value returned from a previous list request.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dialogflow::CX::V3::Version>)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#load_version

def load_version(request, options = nil) -> ::Gapic::Operation
def load_version(name: nil, allow_override_agent_resources: nil) -> ::Gapic::Operation

Loads resources in the specified version to the draft flow.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: An empty Struct message
response: An Empty message

Overloads

def load_version(request, options = nil) -> ::Gapic::Operation

Pass arguments to load_version via a request object, either of type LoadVersionRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::LoadVersionRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def load_version(name: nil, allow_override_agent_resources: nil) -> ::Gapic::Operation

Pass arguments to load_version via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameters

name (::String) — Required. The Version to be loaded to draft flow. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>.
allow_override_agent_resources (::Boolean) — This field is used to prevent accidental overwrite of other agent resources, which can potentially impact other flow's behavior. If allow_override_agent_resources is false, conflicted agent-level resources will not be overridden (i.e. intents, entities, webhooks).

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Gapic::Operation)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Gapic::Operation)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.

#location_client

def location_client() -> Google::Cloud::Location::Locations::Rest::Client

Get the associated client for mix-in of the Locations.

Returns

(Google::Cloud::Location::Locations::Rest::Client)

#operations_client

def operations_client() -> ::Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Operations

Get the associated client for long-running operations.

Returns

(::Google::Cloud::Dialogflow::CX::V3::Versions::Rest::Operations)

#update_version

def update_version(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version
def update_version(version: nil, update_mask: nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Updates the specified Version.

Overloads

def update_version(request, options = nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Pass arguments to update_version via a request object, either of type UpdateVersionRequest or an equivalent Hash.

Parameters

request (::Google::Cloud::Dialogflow::CX::V3::UpdateVersionRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

def update_version(version: nil, update_mask: nil) -> ::Google::Cloud::Dialogflow::CX::V3::Version

Pass arguments to update_version via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).

Parameters

version (::Google::Cloud::Dialogflow::CX::V3::Version, ::Hash) — Required. The version to update.
update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The mask to control which fields get updated. Currently only description and display_name can be updated.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Google::Cloud::Dialogflow::CX::V3::Version)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dialogflow::CX::V3::Version)

Raises

(::Google::Cloud::Error) — if the REST call is aborted.