ExperimentsAsyncClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.dialogflowcx_v3.services.experiments.transports.base.ExperimentsTransport] = 'grpc_asyncio', client_options: <module 'google.api_core.client_options' from '/workspace/python-dialogflow-cx/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
Service for managing Experiments.
Properties
transport
Returns the transport used by the client instance.
Returns | |
---|---|
Type | Description |
ExperimentsTransport | The transport used by the client instance. |
Methods
ExperimentsAsyncClient
ExperimentsAsyncClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.dialogflowcx_v3.services.experiments.transports.base.ExperimentsTransport] = 'grpc_asyncio', client_options: <module 'google.api_core.client_options' from '/workspace/python-dialogflow-cx/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
Instantiates the experiments client.
Parameters | |
---|---|
Name | Description |
credentials |
Optional[google.auth.credentials.Credentials]
The authorization credentials to attach to requests. These credentials identify the application to the service; if none are specified, the client will attempt to ascertain the credentials from the environment. |
transport |
Union[str,
The transport to use. If set to None, a transport is chosen automatically. |
client_options |
ClientOptions
Custom options for the client. It won't take effect if a |
Exceptions | |
---|---|
Type | Description |
google.auth.exceptions.MutualTlsChannelError | If mutual TLS transport creation failed for any reason. |
common_billing_account_path
common_billing_account_path(billing_account: str)
Returns a fully-qualified billing_account string.
common_folder_path
common_folder_path(folder: str)
Returns a fully-qualified folder string.
common_location_path
common_location_path(project: str, location: str)
Returns a fully-qualified location string.
common_organization_path
common_organization_path(organization: str)
Returns a fully-qualified organization string.
common_project_path
common_project_path(project: str)
Returns a fully-qualified project string.
create_experiment
create_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.CreateExperimentRequest] = None, *, parent: Optional[str] = None, experiment: Optional[google.cloud.dialogflowcx_v3.types.experiment.Experiment] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Creates an xref_Experiment in the specified xref_Environment.
Parameters | |
---|---|
Name | Description |
request |
CreateExperimentRequest
The request object. The request message for Experiments.CreateExperiment. |
parent |
Required. The Agent to create an Environment for. Format: |
experiment |
Experiment
Required. The experiment to create. This corresponds to the |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.types.Experiment | Represents an experiment in an environment. |
delete_experiment
delete_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.DeleteExperimentRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Deletes the specified xref_Experiment.
Parameters | |
---|---|
Name | Description |
request |
DeleteExperimentRequest
The request object. The request message for Experiments.DeleteExperiment. |
name |
Required. The name of the Environment to delete. Format: |
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. |
experiment_path
experiment_path(
project: str, location: str, agent: str, environment: str, experiment: str
)
Returns a fully-qualified experiment string.
from_service_account_file
from_service_account_file(filename: str, *args, **kwargs)
Creates an instance of this client using the provided credentials file.
Parameter | |
---|---|
Name | Description |
filename |
str
The path to the service account private key json file. |
Returns | |
---|---|
Type | Description |
ExperimentsAsyncClient | The 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.
Parameter | |
---|---|
Name | Description |
info |
dict
The service account private key info. |
Returns | |
---|---|
Type | Description |
ExperimentsAsyncClient | The 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.
Parameter | |
---|---|
Name | Description |
filename |
str
The path to the service account private key json file. |
Returns | |
---|---|
Type | Description |
ExperimentsAsyncClient | The constructed client. |
get_experiment
get_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.GetExperimentRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Retrieves the specified xref_Experiment.
Parameters | |
---|---|
Name | Description |
request |
GetExperimentRequest
The request object. The request message for Experiments.GetExperiment. |
name |
Required. The name of the Environment. Format: |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.types.Experiment | Represents an experiment in an environment. |
get_transport_class
get_transport_class()
Returns an appropriate transport class.
list_experiments
list_experiments(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.ListExperimentsRequest] = None, *, parent: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Returns the list of all experiments in the specified xref_Environment.
Parameters | |
---|---|
Name | Description |
request |
ListExperimentsRequest
The request object. The request message for Experiments.ListExperiments. |
parent |
Required. The Environment to list all environments for. Format: |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.services.experiments.pagers.ListExperimentsAsyncPager | The response message for Experiments.ListExperiments. Iterating over this object will yield results and resolve additional pages automatically. |
parse_common_billing_account_path
parse_common_billing_account_path(path: str)
Parse a billing_account path into its component segments.
parse_common_folder_path
parse_common_folder_path(path: str)
Parse a folder path into its component segments.
parse_common_location_path
parse_common_location_path(path: str)
Parse a location path into its component segments.
parse_common_organization_path
parse_common_organization_path(path: str)
Parse a organization path into its component segments.
parse_common_project_path
parse_common_project_path(path: str)
Parse a project path into its component segments.
parse_experiment_path
parse_experiment_path(path: str)
Parses a experiment path into its component segments.
parse_version_path
parse_version_path(path: str)
Parses a version path into its component segments.
start_experiment
start_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.StartExperimentRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Starts the specified xref_Experiment. This rpc only changes the state of experiment from PENDING to RUNNING.
Parameters | |
---|---|
Name | Description |
request |
StartExperimentRequest
The request object. The request message for Experiments.StartExperiment. |
name |
Required. Resource name of the experiment to start. Format: |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.types.Experiment | Represents an experiment in an environment. |
stop_experiment
stop_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.StopExperimentRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Stops the specified xref_Experiment. This rpc only changes the state of experiment from RUNNING to DONE.
Parameters | |
---|---|
Name | Description |
request |
StopExperimentRequest
The request object. The request message for Experiments.StopExperiment. |
name |
Required. Resource name of the experiment to stop. Format: |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.types.Experiment | Represents an experiment in an environment. |
update_experiment
update_experiment(request: Optional[google.cloud.dialogflowcx_v3.types.experiment.UpdateExperimentRequest] = None, *, experiment: Optional[google.cloud.dialogflowcx_v3.types.experiment.Experiment] = None, update_mask: Optional[google.protobuf.field_mask_pb2.FieldMask] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Updates the specified xref_Experiment.
Parameters | |
---|---|
Name | Description |
request |
UpdateExperimentRequest
The request object. The request message for Experiments.UpdateExperiment. |
experiment |
Experiment
Required. The experiment to update. This corresponds to the |
update_mask |
Required. The mask to control which fields get updated. This corresponds to the |
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 | |
---|---|
Type | Description |
google.cloud.dialogflowcx_v3.types.Experiment | Represents an experiment in an environment. |
version_path
version_path(project: str, location: str, agent: str, flow: str, version: str)
Returns a fully-qualified version string.