Class SessionEntityTypesClient (0.11.5) 

public class SessionEntityTypesClient implements BackgroundResource

Service Description: Service for managing SessionEntityTypes.

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionEntityTypeName name =
       SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
           "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]");
   SessionEntityType response = sessionEntityTypesClient.getSessionEntityType(name);
 }

Note: close() needs to be called on the SessionEntityTypesClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

  1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
  2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
  3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of SessionEntityTypesSettings to create(). For example:

To customize credentials:


 SessionEntityTypesSettings sessionEntityTypesSettings =
     SessionEntityTypesSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 SessionEntityTypesClient sessionEntityTypesClient =
     SessionEntityTypesClient.create(sessionEntityTypesSettings);

To customize the endpoint:


 SessionEntityTypesSettings sessionEntityTypesSettings =
     SessionEntityTypesSettings.newBuilder().setEndpoint(myEndpoint).build();
 SessionEntityTypesClient sessionEntityTypesClient =
     SessionEntityTypesClient.create(sessionEntityTypesSettings);

Please refer to the GitHub repository's samples for more quickstart code snippets.

Inheritance

java.lang.Object > SessionEntityTypesClient

Implements

BackgroundResource

Static Methods

create()

public static final SessionEntityTypesClient create()

Constructs an instance of SessionEntityTypesClient with default settings.

Returns
Type Description
SessionEntityTypesClient
Exceptions
Type Description
IOException

create(SessionEntityTypesSettings settings)

public static final SessionEntityTypesClient create(SessionEntityTypesSettings settings)

Constructs an instance of SessionEntityTypesClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Parameter
Name Description
settings SessionEntityTypesSettings
Returns
Type Description
SessionEntityTypesClient
Exceptions
Type Description
IOException

create(SessionEntityTypesStub stub)

public static final SessionEntityTypesClient create(SessionEntityTypesStub stub)

Constructs an instance of SessionEntityTypesClient, using the given stub for making calls. This is for advanced usage - prefer using create(SessionEntityTypesSettings).

Parameter
Name Description
stub SessionEntityTypesStub
Returns
Type Description
SessionEntityTypesClient

Constructors

SessionEntityTypesClient(SessionEntityTypesSettings settings)

protected SessionEntityTypesClient(SessionEntityTypesSettings settings)

Constructs an instance of SessionEntityTypesClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.

Parameter
Name Description
settings SessionEntityTypesSettings

SessionEntityTypesClient(SessionEntityTypesStub stub)

protected SessionEntityTypesClient(SessionEntityTypesStub stub)
Parameter
Name Description
stub SessionEntityTypesStub

Methods

awaitTermination(long duration, TimeUnit unit)

public boolean awaitTermination(long duration, TimeUnit unit)
Parameters
Name Description
duration long
unit TimeUnit
Returns
Type Description
boolean
Exceptions
Type Description
InterruptedException

close()

public final void close()

createSessionEntityType(CreateSessionEntityTypeRequest request)

public final SessionEntityType createSessionEntityType(CreateSessionEntityTypeRequest request)

Creates a session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   CreateSessionEntityTypeRequest request =
       CreateSessionEntityTypeRequest.newBuilder()
           .setParent(
               SessionName.ofProjectLocationAgentSessionName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
                   .toString())
           .setSessionEntityType(SessionEntityType.newBuilder().build())
           .build();
   SessionEntityType response = sessionEntityTypesClient.createSessionEntityType(request);
 }
Parameter
Name Description
request CreateSessionEntityTypeRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
SessionEntityType

createSessionEntityType(SessionName parent, SessionEntityType sessionEntityType)

public final SessionEntityType createSessionEntityType(SessionName parent, SessionEntityType sessionEntityType)

Creates a session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionName parent =
       SessionName.ofProjectLocationAgentSessionName(
           "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]");
   SessionEntityType sessionEntityType = SessionEntityType.newBuilder().build();
   SessionEntityType response =
       sessionEntityTypesClient.createSessionEntityType(parent, sessionEntityType);
 }
Parameters
Name Description
parent SessionName

Required. The session to create a session entity type for. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment.
sessionEntityType SessionEntityType

Required. The session entity type to create.
Returns
Type Description
SessionEntityType

createSessionEntityType(String parent, SessionEntityType sessionEntityType)

public final SessionEntityType createSessionEntityType(String parent, SessionEntityType sessionEntityType)

Creates a session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   String parent =
       SessionName.ofProjectLocationAgentSessionName(
               "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
           .toString();
   SessionEntityType sessionEntityType = SessionEntityType.newBuilder().build();
   SessionEntityType response =
       sessionEntityTypesClient.createSessionEntityType(parent, sessionEntityType);
 }
Parameters
Name Description
parent String

Required. The session to create a session entity type for. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment.
sessionEntityType SessionEntityType

Required. The session entity type to create.
Returns
Type Description
SessionEntityType

createSessionEntityTypeCallable()

public final UnaryCallable<CreateSessionEntityTypeRequest,SessionEntityType> createSessionEntityTypeCallable()

Creates a session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   CreateSessionEntityTypeRequest request =
       CreateSessionEntityTypeRequest.newBuilder()
           .setParent(
               SessionName.ofProjectLocationAgentSessionName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
                   .toString())
           .setSessionEntityType(SessionEntityType.newBuilder().build())
           .build();
   ApiFuture
Returns
Type Description
UnaryCallable<CreateSessionEntityTypeRequest,SessionEntityType>

deleteSessionEntityType(DeleteSessionEntityTypeRequest request)

public final void deleteSessionEntityType(DeleteSessionEntityTypeRequest request)

Deletes the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   DeleteSessionEntityTypeRequest request =
       DeleteSessionEntityTypeRequest.newBuilder()
           .setName(
               SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
                   .toString())
           .build();
   sessionEntityTypesClient.deleteSessionEntityType(request);
 }
Parameter
Name Description
request DeleteSessionEntityTypeRequest

The request object containing all of the parameters for the API call.

deleteSessionEntityType(SessionEntityTypeName name)

public final void deleteSessionEntityType(SessionEntityTypeName name)

Deletes the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionEntityTypeName name =
       SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
           "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]");
   sessionEntityTypesClient.deleteSessionEntityType(name);
 }
Parameter
Name Description
name SessionEntityTypeName

Required. The name of the session entity type to delete. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>/entityTypes/<Entity Type ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>/entityTypes/<Entity Type ID>. If Environment ID is not specified, we assume default 'draft' environment.

deleteSessionEntityType(String name)

public final void deleteSessionEntityType(String name)

Deletes the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   String name =
       SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
               "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
           .toString();
   sessionEntityTypesClient.deleteSessionEntityType(name);
 }
Parameter
Name Description
name String

Required. The name of the session entity type to delete. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>/entityTypes/<Entity Type ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>/entityTypes/<Entity Type ID>. If Environment ID is not specified, we assume default 'draft' environment.

deleteSessionEntityTypeCallable()

public final UnaryCallable<DeleteSessionEntityTypeRequest,Empty> deleteSessionEntityTypeCallable()

Deletes the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   DeleteSessionEntityTypeRequest request =
       DeleteSessionEntityTypeRequest.newBuilder()
           .setName(
               SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
                   .toString())
           .build();
   ApiFuture<Empty> future =
       sessionEntityTypesClient.deleteSessionEntityTypeCallable().futureCall(request);
   // Do something.
   future.get();
 }
Returns
Type Description
UnaryCallable<DeleteSessionEntityTypeRequest,Empty>

getSessionEntityType(GetSessionEntityTypeRequest request)

public final SessionEntityType getSessionEntityType(GetSessionEntityTypeRequest request)

Retrieves the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   GetSessionEntityTypeRequest request =
       GetSessionEntityTypeRequest.newBuilder()
           .setName(
               SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
                   .toString())
           .build();
   SessionEntityType response = sessionEntityTypesClient.getSessionEntityType(request);
 }
Parameter
Name Description
request GetSessionEntityTypeRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
SessionEntityType

getSessionEntityType(SessionEntityTypeName name)

public final SessionEntityType getSessionEntityType(SessionEntityTypeName name)

Retrieves the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionEntityTypeName name =
       SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
           "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]");
   SessionEntityType response = sessionEntityTypesClient.getSessionEntityType(name);
 }
Parameter
Name Description
name SessionEntityTypeName

Required. The name of the session entity type. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>/entityTypes/<Entity Type ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>/entityTypes/<Entity Type ID>. If Environment ID is not specified, we assume default 'draft' environment.
Returns
Type Description
SessionEntityType

getSessionEntityType(String name)

public final SessionEntityType getSessionEntityType(String name)

Retrieves the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   String name =
       SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
               "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
           .toString();
   SessionEntityType response = sessionEntityTypesClient.getSessionEntityType(name);
 }
Parameter
Name Description
name String

Required. The name of the session entity type. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>/entityTypes/<Entity Type ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>/entityTypes/<Entity Type ID>. If Environment ID is not specified, we assume default 'draft' environment.
Returns
Type Description
SessionEntityType

getSessionEntityTypeCallable()

public final UnaryCallable<GetSessionEntityTypeRequest,SessionEntityType> getSessionEntityTypeCallable()

Retrieves the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   GetSessionEntityTypeRequest request =
       GetSessionEntityTypeRequest.newBuilder()
           .setName(
               SessionEntityTypeName.ofProjectLocationAgentSessionEntityTypeName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]", "[ENTITY_TYPE]")
                   .toString())
           .build();
   ApiFuture
Returns
Type Description
UnaryCallable<GetSessionEntityTypeRequest,SessionEntityType>

getSettings()

public final SessionEntityTypesSettings getSettings()
Returns
Type Description
SessionEntityTypesSettings

getStub()

public SessionEntityTypesStub getStub()
Returns
Type Description
SessionEntityTypesStub

isShutdown()

public boolean isShutdown()
Returns
Type Description
boolean

isTerminated()

public boolean isTerminated()
Returns
Type Description
boolean

listSessionEntityTypes(ListSessionEntityTypesRequest request)

public final SessionEntityTypesClient.ListSessionEntityTypesPagedResponse listSessionEntityTypes(ListSessionEntityTypesRequest request)

Returns the list of all session entity types in the specified session.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   ListSessionEntityTypesRequest request =
       ListSessionEntityTypesRequest.newBuilder()
           .setParent(
               SessionName.ofProjectLocationAgentSessionName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (SessionEntityType element :
       sessionEntityTypesClient.listSessionEntityTypes(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
Parameter
Name Description
request ListSessionEntityTypesRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
SessionEntityTypesClient.ListSessionEntityTypesPagedResponse

listSessionEntityTypes(SessionName parent)

public final SessionEntityTypesClient.ListSessionEntityTypesPagedResponse listSessionEntityTypes(SessionName parent)

Returns the list of all session entity types in the specified session.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionName parent =
       SessionName.ofProjectLocationAgentSessionName(
           "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]");
   for (SessionEntityType element :
       sessionEntityTypesClient.listSessionEntityTypes(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
Parameter
Name Description
parent SessionName

Required. The session to list all session entity types from. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment.
Returns
Type Description
SessionEntityTypesClient.ListSessionEntityTypesPagedResponse

listSessionEntityTypes(String parent)

public final SessionEntityTypesClient.ListSessionEntityTypesPagedResponse listSessionEntityTypes(String parent)

Returns the list of all session entity types in the specified session.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   String parent =
       SessionName.ofProjectLocationAgentSessionName(
               "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
           .toString();
   for (SessionEntityType element :
       sessionEntityTypesClient.listSessionEntityTypes(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
Parameter
Name Description
parent String

Required. The session to list all session entity types from. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment.
Returns
Type Description
SessionEntityTypesClient.ListSessionEntityTypesPagedResponse

listSessionEntityTypesCallable()

public final UnaryCallable<ListSessionEntityTypesRequest,ListSessionEntityTypesResponse> listSessionEntityTypesCallable()

Returns the list of all session entity types in the specified session.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   ListSessionEntityTypesRequest request =
       ListSessionEntityTypesRequest.newBuilder()
           .setParent(
               SessionName.ofProjectLocationAgentSessionName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListSessionEntityTypesResponse response =
         sessionEntityTypesClient.listSessionEntityTypesCallable().call(request);
     for (SessionEntityType element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
Returns
Type Description
UnaryCallable<ListSessionEntityTypesRequest,ListSessionEntityTypesResponse>

listSessionEntityTypesPagedCallable()

public final UnaryCallable<ListSessionEntityTypesRequest,SessionEntityTypesClient.ListSessionEntityTypesPagedResponse> listSessionEntityTypesPagedCallable()

Returns the list of all session entity types in the specified session.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   ListSessionEntityTypesRequest request =
       ListSessionEntityTypesRequest.newBuilder()
           .setParent(
               SessionName.ofProjectLocationAgentSessionName(
                       "[PROJECT]", "[LOCATION]", "[AGENT]", "[SESSION]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture
Returns
Type Description
UnaryCallable<ListSessionEntityTypesRequest,ListSessionEntityTypesPagedResponse>

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

updateSessionEntityType(SessionEntityType sessionEntityType, FieldMask updateMask)

public final SessionEntityType updateSessionEntityType(SessionEntityType sessionEntityType, FieldMask updateMask)

Updates the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   SessionEntityType sessionEntityType = SessionEntityType.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   SessionEntityType response =
       sessionEntityTypesClient.updateSessionEntityType(sessionEntityType, updateMask);
 }
Parameters
Name Description
sessionEntityType SessionEntityType

Required. The session entity type to update. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/sessions/<Session ID>/entityTypes/<Entity Type ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID>/sessions/<Session ID>/entityTypes/<Entity Type ID>. If Environment ID is not specified, we assume default 'draft' environment.
updateMask FieldMask

The mask to control which fields get updated.
Returns
Type Description
SessionEntityType

updateSessionEntityType(UpdateSessionEntityTypeRequest request)

public final SessionEntityType updateSessionEntityType(UpdateSessionEntityTypeRequest request)

Updates the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   UpdateSessionEntityTypeRequest request =
       UpdateSessionEntityTypeRequest.newBuilder()
           .setSessionEntityType(SessionEntityType.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   SessionEntityType response = sessionEntityTypesClient.updateSessionEntityType(request);
 }
Parameter
Name Description
request UpdateSessionEntityTypeRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
SessionEntityType

updateSessionEntityTypeCallable()

public final UnaryCallable<UpdateSessionEntityTypeRequest,SessionEntityType> updateSessionEntityTypeCallable()

Updates the specified session entity type.

Sample code:


 try (SessionEntityTypesClient sessionEntityTypesClient = SessionEntityTypesClient.create()) {
   UpdateSessionEntityTypeRequest request =
       UpdateSessionEntityTypeRequest.newBuilder()
           .setSessionEntityType(SessionEntityType.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture
Returns
Type Description
UnaryCallable<UpdateSessionEntityTypeRequest,SessionEntityType>