Cloud AI Platform v1beta1 API - Class ExtensionExecutionServiceClient (1.0.0-beta10)

public abstract class ExtensionExecutionServiceClient

Reference documentation and code samples for the Cloud AI Platform v1beta1 API class ExtensionExecutionServiceClient.

ExtensionExecutionService client wrapper, for convenient use.

Inheritance

object > ExtensionExecutionServiceClient

Inherited Members

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ToString()

Derived Types

ExtensionExecutionServiceClientImpl

Namespace

Google.Cloud.AIPlatform.V1Beta1

Assembly

Google.Cloud.AIPlatform.V1Beta1.dll

Remarks

A service for Extension execution.

Properties

DefaultEndpoint

public static string DefaultEndpoint { get; }

The default endpoint for the ExtensionExecutionService service, which is a host of "aiplatform.googleapis.com" and a port of 443.

Property Value
Type	Description
`string`

DefaultScopes

public static IReadOnlyList<string> DefaultScopes { get; }

The default ExtensionExecutionService scopes.

Property Value
Type	Description
`IReadOnlyListstring`

Remarks

The default ExtensionExecutionService scopes are:

https://www.googleapis.com/auth/cloud-platform

GrpcClient

public virtual ExtensionExecutionService.ExtensionExecutionServiceClient GrpcClient { get; }

The underlying gRPC ExtensionExecutionService client

Property Value
Type	Description
`ExtensionExecutionServiceExtensionExecutionServiceClient`

IAMPolicyClient

public virtual IAMPolicyClient IAMPolicyClient { get; }

The IAMPolicyClient associated with this client.

Property Value
Type	Description
`IAMPolicyClient`

LocationsClient

public virtual LocationsClient LocationsClient { get; }

The LocationsClient associated with this client.

Property Value
Type	Description
`LocationsClient`

ServiceMetadata

public static ServiceMetadata ServiceMetadata { get; }

The service metadata associated with this client type.

Property Value
Type	Description
`ServiceMetadata`

Methods

Create()

public static ExtensionExecutionServiceClient Create()

Synchronously creates a ExtensionExecutionServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use ExtensionExecutionServiceClientBuilder.

Returns
Type	Description
`ExtensionExecutionServiceClient`	The created ExtensionExecutionServiceClient.

CreateAsync(CancellationToken)

public static Task<ExtensionExecutionServiceClient> CreateAsync(CancellationToken cancellationToken = default)

Asynchronously creates a ExtensionExecutionServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use ExtensionExecutionServiceClientBuilder.

Parameter
Name	Description
`cancellationToken`	`CancellationToken` The CancellationToken to use while creating the client.

Returns
Type	Description
`TaskExtensionExecutionServiceClient`	The task representing the created ExtensionExecutionServiceClient.

ExecuteExtension(ExecuteExtensionRequest, CallSettings)

public virtual ExecuteExtensionResponse ExecuteExtension(ExecuteExtensionRequest request, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`request`	`ExecuteExtensionRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`ExecuteExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
ExecuteExtensionRequest request = new ExecuteExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    OperationId = "",
    OperationParams = new Struct(),
    RuntimeAuthConfig = new AuthConfig(),
};
// Make the request
ExecuteExtensionResponse response = extensionExecutionServiceClient.ExecuteExtension(request);

ExecuteExtension(ExtensionName, string, CallSettings)

