Class v1.ToolServiceClient (0.3.0)

Tool service provides APIs for interacting with CES tools. v1

Package

@google-cloud/ces

Constructors

(constructor)(opts, gaxInstance)

  constructor 
 ( 
 opts 
 ?: 
  
 ClientOptions 
 , 
  
 gaxInstance 
 ?: 
  
 typeof 
  
 gax 
  
 | 
  
 typeof 
  
 gax 
 . 
 fallback 
 ); 
 

Construct an instance of ToolServiceClient.

Parameters
Name
Description
opts
ClientOptions
gaxInstance
typeof gax | typeof fallback

: loaded instance of google-gax . Useful if you need to avoid loading the default gRPC version and want to use the fallback HTTP implementation. Load only fallback version and pass it to the constructor: ``` const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC const client = new ToolServiceClient({fallback: true}, gax); ```

Properties

apiEndpoint

  get 
  
 apiEndpoint 
 () 
 : 
  
 string 
 ; 
 

The DNS address for this API service.

apiEndpoint

  static 
  
 get 
  
 apiEndpoint 
 () 
 : 
  
 string 
 ; 
 

The DNS address for this API service - same as servicePath.

auth

  auth 
 : 
  
 gax 
 . 
 GoogleAuth 
 ; 
 

descriptors

  descriptors 
 : 
  
 Descriptors 
 ; 
 

innerApiCalls

  innerApiCalls 
 : 
  
 { 
  
 [ 
 name 
 : 
  
 string 
 ] 
 : 
  
 Function 
 ; 
  
 }; 
 

locationsClient

  locationsClient 
 : 
  
 LocationsClient 
 ; 
 

pathTemplates

  pathTemplates 
 : 
  
 { 
  
 [ 
 name 
 : 
  
 string 
 ] 
 : 
  
 gax 
 . 
 PathTemplate 
 ; 
  
 }; 
 

port

  static 
  
 get 
  
 port 
 () 
 : 
  
 number 
 ; 
 

The port for this API service.

scopes

  static 
  
 get 
  
 scopes 
 () 
 : 
  
 string 
 []; 
 

The scopes needed to make gRPC calls for every method defined in this service.

servicePath

  static 
  
 get 
  
 servicePath 
 () 
 : 
  
 string 
 ; 
 

The DNS address for this API service.

toolServiceStub

  toolServiceStub 
 ?: 
  
 Promise 
< { 
  
 [ 
 name 
 : 
  
 string 
 ] 
 : 
  
 Function 
 ; 
  
 }>; 
 

universeDomain

  get 
  
 universeDomain 
 () 
 : 
  
 string 
 ; 
 

warn

  warn 
 : 
  
 ( 
 code 
 : 
  
 string 
 , 
  
 message 
 : 
  
 string 
 , 
  
 warnType 
 ?: 
  
 string 
 ) 
  
 = 
>  
 void 
 ; 
 

Methods

agentPath(project, location, app, agent)

  agentPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 agent 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified agent resource name string.

Parameters
Name
Description
project
string
location
string
app
string
agent
string
Returns
Type
Description
string

{string} Resource name string.

appPath(project, location, app)

  appPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified app resource name string.

Parameters
Name
Description
project
string
location
string
app
string
Returns
Type
Description
string

{string} Resource name string.

appVersionPath(project, location, app, version)

  appVersionPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 version 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified appVersion resource name string.

Parameters
Name
Description
project
string
location
string
app
string
version
string
Returns
Type
Description
string

{string} Resource name string.

changelogPath(project, location, app, changelog)

  changelogPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 changelog 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified changelog resource name string.

Parameters
Name
Description
project
string
location
string
app
string
changelog
string
Returns
Type
Description
string

{string} Resource name string.

close()

  close 
 () 
 : 
  
 Promise<void> 
 ; 
 

Terminate the gRPC channel and close the client.

The client will no longer be usable and all future behavior is undefined.

Returns
Type
Description
Promise <void>

