Class ConversationsAsyncClient

Service for managing Conversations.

Inheritance

builtins.object > ConversationsAsyncClient

Properties

transport

Returns the transport used by the client instance.

Returns
TypeDescription
ConversationsTransportThe transport used by the client instance.

Methods

batch_create_messages

batch_create_messages(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.BatchCreateMessagesRequest, dict]] = None, *, parent: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Batch ingests messages to conversation. Customers can use this RPC to ingest historical messages to conversation.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.BatchCreateMessagesRequest, dict]

The request object. The request message for [Conversations.BatchCreateMessagesRequest][].

parent `str`

Required. Resource identifier of the conversation to create message. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.types.BatchCreateMessagesResponseThe request message for [Conversations.BatchCreateMessagesResponse][].

common_billing_account_path

common_billing_account_path(billing_account: str)

Returns a fully-qualified billing_account string.

Parameter
NameDescription
billing_account str

common_folder_path

common_folder_path(folder: str)

Returns a fully-qualified folder string.

Parameter
NameDescription
folder str

common_location_path

common_location_path(project: str, location: str)

Returns a fully-qualified location string.

Parameters
NameDescription
project str
location str

common_organization_path

common_organization_path(organization: str)

Returns a fully-qualified organization string.

Parameter
NameDescription
organization str

common_project_path

common_project_path(project: str)

Returns a fully-qualified project string.

Parameter
NameDescription
project str

complete_conversation

complete_conversation(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.CompleteConversationRequest, dict]] = None, *, name: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Completes the specified conversation. Finished conversations are purged from the database after 30 days.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.CompleteConversationRequest, dict]

The request object. The request message for Conversations.CompleteConversation.

name `str`

Required. Resource identifier of the conversation to close. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>. This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.types.ConversationRepresents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions.

conversation_path

conversation_path(project: str, conversation: str)

Returns a fully-qualified conversation string.

Parameters
NameDescription
project str
conversation str

conversation_profile_path

conversation_profile_path(project: str, conversation_profile: str)

Returns a fully-qualified conversation_profile string.

Parameters
NameDescription
project str
conversation_profile str

create_conversation

create_conversation(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.CreateConversationRequest, dict]] = None, *, parent: Optional[str] = None, conversation: Optional[google.cloud.dialogflow_v2beta1.types.conversation.Conversation] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Creates a new conversation. Conversations are auto-completed after 24 hours.

Conversation Lifecycle: There are two stages during a conversation: Automated Agent Stage and Assist Stage.

For Automated Agent Stage, there will be a dialogflow agent responding to user queries.

For Assist Stage, there's no dialogflow agent responding to user queries. But we will provide suggestions which are generated from conversation.

If xref_Conversation.conversation_profile is configured for a dialogflow agent, conversation will start from Automated Agent Stage, otherwise, it will start from Assist Stage. And during Automated Agent Stage, once an xref_Intent with xref_Intent.live_agent_handoff is triggered, conversation will transfer to Assist Stage.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.CreateConversationRequest, dict]

The request object. The request message for Conversations.CreateConversation.

parent `str`

Required. Resource identifier of the project creating the conversation. Format: projects/<Project ID>/locations/<Location ID>. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

conversation Conversation

Required. The conversation to create. This corresponds to the conversation field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.types.ConversationRepresents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions.

from_service_account_file

from_service_account_file(filename: str, *args, **kwargs)

Creates an instance of this client using the provided credentials file.

Parameters
NameDescription
filename str

The path to the service account private key json file.

args

Additional arguments to pass to the constructor.

kwargs

Additional arguments to pass to the constructor.

Returns
TypeDescription
ConversationsAsyncClientThe constructed client.

from_service_account_info

from_service_account_info(info: dict, *args, **kwargs)

Creates an instance of this client using the provided credentials info.

Parameters
NameDescription
info dict

The service account private key info.

args

Additional arguments to pass to the constructor.

kwargs

Additional arguments to pass to the constructor.

Returns
TypeDescription
ConversationsAsyncClientThe constructed client.

from_service_account_json

from_service_account_json(filename: str, *args, **kwargs)

Creates an instance of this client using the provided credentials file.

Parameters
NameDescription
filename str

The path to the service account private key json file.

args

Additional arguments to pass to the constructor.

kwargs

Additional arguments to pass to the constructor.

Returns
TypeDescription
ConversationsAsyncClientThe constructed client.

get_conversation

get_conversation(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.GetConversationRequest, dict]] = None, *, name: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Retrieves the specific conversation.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.GetConversationRequest, dict]

The request object. The request message for Conversations.GetConversation.

name `str`

Required. The name of the conversation. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>. This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.types.ConversationRepresents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions.

get_transport_class

get_transport_class()

partial(func, *args, **keywords) - new function with partial application of the given arguments and keywords.

Parameter
NameDescription
label str

list_conversations

list_conversations(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.ListConversationsRequest, dict]] = None, *, parent: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Returns the list of all conversations in the specified project.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.ListConversationsRequest, dict]

The request object. The request message for Conversations.ListConversations.

parent `str`

Required. The project from which to list all conversation. Format: projects/<Project ID>/locations/<Location ID>. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.services.conversations.pagers.ListConversationsAsyncPagerThe response message for Conversations.ListConversations. Iterating over this object will yield results and resolve additional pages automatically.

list_messages

list_messages(request: Optional[Union[google.cloud.dialogflow_v2beta1.types.conversation.ListMessagesRequest, dict]] = None, *, parent: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Lists messages that belong to a given conversation. messages are ordered by create_time in descending order. To fetch updates without duplication, send request with filter create_time_epoch_microseconds > [first item's create_time of previous request] and empty page_token.

Parameters
NameDescription
request Union[google.cloud.dialogflow_v2beta1.types.ListMessagesRequest, dict]

The request object. The request message for Conversations.ListMessages.

parent `str`

Required. The name of the conversation to list messages for. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID> This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.dialogflow_v2beta1.services.conversations.pagers.ListMessagesAsyncPagerThe response message for Conversations.ListMessages. Iterating over this object will yield results and resolve additional pages automatically.

message_path

message_path(project: str, conversation: str, message: str)

Returns a fully-qualified message string.

Parameters
NameDescription
project str
conversation str
message str

parse_common_billing_account_path

parse_common_billing_account_path(path: str)

Parse a billing_account path into its component segments.

Parameter
NameDescription
path str

parse_common_folder_path

parse_common_folder_path(path: str)

Parse a folder path into its component segments.

Parameter
NameDescription
path str

parse_common_location_path

parse_common_location_path(path: str)

Parse a location path into its component segments.

Parameter
NameDescription
path str

parse_common_organization_path

parse_common_organization_path(path: str)

Parse a organization path into its component segments.

Parameter
NameDescription
path str

parse_common_project_path

parse_common_project_path(path: str)

Parse a project path into its component segments.

Parameter
NameDescription
path str

parse_conversation_path

parse_conversation_path(path: str)

Parses a conversation path into its component segments.

Parameter
NameDescription
path str

parse_conversation_profile_path

parse_conversation_profile_path(path: str)

Parses a conversation_profile path into its component segments.

Parameter
NameDescription
path str

parse_message_path

parse_message_path(path: str)

Parses a message path into its component segments.

Parameter
NameDescription
path str