public virtual ExecuteExtensionResponse ExecuteExtension(ExtensionName name, string operationId, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`ExecuteExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
string operationId = "";
// Make the request
ExecuteExtensionResponse response = extensionExecutionServiceClient.ExecuteExtension(name, operationId);

ExecuteExtension(string, string, CallSettings)

public virtual ExecuteExtensionResponse ExecuteExtension(string name, string operationId, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`ExecuteExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
string operationId = "";
// Make the request
ExecuteExtensionResponse response = extensionExecutionServiceClient.ExecuteExtension(name, operationId);

ExecuteExtensionAsync(ExecuteExtensionRequest, CallSettings)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(ExecuteExtensionRequest request, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`request`	`ExecuteExtensionRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExecuteExtensionRequest request = new ExecuteExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    OperationId = "",
    OperationParams = new Struct(),
    RuntimeAuthConfig = new AuthConfig(),
};
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(request);

ExecuteExtensionAsync(ExecuteExtensionRequest, CancellationToken)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(ExecuteExtensionRequest request, CancellationToken cancellationToken)

Executes the request against a given extension.

Parameters
Name	Description
`request`	`ExecuteExtensionRequest` The request object containing all of the parameters for the API call.
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExecuteExtensionRequest request = new ExecuteExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    OperationId = "",
    OperationParams = new Struct(),
    RuntimeAuthConfig = new AuthConfig(),
};
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(request);

ExecuteExtensionAsync(ExtensionName, string, CallSettings)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(ExtensionName name, string operationId, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
string operationId = "";
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(name, operationId);

ExecuteExtensionAsync(ExtensionName, string, CancellationToken)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(ExtensionName name, string operationId, CancellationToken cancellationToken)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
string operationId = "";
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(name, operationId);

ExecuteExtensionAsync(string, string, CallSettings)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(string name, string operationId, CallSettings callSettings = null)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
string operationId = "";
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(name, operationId);

ExecuteExtensionAsync(string, string, CancellationToken)

public virtual Task<ExecuteExtensionResponse> ExecuteExtensionAsync(string name, string operationId, CancellationToken cancellationToken)

Executes the request against a given extension.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`operationId`	`string` Required. The desired ID of the operation to be executed in this extension as defined in [ExtensionOperation.operation_id][google.cloud.aiplatform.v1beta1.ExtensionOperation.operation_id].
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskExecuteExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
string operationId = "";
// Make the request
ExecuteExtensionResponse response = await extensionExecutionServiceClient.ExecuteExtensionAsync(name, operationId);

QueryExtension(ExtensionName, IEnumerable<Content>, CallSettings)

public virtual QueryExtensionResponse QueryExtension(ExtensionName name, IEnumerable<Content> contents, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`QueryExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = extensionExecutionServiceClient.QueryExtension(name, contents);

QueryExtension(QueryExtensionRequest, CallSettings)

public virtual QueryExtensionResponse QueryExtension(QueryExtensionRequest request, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`request`	`QueryExtensionRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`QueryExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
QueryExtensionRequest request = new QueryExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    Contents = { new Content(), },
};
// Make the request
QueryExtensionResponse response = extensionExecutionServiceClient.QueryExtension(request);

QueryExtension(string, IEnumerable<Content>, CallSettings)

public virtual QueryExtensionResponse QueryExtension(string name, IEnumerable<Content> contents, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`QueryExtensionResponse`	The RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = ExtensionExecutionServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = extensionExecutionServiceClient.QueryExtension(name, contents);

QueryExtensionAsync(ExtensionName, IEnumerable<Content>, CallSettings)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(ExtensionName name, IEnumerable<Content> contents, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(name, contents);

QueryExtensionAsync(ExtensionName, IEnumerable<Content>, CancellationToken)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(ExtensionName name, IEnumerable<Content> contents, CancellationToken cancellationToken)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`ExtensionName` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
ExtensionName name = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]");
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(name, contents);

QueryExtensionAsync(QueryExtensionRequest, CallSettings)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(QueryExtensionRequest request, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`request`	`QueryExtensionRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
QueryExtensionRequest request = new QueryExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    Contents = { new Content(), },
};
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(request);

QueryExtensionAsync(QueryExtensionRequest, CancellationToken)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(QueryExtensionRequest request, CancellationToken cancellationToken)

Queries an extension with a default controller.

Parameters
Name	Description
`request`	`QueryExtensionRequest` The request object containing all of the parameters for the API call.
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
QueryExtensionRequest request = new QueryExtensionRequest
{
    ExtensionName = ExtensionName.FromProjectLocationExtension("[PROJECT]", "[LOCATION]", "[EXTENSION]"),
    Contents = { new Content(), },
};
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(request);

QueryExtensionAsync(string, IEnumerable<Content>, CallSettings)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(string name, IEnumerable<Content> contents, CallSettings callSettings = null)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(name, contents);

QueryExtensionAsync(string, IEnumerable<Content>, CancellationToken)

public virtual Task<QueryExtensionResponse> QueryExtensionAsync(string name, IEnumerable<Content> contents, CancellationToken cancellationToken)

Queries an extension with a default controller.

Parameters
Name	Description
`name`	`string` Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`
`contents`	`IEnumerableContent` Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
`cancellationToken`	`CancellationToken` A CancellationToken to use for this RPC.

Returns
Type	Description
`TaskQueryExtensionResponse`	A Task containing the RPC response.

Example

// Create client
ExtensionExecutionServiceClient extensionExecutionServiceClient = await ExtensionExecutionServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/extensions/[EXTENSION]";
IEnumerable<Content> contents = new Content[] { new Content(), };
// Make the request
QueryExtensionResponse response = await extensionExecutionServiceClient.QueryExtensionAsync(name, contents);

ShutdownDefaultChannelsAsync()

public static Task ShutdownDefaultChannelsAsync()

Shuts down any channels automatically created by Create() and CreateAsync(CancellationToken). Channels which weren't automatically created are not affected.

Returns
Type	Description
`Task`	A task representing the asynchronous shutdown operation.

Remarks

After calling this method, further calls to Create() and CreateAsync(CancellationToken) will create new channels, which could in turn be shut down by another call to this method.