{Promise} A promise that resolves when the client is closed.

conversationPath(project, location, app, conversation)

  conversationPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 conversation 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified conversation resource name string.

Parameters
Name
Description
project
string
location
string
app
string
conversation
string
Returns
Type
Description
string

{string} Resource name string.

deploymentPath(project, location, app, deployment)

  deploymentPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 deployment 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified deployment resource name string.

Parameters
Name
Description
project
string
location
string
app
string
deployment
string
Returns
Type
Description
string

{string} Resource name string.

examplePath(project, location, app, example)

  examplePath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 example 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified example resource name string.

Parameters
Name
Description
project
string
location
string
app
string
example
string
Returns
Type
Description
string

{string} Resource name string.

executeTool(request, options)

  executeTool 
 ( 
 request 
 ?: 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
 , 
  
 options 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 Promise 
< [ 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 undefined 
  
 ]>; 
 

Executes the given tool with the given arguments.

Parameters
Name
Description
request
IExecuteToolRequest

The request object that will be sent.

options
CallOptions

Call options. See CallOptions for more details.

Returns
Type
Description

{Promise} - The promise which resolves to an array. The first element of the array is an object representing ExecuteToolResponse . Please see the documentation for more details and examples.

Example
   
 /** 
 * This snippet has been automatically generated and should be regarded as a code template only. 
 * It will require modifications to work. 
 * It may require correct/in-range values for request initialization. 
 * TODO(developer): Uncomment these variables before running the sample. 
 */ 
  
 /** 
 *  Optional. The name of the tool to execute. 
 *  Format: 
 *  projects/{project}/locations/{location}/apps/{app}/tools/{tool} 
 */ 
  
 // const tool = 'abc123' 
  
 /** 
 *  Optional. The toolset tool to execute. Only one tool should match the 
 *  predicate from the toolset. Otherwise, an error will be returned. 
 */ 
  
 // const toolsetTool = {} 
  
 /** 
 *  Optional. The variables that are available for the tool execution. 
 */ 
  
 // const variables = {} 
  
 /** 
 *  Optional. The 
 *  ToolCallContext (https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/python#environment 
 *  for details) to be passed to the Python tool. 
 */ 
  
 // const context = {} 
  
 /** 
 *  Required. The resource name of the app which the tool/toolset belongs to. 
 *  Format: `projects/{project}/locations/{location}/apps/{app}` 
 */ 
  
 // const parent = 'abc123' 
  
 /** 
 *  Optional. The input parameters and values for the tool in JSON object 
 *  format. 
 */ 
  
 // const args = {} 
  
 // Imports the Ces library 
  
 const 
  
 { 
 ToolServiceClient 
 } 
  
 = 
  
 require 
 ( 
 ' @google-cloud/ces 
' 
 ). 
 v1 
 ; 
  
 // Instantiates a client 
  
 const 
  
 cesClient 
  
 = 
  
 new 
  
  ToolServiceClient 
 
 (); 
  
 async 
  
 function 
  
 callExecuteTool 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 parent 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 response 
  
 = 
  
 await 
  
 cesClient 
 . 
 executeTool 
 ( 
 request 
 ); 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
  
 callExecuteTool 
 (); 
 

executeTool(request, options, callback)

  executeTool 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
 , 
  
 options 
 : 
  
 CallOptions 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
options
CallOptions
callback
Returns
Type
Description
void

executeTool(request, callback)

  executeTool 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IExecuteToolRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
callback
Returns
Type
Description
void

getLocation(request, options, callback)

  getLocation 
 ( 
 request 
 : 
  
 LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 IGetLocationRequest 
 , 
  
 options 
 ?: 
  
 gax 
 . 
 CallOptions 
  
 | 
  
 Callback<LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 ILocation 
 , 
  
 LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 IGetLocationRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> , 
  
 callback 
 ?: 
  
 Callback<LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 ILocation 
 , 
  
 LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 IGetLocationRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 Promise<LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 ILocation 
> ; 
 

Gets information about a location.

Parameters
Name
Description
request
LocationProtos.google.cloud.location.IGetLocationRequest

The request object that will be sent.

options
CallOptions | Callback < google.cloud.location.ILocation , google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>

Call options. See CallOptions for more details.

callback
Callback < google.cloud.location.ILocation , google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>
Returns
Type
Description
Promise < google.cloud.location.ILocation >

{Promise} - The promise which resolves to an array. The first element of the array is an object representing . Please see the documentation for more details and examples.

Example
  const 
  
 [ 
 response 
 ] 
  
 = 
  
 await 
  
 client 
 . 
 getLocation 
 ( 
 request 
 ); 
 

getProjectId()

  getProjectId 
 () 
 : 
  
 Promise<string> 
 ; 
 
Returns
Type
Description
Promise <string>

getProjectId(callback)

  getProjectId 
 ( 
 callback 
 : 
  
 Callback<string 
 , 
  
 undefined 
 , 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
callback
Callback <string, undefined, undefined>
Returns
Type
Description
void

guardrailPath(project, location, app, guardrail)

  guardrailPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 guardrail 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified guardrail resource name string.

Parameters
Name
Description
project
string
location
string
app
string
guardrail
string
Returns
Type
Description
string

{string} Resource name string.

initialize()

  initialize 
 () 
 : 
  
 Promise 
< { 
  
 [ 
 name 
 : 
  
 string 
 ] 
 : 
  
 Function 
 ; 
  
 }>; 
 

Initialize the client. Performs asynchronous operations (such as authentication) and prepares the client. This function will be called automatically when any class method is called for the first time, but if you need to initialize it before calling an actual method, feel free to call initialize() directly.

You can await on this method if you want to make sure the client is initialized.

Returns
Type
Description
Promise <{ [name: string]: Function ; }>

{Promise} A promise that resolves to an authenticated service stub.

listLocationsAsync(request, options)

  listLocationsAsync 
 ( 
 request 
 : 
  
 LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 IListLocationsRequest 
 , 
  
 options 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 AsyncIterable<LocationProtos 
 . 
 google 
 . 
 cloud 
 . 
 location 
 . 
 ILocation 
> ; 
 

Lists information about the supported locations for this service. Returns an iterable object.

for - await - of syntax is used with the iterable to get response elements on-demand.

Parameters
Name
Description
request
LocationProtos.google.cloud.location.IListLocationsRequest

The request object that will be sent.

options
CallOptions

Call options. See CallOptions for more details.

Returns
Type
Description
AsyncIterable < google.cloud.location.ILocation >

{Object} An iterable Object that allows async iteration . When you iterate the returned iterable, each element will be an object representing . The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  const 
  
 iterable 
  
 = 
  
 client 
 . 
 listLocationsAsync 
 ( 
 request 
 ); 
 for 
  
 await 
  
 ( 
 const 
  
 response 
  
 of 
  
 iterable 
 ) 
  
 { 
  
 // process response 
 } 
 

matchAgentFromAgentName(agentName)

  matchAgentFromAgentName 
 ( 
 agentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the agent from Agent resource.

Parameter
Name
Description
agentName
string

A fully-qualified path representing Agent resource.

Returns
Type
Description
string | number

{string} A string representing the agent.

matchAppFromAgentName(agentName)

  matchAppFromAgentName 
 ( 
 agentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Agent resource.

Parameter
Name
Description
agentName
string

A fully-qualified path representing Agent resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromAppName(appName)

  matchAppFromAppName 
 ( 
 appName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from App resource.

Parameter
Name
Description
appName
string

A fully-qualified path representing App resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromAppVersionName(appVersionName)

  matchAppFromAppVersionName 
 ( 
 appVersionName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from AppVersion resource.

Parameter
Name
Description
appVersionName
string

A fully-qualified path representing AppVersion resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromChangelogName(changelogName)

  matchAppFromChangelogName 
 ( 
 changelogName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Changelog resource.

Parameter
Name
Description
changelogName
string

A fully-qualified path representing Changelog resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromConversationName(conversationName)

  matchAppFromConversationName 
 ( 
 conversationName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Conversation resource.

Parameter
Name
Description
conversationName
string

A fully-qualified path representing Conversation resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromDeploymentName(deploymentName)

  matchAppFromDeploymentName 
 ( 
 deploymentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Deployment resource.

Parameter
Name
Description
deploymentName
string

A fully-qualified path representing Deployment resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromExampleName(exampleName)

  matchAppFromExampleName 
 ( 
 exampleName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Example resource.

Parameter
Name
Description
exampleName
string

A fully-qualified path representing Example resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromGuardrailName(guardrailName)

  matchAppFromGuardrailName 
 ( 
 guardrailName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Guardrail resource.

Parameter
Name
Description
guardrailName
string

A fully-qualified path representing Guardrail resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromToolName(toolName)

  matchAppFromToolName 
 ( 
 toolName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Tool resource.

Parameter
Name
Description
toolName
string

A fully-qualified path representing Tool resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchAppFromToolsetName(toolsetName)

  matchAppFromToolsetName 
 ( 
 toolsetName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the app from Toolset resource.

Parameter
Name
Description
toolsetName
string

A fully-qualified path representing Toolset resource.

Returns
Type
Description
string | number

{string} A string representing the app.

matchChangelogFromChangelogName(changelogName)

  matchChangelogFromChangelogName 
 ( 
 changelogName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the changelog from Changelog resource.

Parameter
Name
Description
changelogName
string

A fully-qualified path representing Changelog resource.

Returns
Type
Description
string | number

{string} A string representing the changelog.

matchConversationFromConversationName(conversationName)

  matchConversationFromConversationName 
 ( 
 conversationName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the conversation from Conversation resource.

Parameter
Name
Description
conversationName
string

A fully-qualified path representing Conversation resource.

Returns
Type
Description
string | number

{string} A string representing the conversation.

matchDeploymentFromDeploymentName(deploymentName)

  matchDeploymentFromDeploymentName 
 ( 
 deploymentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the deployment from Deployment resource.

Parameter
Name
Description
deploymentName
string

A fully-qualified path representing Deployment resource.

Returns
Type
Description
string | number

{string} A string representing the deployment.

matchExampleFromExampleName(exampleName)

  matchExampleFromExampleName 
 ( 
 exampleName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the example from Example resource.

Parameter
Name
Description
exampleName
string

A fully-qualified path representing Example resource.

Returns
Type
Description
string | number

{string} A string representing the example.

matchGuardrailFromGuardrailName(guardrailName)

  matchGuardrailFromGuardrailName 
 ( 
 guardrailName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the guardrail from Guardrail resource.

Parameter
Name
Description
guardrailName
string

A fully-qualified path representing Guardrail resource.

Returns
Type
Description
string | number

{string} A string representing the guardrail.

matchLocationFromAgentName(agentName)

  matchLocationFromAgentName 
 ( 
 agentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Agent resource.

Parameter
Name
Description
agentName
string

A fully-qualified path representing Agent resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromAppName(appName)

  matchLocationFromAppName 
 ( 
 appName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from App resource.

Parameter
Name
Description
appName
string

A fully-qualified path representing App resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromAppVersionName(appVersionName)

  matchLocationFromAppVersionName 
 ( 
 appVersionName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from AppVersion resource.

Parameter
Name
Description
appVersionName
string

A fully-qualified path representing AppVersion resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromChangelogName(changelogName)

  matchLocationFromChangelogName 
 ( 
 changelogName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Changelog resource.

Parameter
Name
Description
changelogName
string

A fully-qualified path representing Changelog resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromConversationName(conversationName)

  matchLocationFromConversationName 
 ( 
 conversationName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Conversation resource.

Parameter
Name
Description
conversationName
string

A fully-qualified path representing Conversation resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromDeploymentName(deploymentName)

  matchLocationFromDeploymentName 
 ( 
 deploymentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Deployment resource.

Parameter
Name
Description
deploymentName
string

A fully-qualified path representing Deployment resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromExampleName(exampleName)

  matchLocationFromExampleName 
 ( 
 exampleName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Example resource.

Parameter
Name
Description
exampleName
string

A fully-qualified path representing Example resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromGuardrailName(guardrailName)

  matchLocationFromGuardrailName 
 ( 
 guardrailName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Guardrail resource.

Parameter
Name
Description
guardrailName
string

A fully-qualified path representing Guardrail resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromOmnichannelName(omnichannelName)

  matchLocationFromOmnichannelName 
 ( 
 omnichannelName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Omnichannel resource.

Parameter
Name
Description
omnichannelName
string

A fully-qualified path representing Omnichannel resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromSecuritySettingsName(securitySettingsName)

  matchLocationFromSecuritySettingsName 
 ( 
 securitySettingsName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from SecuritySettings resource.

Parameter
Name
Description
securitySettingsName
string

A fully-qualified path representing SecuritySettings resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromToolName(toolName)

  matchLocationFromToolName 
 ( 
 toolName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Tool resource.

Parameter
Name
Description
toolName
string

A fully-qualified path representing Tool resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchLocationFromToolsetName(toolsetName)

  matchLocationFromToolsetName 
 ( 
 toolsetName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the location from Toolset resource.

Parameter
Name
Description
toolsetName
string

A fully-qualified path representing Toolset resource.

Returns
Type
Description
string | number

{string} A string representing the location.

matchOmnichannelFromOmnichannelName(omnichannelName)

  matchOmnichannelFromOmnichannelName 
 ( 
 omnichannelName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the omnichannel from Omnichannel resource.

Parameter
Name
Description
omnichannelName
string

A fully-qualified path representing Omnichannel resource.

Returns
Type
Description
string | number

{string} A string representing the omnichannel.

matchProjectFromAgentName(agentName)

  matchProjectFromAgentName 
 ( 
 agentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Agent resource.

Parameter
Name
Description
agentName
string

A fully-qualified path representing Agent resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromAppName(appName)

  matchProjectFromAppName 
 ( 
 appName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from App resource.

Parameter
Name
Description
appName
string

A fully-qualified path representing App resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromAppVersionName(appVersionName)

  matchProjectFromAppVersionName 
 ( 
 appVersionName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from AppVersion resource.

Parameter
Name
Description
appVersionName
string

A fully-qualified path representing AppVersion resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromChangelogName(changelogName)

  matchProjectFromChangelogName 
 ( 
 changelogName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Changelog resource.

Parameter
Name
Description
changelogName
string

A fully-qualified path representing Changelog resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromConversationName(conversationName)

  matchProjectFromConversationName 
 ( 
 conversationName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Conversation resource.

Parameter
Name
Description
conversationName
string

A fully-qualified path representing Conversation resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromDeploymentName(deploymentName)

  matchProjectFromDeploymentName 
 ( 
 deploymentName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Deployment resource.

Parameter
Name
Description
deploymentName
string

A fully-qualified path representing Deployment resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromExampleName(exampleName)

  matchProjectFromExampleName 
 ( 
 exampleName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Example resource.

Parameter
Name
Description
exampleName
string

A fully-qualified path representing Example resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromGuardrailName(guardrailName)

  matchProjectFromGuardrailName 
 ( 
 guardrailName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Guardrail resource.

Parameter
Name
Description
guardrailName
string

A fully-qualified path representing Guardrail resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromOmnichannelName(omnichannelName)

  matchProjectFromOmnichannelName 
 ( 
 omnichannelName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Omnichannel resource.

Parameter
Name
Description
omnichannelName
string

A fully-qualified path representing Omnichannel resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromSecuritySettingsName(securitySettingsName)

  matchProjectFromSecuritySettingsName 
 ( 
 securitySettingsName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from SecuritySettings resource.

Parameter
Name
Description
securitySettingsName
string

A fully-qualified path representing SecuritySettings resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromToolName(toolName)

  matchProjectFromToolName 
 ( 
 toolName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Tool resource.

Parameter
Name
Description
toolName
string

A fully-qualified path representing Tool resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchProjectFromToolsetName(toolsetName)

  matchProjectFromToolsetName 
 ( 
 toolsetName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the project from Toolset resource.

Parameter
Name
Description
toolsetName
string

A fully-qualified path representing Toolset resource.

Returns
Type
Description
string | number

{string} A string representing the project.

matchToolFromToolName(toolName)

  matchToolFromToolName 
 ( 
 toolName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the tool from Tool resource.

Parameter
Name
Description
toolName
string

A fully-qualified path representing Tool resource.

Returns
Type
Description
string | number

{string} A string representing the tool.

matchToolsetFromToolsetName(toolsetName)

  matchToolsetFromToolsetName 
 ( 
 toolsetName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the toolset from Toolset resource.

Parameter
Name
Description
toolsetName
string

A fully-qualified path representing Toolset resource.

Returns
Type
Description
string | number

{string} A string representing the toolset.

matchVersionFromAppVersionName(appVersionName)

  matchVersionFromAppVersionName 
 ( 
 appVersionName 
 : 
  
 string 
 ) 
 : 
  
 string 
  
 | 
  
 number 
 ; 
 

Parse the version from AppVersion resource.

Parameter
Name
Description
appVersionName
string

A fully-qualified path representing AppVersion resource.

Returns
Type
Description
string | number

{string} A string representing the version.

omnichannelPath(project, location, omnichannel)

  omnichannelPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 omnichannel 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified omnichannel resource name string.

Parameters
Name
Description
project
string
location
string
omnichannel
string
Returns
Type
Description
string

{string} Resource name string.

retrieveTools(request, options)

  retrieveTools 
 ( 
 request 
 ?: 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
 , 
  
 options 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 Promise 
< [ 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 undefined 
  
 ]>; 
 

Retrieve the list of tools included in the specified toolset.

Parameters
Name
Description
request
IRetrieveToolsRequest

The request object that will be sent.

options
CallOptions

Call options. See CallOptions for more details.

Returns
Type
Description

{Promise} - The promise which resolves to an array. The first element of the array is an object representing RetrieveToolsResponse . Please see the documentation for more details and examples.

Example
   
 /** 
 * This snippet has been automatically generated and should be regarded as a code template only. 
 * It will require modifications to work. 
 * It may require correct/in-range values for request initialization. 
 * TODO(developer): Uncomment these variables before running the sample. 
 */ 
  
 /** 
 *  Required. The name of the toolset to retrieve the tools for. 
 *  Format: 
 *  `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` 
 */ 
  
 // const toolset = 'abc123' 
  
 /** 
 *  Optional. The identifiers of the tools to retrieve from the toolset. 
 *  If empty, all tools in the toolset will be returned. 
 */ 
  
 // const toolIds = ['abc','def'] 
  
 // Imports the Ces library 
  
 const 
  
 { 
 ToolServiceClient 
 } 
  
 = 
  
 require 
 ( 
 ' @google-cloud/ces 
' 
 ). 
 v1 
 ; 
  
 // Instantiates a client 
  
 const 
  
 cesClient 
  
 = 
  
 new 
  
  ToolServiceClient 
 
 (); 
  
 async 
  
 function 
  
 callRetrieveTools 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 toolset 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 response 
  
 = 
  
 await 
  
 cesClient 
 . 
 retrieveTools 
 ( 
 request 
 ); 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
  
 callRetrieveTools 
 (); 
 

retrieveTools(request, options, callback)

  retrieveTools 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
 , 
  
 options 
 : 
  
 CallOptions 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
options
CallOptions
callback
Returns
Type
Description
void

retrieveTools(request, callback)

  retrieveTools 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolsRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
callback
Returns
Type
Description
void

retrieveToolSchema(request, options)

  retrieveToolSchema 
 ( 
 request 
 ?: 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
 , 
  
 options 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 Promise 
< [ 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 undefined 
  
 ]>; 
 

Retrieve the schema of the given tool. The schema is computed on the fly for the given instance of the tool.

Parameters
Name
Description
request
IRetrieveToolSchemaRequest

The request object that will be sent.

options
CallOptions

Call options. See CallOptions for more details.

Returns
Type
Description

{Promise} - The promise which resolves to an array. The first element of the array is an object representing RetrieveToolSchemaResponse . Please see the documentation for more details and examples.

Example
   
 /** 
 * This snippet has been automatically generated and should be regarded as a code template only. 
 * It will require modifications to work. 
 * It may require correct/in-range values for request initialization. 
 * TODO(developer): Uncomment these variables before running the sample. 
 */ 
  
 /** 
 *  Optional. The name of the tool to retrieve the schema for. 
 *  Format: 
 *  projects/{project}/locations/{location}/apps/{app}/tools/{tool} 
 */ 
  
 // const tool = 'abc123' 
  
 /** 
 *  Optional. The toolset tool to retrieve the schema for. Only one tool 
 *  should match the predicate from the toolset. Otherwise, an error will be 
 *  returned. 
 */ 
  
 // const toolsetTool = {} 
  
 /** 
 *  Required. The resource name of the app which the tool/toolset belongs to. 
 *  Format: `projects/{project}/locations/{location}/apps/{app}` 
 */ 
  
 // const parent = 'abc123' 
  
 // Imports the Ces library 
  
 const 
  
 { 
 ToolServiceClient 
 } 
  
 = 
  
 require 
 ( 
 ' @google-cloud/ces 
' 
 ). 
 v1 
 ; 
  
 // Instantiates a client 
  
 const 
  
 cesClient 
  
 = 
  
 new 
  
  ToolServiceClient 
 
 (); 
  
 async 
  
 function 
  
 callRetrieveToolSchema 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 parent 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 response 
  
 = 
  
 await 
  
 cesClient 
 . 
 retrieveToolSchema 
 ( 
 request 
 ); 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
  
 callRetrieveToolSchema 
 (); 
 

retrieveToolSchema(request, options, callback)

  retrieveToolSchema 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
 , 
  
 options 
 : 
  
 CallOptions 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
options
CallOptions
Returns
Type
Description
void

retrieveToolSchema(request, callback)

  retrieveToolSchema 
 ( 
 request 
 : 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
 , 
  
 callback 
 : 
  
 Callback<protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaResponse 
 , 
  
 protos 
 . 
 google 
 . 
 cloud 
 . 
 ces 
 . 
 v1 
 . 
 IRetrieveToolSchemaRequest 
  
 | 
  
 null 
  
 | 
  
 undefined 
 , 
  
 {} 
  
 | 
  
 null 
  
 | 
  
 undefined 
> ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
Returns
Type
Description
void

securitySettingsPath(project, location)

  securitySettingsPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified securitySettings resource name string.

Parameters
Name
Description
project
string
location
string
Returns
Type
Description
string

{string} Resource name string.

toolPath(project, location, app, tool)

  toolPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 tool 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified tool resource name string.

Parameters
Name
Description
project
string
location
string
app
string
tool
string
Returns
Type
Description
string

{string} Resource name string.

toolsetPath(project, location, app, toolset)

  toolsetPath 
 ( 
 project 
 : 
  
 string 
 , 
  
 location 
 : 
  
 string 
 , 
  
 app 
 : 
  
 string 
 , 
  
 toolset 
 : 
  
 string 
 ) 
 : 
  
 string 
 ; 
 

Return a fully-qualified toolset resource name string.

Parameters
Name
Description
project
string
location
string
app
string
toolset
string
Returns
Type
Description
string

{string} Resource name string.

Create a Mobile Website
View Site in Mobile | Classic
Share by: