| GitHub Repository | Product Reference | REST Documentation |
Service Description: Enables developers to build Chat apps and integrations on Google Chat Platform.
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:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName parent = SpaceName.of("[SPACE]");
Message message = Message.newBuilder().build();
String messageId = "messageId-1440013438";
Message response = chatServiceClient.createMessage(parent, message, messageId);
}
Note: close() needs to be called on the ChatServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
| Method | Description | Method Variants |
|---|---|---|
CreateMessage |
Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see Send a message. Calling this method requires authentication and supports the following authentication types: - For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.) |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListMessages |
Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListMemberships |
Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to. Requires authentication. Supports app authentication and user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetMembership |
Returns details about a membership. For an example, see Get details about a user's or Google Chat app's membership. Requires authentication. Supports app authentication and user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetMessage |
Returns details about a message. For an example, see Get details about a message. Requires authentication. Supports app authentication and user authentication. Note: Might return a message from a blocked member or space. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateMessage |
Updates a message. There's a difference between the Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only update messages created by the calling Chat app. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteMessage |
Deletes a message. For an example, see Delete a message. Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only delete messages created by the calling Chat app. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetAttachment |
Gets the metadata of a message attachment. The attachment data is fetched using the media API. For an example, see Get metadata about a message attachment. Requires app authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UploadAttachment |
Uploads an attachment. For an example, see Upload media as a file attachment. Requires user authentication. You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see File types blocked by Google Chat. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListSpaces |
Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces. Requires authentication. Supports app authentication and user authentication. Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetSpace |
Returns details about a space. For an example, see Get details about a space. Requires authentication. Supports app authentication and user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CreateSpace |
Creates a named space. Spaces grouped by topics aren't supported. For an example, see Create a space. If you receive the error message Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
SetUpSpace |
Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see Set up a space with initial members. To specify the human members to add, add memberships with the appropriate For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateSpace |
Updates a space. For an example, see Update a space. If you're updating the Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteSpace |
Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space. Requires user authentication from a user who has permission to delete the space. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CompleteImportSpace |
Completes the import process for the specified space and makes it visible to users. Requires app authentication and domain-wide delegation. For more information, see Authorize Google Chat apps to import data. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
FindDirectMessage |
Returns the existing direct message with the specified user. If no direct message space is found, returns a With user authentication, returns the direct message space between the specified user and the authenticated user. With app authentication, returns the direct message space between the specified user and the calling Chat app. Requires user authentication or app authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CreateMembership |
Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication. To specify the member to add, set the - To add the calling app to a space or a direct message between two human users, use - To add a human user, use |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateMembership |
Updates a membership. For an example, see Update a user's membership in a space. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteMembership |
Deletes a membership. For an example, see Remove a user or a Google Chat app from a space. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CreateReaction |
Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see Add a reaction to a message. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListReactions |
Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteReaction |
Deletes a reaction to a message. Only unicode emojis are supported. For an example, see Delete a reaction. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetSpaceReadState |
Returns details about a user's read state within a space, used to identify read and unread messages. For an example, see Get details about a user's space read state. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateSpaceReadState |
Updates a user's read state within a space, used to identify read and unread messages. For an example, see Update a user's space read state. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetThreadReadState |
Returns details about a user's read state within a thread, used to identify read and unread messages. For an example, see Get details about a user's thread read state. Requires user authentication. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return 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 ChatServiceSettings to create(). For example:
To customize credentials:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ChatServiceSettings chatServiceSettings =
ChatServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
To customize the endpoint:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ChatServiceSettings chatServiceSettings =
ChatServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ChatServiceSettings chatServiceSettings = ChatServiceSettings.newHttpJsonBuilder().build();
ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
Static Methods
create()
public static final ChatServiceClient create()Constructs an instance of ChatServiceClient with default settings.
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
create(ChatServiceSettings settings)
public static final ChatServiceClient create(ChatServiceSettings settings)Constructs an instance of ChatServiceClient, 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 |
ChatServiceSettings |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
create(ChatServiceStub stub)
public static final ChatServiceClient create(ChatServiceStub stub)Constructs an instance of ChatServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(ChatServiceSettings).
| Parameter | |
|---|---|
| Name | Description |
stub |
ChatServiceStub |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient |
|
Constructors
ChatServiceClient(ChatServiceSettings settings)
protected ChatServiceClient(ChatServiceSettings settings)Constructs an instance of ChatServiceClient, 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 |
ChatServiceSettings |
ChatServiceClient(ChatServiceStub stub)
protected ChatServiceClient(ChatServiceStub stub)| Parameter | |
|---|---|
| Name | Description |
stub |
ChatServiceStub |
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()completeImportSpace(CompleteImportSpaceRequest request)
public final CompleteImportSpaceResponse completeImportSpace(CompleteImportSpaceRequest request)Completes the import process for the specified space and makes it visible to users. Requires app authentication and domain-wide delegation. For more information, see Authorize Google Chat apps to import data.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CompleteImportSpaceRequest request =
CompleteImportSpaceRequest.newBuilder()
.setName(SpaceName.of("[SPACE]").toString())
.build();
CompleteImportSpaceResponse response = chatServiceClient.completeImportSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
CompleteImportSpaceRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
CompleteImportSpaceResponse |
|
completeImportSpaceCallable()
public final UnaryCallable<CompleteImportSpaceRequest,CompleteImportSpaceResponse> completeImportSpaceCallable()Completes the import process for the specified space and makes it visible to users. Requires app authentication and domain-wide delegation. For more information, see Authorize Google Chat apps to import data.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CompleteImportSpaceRequest request =
CompleteImportSpaceRequest.newBuilder()
.setName(SpaceName.of("[SPACE]").toString())
.build();
ApiFuture<CompleteImportSpaceResponse> future =
chatServiceClient.completeImportSpaceCallable().futureCall(request);
// Do something.
CompleteImportSpaceResponse response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<CompleteImportSpaceRequest,CompleteImportSpaceResponse> |
|
createMembership(CreateMembershipRequest request)
public final Membership createMembership(CreateMembershipRequest request)Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.
To specify the member to add, set the membership.member.name for the human or app member.
- To add the calling app to a space or a direct message between two human users, use
users/app. Unable to add other apps to the space.
- To add a human user, use users/{user}, where {user} can be the email address for the
user. For users in the same Workspace organization {user} can also be the id for the person
from the People API, or the id for the user in the Directory API. For example, if the People
API Person profile ID for user@example.com is 123456789, you can add the user to
the space by setting the membership.member.name to users/user@example.com or
users/123456789.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateMembershipRequest request =
CreateMembershipRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setMembership(Membership.newBuilder().build())
.build();
Membership response = chatServiceClient.createMembership(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
CreateMembershipRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
createMembership(SpaceName parent, Membership membership)
public final Membership createMembership(SpaceName parent, Membership membership)Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.
To specify the member to add, set the membership.member.name for the human or app member.
- To add the calling app to a space or a direct message between two human users, use
users/app. Unable to add other apps to the space.
- To add a human user, use users/{user}, where {user} can be the email address for the
user. For users in the same Workspace organization {user} can also be the id for the person
from the People API, or the id for the user in the Directory API. For example, if the People
API Person profile ID for user@example.com is 123456789, you can add the user to
the space by setting the membership.member.name to users/user@example.com or
users/123456789.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName parent = SpaceName.of("[SPACE]");
Membership membership = Membership.newBuilder().build();
Membership response = chatServiceClient.createMembership(parent, membership);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
SpaceNameRequired. The resource name of the space for which to create the membership. Format: spaces/{space} |
membership |
MembershipRequired. The membership relation to create. The |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
createMembership(String parent, Membership membership)
public final Membership createMembership(String parent, Membership membership)Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.
To specify the member to add, set the membership.member.name for the human or app member.
- To add the calling app to a space or a direct message between two human users, use
users/app. Unable to add other apps to the space.
- To add a human user, use users/{user}, where {user} can be the email address for the
user. For users in the same Workspace organization {user} can also be the id for the person
from the People API, or the id for the user in the Directory API. For example, if the People
API Person profile ID for user@example.com is 123456789, you can add the user to
the space by setting the membership.member.name to users/user@example.com or
users/123456789.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = SpaceName.of("[SPACE]").toString();
Membership membership = Membership.newBuilder().build();
Membership response = chatServiceClient.createMembership(parent, membership);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
StringRequired. The resource name of the space for which to create the membership. Format: spaces/{space} |
membership |
MembershipRequired. The membership relation to create. The |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
createMembershipCallable()
public final UnaryCallable<CreateMembershipRequest,Membership> createMembershipCallable()Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.
To specify the member to add, set the membership.member.name for the human or app member.
- To add the calling app to a space or a direct message between two human users, use
users/app. Unable to add other apps to the space.
- To add a human user, use users/{user}, where {user} can be the email address for the
user. For users in the same Workspace organization {user} can also be the id for the person
from the People API, or the id for the user in the Directory API. For example, if the People
API Person profile ID for user@example.com is 123456789, you can add the user to
the space by setting the membership.member.name to users/user@example.com or
users/123456789.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateMembershipRequest request =
CreateMembershipRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setMembership(Membership.newBuilder().build())
.build();
ApiFuture<Membership> future =
chatServiceClient.createMembershipCallable().futureCall(request);
// Do something.
Membership response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<CreateMembershipRequest,Membership> |
|
createMessage(CreateMessageRequest request)
public final Message createMessage(CreateMessageRequest request)Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see Send a message.
Calling this method requires authentication and supports the following authentication types:
- For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateMessageRequest request =
CreateMessageRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setMessage(Message.newBuilder().build())
.setThreadKey("threadKey-1562254347")
.setRequestId("requestId693933066")
.setMessageId("messageId-1440013438")
.build();
Message response = chatServiceClient.createMessage(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
CreateMessageRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Message |
|
createMessage(SpaceName parent, Message message, String messageId)
public final Message createMessage(SpaceName parent, Message message, String messageId)Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see Send a message.
Calling this method requires authentication and supports the following authentication types:
- For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName parent = SpaceName.of("[SPACE]");
Message message = Message.newBuilder().build();
String messageId = "messageId-1440013438";
Message response = chatServiceClient.createMessage(parent, message, messageId);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
SpaceNameRequired. The resource name of the space in which to create a message. Format: |
message |
MessageRequired. Message body. |
messageId |
StringOptional. A custom ID for a message. Lets Chat apps get, update, or delete a
message without needing to store the system-assigned ID in the message's resource name
(represented in the message The value for this field must meet the following requirements:
For details, see Name a message. |
| Returns | |
|---|---|
| Type | Description |
Message |
|
createMessage(String parent, Message message, String messageId)
public final Message createMessage(String parent, Message message, String messageId)Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see Send a message.
Calling this method requires authentication and supports the following authentication types:
- For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = SpaceName.of("[SPACE]").toString();
Message message = Message.newBuilder().build();
String messageId = "messageId-1440013438";
Message response = chatServiceClient.createMessage(parent, message, messageId);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
StringRequired. The resource name of the space in which to create a message. Format: |
message |
MessageRequired. Message body. |
messageId |
StringOptional. A custom ID for a message. Lets Chat apps get, update, or delete a
message without needing to store the system-assigned ID in the message's resource name
(represented in the message The value for this field must meet the following requirements:
For details, see Name a message. |
| Returns | |
|---|---|
| Type | Description |
Message |
|
createMessageCallable()
public final UnaryCallable<CreateMessageRequest,Message> createMessageCallable()Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see Send a message.
Calling this method requires authentication and supports the following authentication types:
- For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateMessageRequest request =
CreateMessageRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setMessage(Message.newBuilder().build())
.setThreadKey("threadKey-1562254347")
.setRequestId("requestId693933066")
.setMessageId("messageId-1440013438")
.build();
ApiFuture<Message> future = chatServiceClient.createMessageCallable().futureCall(request);
// Do something.
Message response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<CreateMessageRequest,Message> |
|
createReaction(CreateReactionRequest request)
public final Reaction createReaction(CreateReactionRequest request)Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see Add a reaction to a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateReactionRequest request =
CreateReactionRequest.newBuilder()
.setParent(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setReaction(Reaction.newBuilder().build())
.build();
Reaction response = chatServiceClient.createReaction(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
CreateReactionRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Reaction |
|
createReaction(MessageName parent, Reaction reaction)
public final Reaction createReaction(MessageName parent, Reaction reaction)Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see Add a reaction to a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MessageName parent = MessageName.of("[SPACE]", "[MESSAGE]");
Reaction reaction = Reaction.newBuilder().build();
Reaction response = chatServiceClient.createReaction(parent, reaction);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
MessageNameRequired. The message where the reaction is created. Format: |
reaction |
ReactionRequired. The reaction to create. |
| Returns | |
|---|---|
| Type | Description |
Reaction |
|
createReaction(String parent, Reaction reaction)
public final Reaction createReaction(String parent, Reaction reaction)Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see Add a reaction to a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = MessageName.of("[SPACE]", "[MESSAGE]").toString();
Reaction reaction = Reaction.newBuilder().build();
Reaction response = chatServiceClient.createReaction(parent, reaction);
}
| Parameters | |
|---|---|
| Name | Description |
parent |
StringRequired. The message where the reaction is created. Format: |
reaction |
ReactionRequired. The reaction to create. |
| Returns | |
|---|---|
| Type | Description |
Reaction |
|
createReactionCallable()
public final UnaryCallable<CreateReactionRequest,Reaction> createReactionCallable()Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see Add a reaction to a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateReactionRequest request =
CreateReactionRequest.newBuilder()
.setParent(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setReaction(Reaction.newBuilder().build())
.build();
ApiFuture<Reaction> future = chatServiceClient.createReactionCallable().futureCall(request);
// Do something.
Reaction response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<CreateReactionRequest,Reaction> |
|
createSpace(CreateSpaceRequest request)
public final Space createSpace(CreateSpaceRequest request)Creates a named space. Spaces grouped by topics aren't supported. For an example, see Create a space.
If you receive the error message ALREADY_EXISTS when creating a space, try a different
displayName. An existing space within the Google Workspace organization might already use
this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateSpaceRequest request =
CreateSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setRequestId("requestId693933066")
.build();
Space response = chatServiceClient.createSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
CreateSpaceRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Space |
|
createSpace(Space space)
public final Space createSpace(Space space)Creates a named space. Spaces grouped by topics aren't supported. For an example, see Create a space.
If you receive the error message ALREADY_EXISTS when creating a space, try a different
displayName. An existing space within the Google Workspace organization might already use
this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
Space space = Space.newBuilder().build();
Space response = chatServiceClient.createSpace(space);
}
| Parameter | |
|---|---|
| Name | Description |
space |
SpaceRequired. The If you receive the error message The space |
| Returns | |
|---|---|
| Type | Description |
Space |
|
createSpaceCallable()
public final UnaryCallable<CreateSpaceRequest,Space> createSpaceCallable()Creates a named space. Spaces grouped by topics aren't supported. For an example, see Create a space.
If you receive the error message ALREADY_EXISTS when creating a space, try a different
displayName. An existing space within the Google Workspace organization might already use
this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
CreateSpaceRequest request =
CreateSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setRequestId("requestId693933066")
.build();
ApiFuture<Space> future = chatServiceClient.createSpaceCallable().futureCall(request);
// Do something.
Space response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<CreateSpaceRequest,Space> |
|
deleteMembership(DeleteMembershipRequest request)
public final Membership deleteMembership(DeleteMembershipRequest request)Deletes a membership. For an example, see Remove a user or a Google Chat app from a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteMembershipRequest request =
DeleteMembershipRequest.newBuilder()
.setName(MembershipName.of("[SPACE]", "[MEMBER]").toString())
.build();
Membership response = chatServiceClient.deleteMembership(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
DeleteMembershipRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
deleteMembership(MembershipName name)
public final Membership deleteMembership(MembershipName name)Deletes a membership. For an example, see Remove a user or a Google Chat app from a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MembershipName name = MembershipName.of("[SPACE]", "[MEMBER]");
Membership response = chatServiceClient.deleteMembership(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
MembershipNameRequired. Resource name of the membership to delete. Chat apps can delete human users' or their own memberships. Chat apps can't delete other apps' memberships. When deleting a human membership, requires the When deleting an app membership, requires the Format: |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
deleteMembership(String name)
public final Membership deleteMembership(String name)Deletes a membership. For an example, see Remove a user or a Google Chat app from a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = MembershipName.of("[SPACE]", "[MEMBER]").toString();
Membership response = chatServiceClient.deleteMembership(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the membership to delete. Chat apps can delete human users' or their own memberships. Chat apps can't delete other apps' memberships. When deleting a human membership, requires the When deleting an app membership, requires the Format: |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
deleteMembershipCallable()
public final UnaryCallable<DeleteMembershipRequest,Membership> deleteMembershipCallable()Deletes a membership. For an example, see Remove a user or a Google Chat app from a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteMembershipRequest request =
DeleteMembershipRequest.newBuilder()
.setName(MembershipName.of("[SPACE]", "[MEMBER]").toString())
.build();
ApiFuture<Membership> future =
chatServiceClient.deleteMembershipCallable().futureCall(request);
// Do something.
Membership response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<DeleteMembershipRequest,Membership> |
|
deleteMessage(DeleteMessageRequest request)
public final void deleteMessage(DeleteMessageRequest request)Deletes a message. For an example, see Delete a message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only delete messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteMessageRequest request =
DeleteMessageRequest.newBuilder()
.setName(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setForce(true)
.build();
chatServiceClient.deleteMessage(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
DeleteMessageRequestThe request object containing all of the parameters for the API call. |
deleteMessage(MessageName name)
public final void deleteMessage(MessageName name)Deletes a message. For an example, see Delete a message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only delete messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MessageName name = MessageName.of("[SPACE]", "[MESSAGE]");
chatServiceClient.deleteMessage(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
MessageNameRequired. Resource name of the message. Format: If you've set a custom ID for your message, you can use the value from the
|
deleteMessage(String name)
public final void deleteMessage(String name)Deletes a message. For an example, see Delete a message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only delete messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = MessageName.of("[SPACE]", "[MESSAGE]").toString();
chatServiceClient.deleteMessage(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the message. Format: If you've set a custom ID for your message, you can use the value from the
|
deleteMessageCallable()
public final UnaryCallable<DeleteMessageRequest,Empty> deleteMessageCallable()Deletes a message. For an example, see Delete a message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only delete messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteMessageRequest request =
DeleteMessageRequest.newBuilder()
.setName(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setForce(true)
.build();
ApiFuture<Empty> future = chatServiceClient.deleteMessageCallable().futureCall(request);
// Do something.
future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<DeleteMessageRequest,Empty> |
|
deleteReaction(DeleteReactionRequest request)
public final void deleteReaction(DeleteReactionRequest request)Deletes a reaction to a message. Only unicode emojis are supported. For an example, see Delete a reaction. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteReactionRequest request =
DeleteReactionRequest.newBuilder()
.setName(ReactionName.of("[SPACE]", "[MESSAGE]", "[REACTION]").toString())
.build();
chatServiceClient.deleteReaction(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
DeleteReactionRequestThe request object containing all of the parameters for the API call. |
deleteReaction(ReactionName name)
public final void deleteReaction(ReactionName name)Deletes a reaction to a message. Only unicode emojis are supported. For an example, see Delete a reaction. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ReactionName name = ReactionName.of("[SPACE]", "[MESSAGE]", "[REACTION]");
chatServiceClient.deleteReaction(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
ReactionNameRequired. Name of the reaction to delete. Format: |
deleteReaction(String name)
public final void deleteReaction(String name)Deletes a reaction to a message. Only unicode emojis are supported. For an example, see Delete a reaction. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = ReactionName.of("[SPACE]", "[MESSAGE]", "[REACTION]").toString();
chatServiceClient.deleteReaction(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Name of the reaction to delete. Format: |
deleteReactionCallable()
public final UnaryCallable<DeleteReactionRequest,Empty> deleteReactionCallable()Deletes a reaction to a message. Only unicode emojis are supported. For an example, see Delete a reaction. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteReactionRequest request =
DeleteReactionRequest.newBuilder()
.setName(ReactionName.of("[SPACE]", "[MESSAGE]", "[REACTION]").toString())
.build();
ApiFuture<Empty> future = chatServiceClient.deleteReactionCallable().futureCall(request);
// Do something.
future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<DeleteReactionRequest,Empty> |
|
deleteSpace(DeleteSpaceRequest request)
public final void deleteSpace(DeleteSpaceRequest request)Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space. Requires user authentication from a user who has permission to delete the space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteSpaceRequest request =
DeleteSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build();
chatServiceClient.deleteSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
DeleteSpaceRequestThe request object containing all of the parameters for the API call. |
deleteSpace(SpaceName name)
public final void deleteSpace(SpaceName name)Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space. Requires user authentication from a user who has permission to delete the space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName name = SpaceName.of("[SPACE]");
chatServiceClient.deleteSpace(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
SpaceNameRequired. Resource name of the space to delete. Format: |
deleteSpace(String name)
public final void deleteSpace(String name)Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space. Requires user authentication from a user who has permission to delete the space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = SpaceName.of("[SPACE]").toString();
chatServiceClient.deleteSpace(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the space to delete. Format: |
deleteSpaceCallable()
public final UnaryCallable<DeleteSpaceRequest,Empty> deleteSpaceCallable()Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space. Requires user authentication from a user who has permission to delete the space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
DeleteSpaceRequest request =
DeleteSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build();
ApiFuture<Empty> future = chatServiceClient.deleteSpaceCallable().futureCall(request);
// Do something.
future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<DeleteSpaceRequest,Empty> |
|
findDirectMessage(FindDirectMessageRequest request)
public final Space findDirectMessage(FindDirectMessageRequest request)Returns the existing direct message with the specified user. If no direct message space is
found, returns a 404 NOT_FOUND error. For an example, see Find a direct
message.
With user authentication, returns the direct message space between the specified user and the authenticated user.
With app authentication, returns the direct message space between the specified user and the calling Chat app.
Requires user authentication or app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
FindDirectMessageRequest request =
FindDirectMessageRequest.newBuilder().setName("name3373707").build();
Space response = chatServiceClient.findDirectMessage(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
FindDirectMessageRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Space |
|
findDirectMessageCallable()
public final UnaryCallable<FindDirectMessageRequest,Space> findDirectMessageCallable()Returns the existing direct message with the specified user. If no direct message space is
found, returns a 404 NOT_FOUND error. For an example, see Find a direct
message.
With user authentication, returns the direct message space between the specified user and the authenticated user.
With app authentication, returns the direct message space between the specified user and the calling Chat app.
Requires user authentication or app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
FindDirectMessageRequest request =
FindDirectMessageRequest.newBuilder().setName("name3373707").build();
ApiFuture<Space> future = chatServiceClient.findDirectMessageCallable().futureCall(request);
// Do something.
Space response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<FindDirectMessageRequest,Space> |
|
getAttachment(AttachmentName name)
public final Attachment getAttachment(AttachmentName name)Gets the metadata of a message attachment. The attachment data is fetched using the media API. For an example, see Get metadata about a message attachment. Requires app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
AttachmentName name = AttachmentName.of("[SPACE]", "[MESSAGE]", "[ATTACHMENT]");
Attachment response = chatServiceClient.getAttachment(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
AttachmentNameRequired. Resource name of the attachment, in the form
|
| Returns | |
|---|---|
| Type | Description |
Attachment |
|
getAttachment(GetAttachmentRequest request)
public final Attachment getAttachment(GetAttachmentRequest request)Gets the metadata of a message attachment. The attachment data is fetched using the media API. For an example, see Get metadata about a message attachment. Requires app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetAttachmentRequest request =
GetAttachmentRequest.newBuilder()
.setName(AttachmentName.of("[SPACE]", "[MESSAGE]", "[ATTACHMENT]").toString())
.build();
Attachment response = chatServiceClient.getAttachment(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetAttachmentRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Attachment |
|
getAttachment(String name)
public final Attachment getAttachment(String name)Gets the metadata of a message attachment. The attachment data is fetched using the media API. For an example, see Get metadata about a message attachment. Requires app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = AttachmentName.of("[SPACE]", "[MESSAGE]", "[ATTACHMENT]").toString();
Attachment response = chatServiceClient.getAttachment(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the attachment, in the form
|
| Returns | |
|---|---|
| Type | Description |
Attachment |
|
getAttachmentCallable()
public final UnaryCallable<GetAttachmentRequest,Attachment> getAttachmentCallable()Gets the metadata of a message attachment. The attachment data is fetched using the media API. For an example, see Get metadata about a message attachment. Requires app authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetAttachmentRequest request =
GetAttachmentRequest.newBuilder()
.setName(AttachmentName.of("[SPACE]", "[MESSAGE]", "[ATTACHMENT]").toString())
.build();
ApiFuture<Attachment> future = chatServiceClient.getAttachmentCallable().futureCall(request);
// Do something.
Attachment response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetAttachmentRequest,Attachment> |
|
getMembership(GetMembershipRequest request)
public final Membership getMembership(GetMembershipRequest request)Returns details about a membership. For an example, see Get details about a user's or Google Chat app's membership.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetMembershipRequest request =
GetMembershipRequest.newBuilder()
.setName(MembershipName.of("[SPACE]", "[MEMBER]").toString())
.build();
Membership response = chatServiceClient.getMembership(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetMembershipRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
getMembership(MembershipName name)
public final Membership getMembership(MembershipName name)Returns details about a membership. For an example, see Get details about a user's or Google Chat app's membership.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MembershipName name = MembershipName.of("[SPACE]", "[MEMBER]");
Membership response = chatServiceClient.getMembership(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
MembershipNameRequired. Resource name of the membership to retrieve. To get the app's own membership by using user
authentication,
you can optionally use Format: When authenticated as a
user, you
can use the user's email as an alias for |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
getMembership(String name)
public final Membership getMembership(String name)Returns details about a membership. For an example, see Get details about a user's or Google Chat app's membership.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = MembershipName.of("[SPACE]", "[MEMBER]").toString();
Membership response = chatServiceClient.getMembership(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the membership to retrieve. To get the app's own membership by using user
authentication,
you can optionally use Format: When authenticated as a
user, you
can use the user's email as an alias for |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
getMembershipCallable()
public final UnaryCallable<GetMembershipRequest,Membership> getMembershipCallable()Returns details about a membership. For an example, see Get details about a user's or Google Chat app's membership.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetMembershipRequest request =
GetMembershipRequest.newBuilder()
.setName(MembershipName.of("[SPACE]", "[MEMBER]").toString())
.build();
ApiFuture<Membership> future = chatServiceClient.getMembershipCallable().futureCall(request);
// Do something.
Membership response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetMembershipRequest,Membership> |
|
getMessage(GetMessageRequest request)
public final Message getMessage(GetMessageRequest request)Returns details about a message. For an example, see Get details about a message.
Requires authentication. Supports app authentication and user authentication.
Note: Might return a message from a blocked member or space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetMessageRequest request =
GetMessageRequest.newBuilder()
.setName(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.build();
Message response = chatServiceClient.getMessage(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetMessageRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Message |
|
getMessage(MessageName name)
public final Message getMessage(MessageName name)Returns details about a message. For an example, see Get details about a message.
Requires authentication. Supports app authentication and user authentication.
Note: Might return a message from a blocked member or space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MessageName name = MessageName.of("[SPACE]", "[MESSAGE]");
Message response = chatServiceClient.getMessage(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
MessageNameRequired. Resource name of the message. Format: If you've set a custom ID for your message, you can use the value from the
|
| Returns | |
|---|---|
| Type | Description |
Message |
|
getMessage(String name)
public final Message getMessage(String name)Returns details about a message. For an example, see Get details about a message.
Requires authentication. Supports app authentication and user authentication.
Note: Might return a message from a blocked member or space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = MessageName.of("[SPACE]", "[MESSAGE]").toString();
Message response = chatServiceClient.getMessage(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the message. Format: If you've set a custom ID for your message, you can use the value from the
|
| Returns | |
|---|---|
| Type | Description |
Message |
|
getMessageCallable()
public final UnaryCallable<GetMessageRequest,Message> getMessageCallable()Returns details about a message. For an example, see Get details about a message.
Requires authentication. Supports app authentication and user authentication.
Note: Might return a message from a blocked member or space.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetMessageRequest request =
GetMessageRequest.newBuilder()
.setName(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.build();
ApiFuture<Message> future = chatServiceClient.getMessageCallable().futureCall(request);
// Do something.
Message response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetMessageRequest,Message> |
|
getSettings()
public final ChatServiceSettings getSettings()| Returns | |
|---|---|
| Type | Description |
ChatServiceSettings |
|
getSpace(GetSpaceRequest request)
public final Space getSpace(GetSpaceRequest request)Returns details about a space. For an example, see Get details about a space.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetSpaceRequest request =
GetSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build();
Space response = chatServiceClient.getSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetSpaceRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Space |
|
getSpace(SpaceName name)
public final Space getSpace(SpaceName name)Returns details about a space. For an example, see Get details about a space.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName name = SpaceName.of("[SPACE]");
Space response = chatServiceClient.getSpace(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
SpaceNameRequired. Resource name of the space, in the form "spaces/*". Format: |
| Returns | |
|---|---|
| Type | Description |
Space |
|
getSpace(String name)
public final Space getSpace(String name)Returns details about a space. For an example, see Get details about a space.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = SpaceName.of("[SPACE]").toString();
Space response = chatServiceClient.getSpace(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the space, in the form "spaces/*". Format: |
| Returns | |
|---|---|
| Type | Description |
Space |
|
getSpaceCallable()
public final UnaryCallable<GetSpaceRequest,Space> getSpaceCallable()Returns details about a space. For an example, see Get details about a space.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetSpaceRequest request =
GetSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build();
ApiFuture<Space> future = chatServiceClient.getSpaceCallable().futureCall(request);
// Do something.
Space response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetSpaceRequest,Space> |
|
getSpaceReadState(GetSpaceReadStateRequest request)
public final SpaceReadState getSpaceReadState(GetSpaceReadStateRequest request)Returns details about a user's read state within a space, used to identify read and unread messages. For an example, see Get details about a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetSpaceReadStateRequest request =
GetSpaceReadStateRequest.newBuilder()
.setName(SpaceReadStateName.of("[USER]", "[SPACE]").toString())
.build();
SpaceReadState response = chatServiceClient.getSpaceReadState(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetSpaceReadStateRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
SpaceReadState |
|
getSpaceReadState(SpaceReadStateName name)
public final SpaceReadState getSpaceReadState(SpaceReadStateName name)Returns details about a user's read state within a space, used to identify read and unread messages. For an example, see Get details about a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceReadStateName name = SpaceReadStateName.of("[USER]", "[SPACE]");
SpaceReadState response = chatServiceClient.getSpaceReadState(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
SpaceReadStateNameRequired. Resource name of the space read state to retrieve. Only supports getting read state for the calling user. To refer to the calling user, set one of the following: - The - Their Workspace email address. For example,
- Their user id. For example, Format: users/{user}/spaces/{space}/spaceReadState |
| Returns | |
|---|---|
| Type | Description |
SpaceReadState |
|
getSpaceReadState(String name)
public final SpaceReadState getSpaceReadState(String name)Returns details about a user's read state within a space, used to identify read and unread messages. For an example, see Get details about a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = SpaceReadStateName.of("[USER]", "[SPACE]").toString();
SpaceReadState response = chatServiceClient.getSpaceReadState(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the space read state to retrieve. Only supports getting read state for the calling user. To refer to the calling user, set one of the following: - The - Their Workspace email address. For example,
- Their user id. For example, Format: users/{user}/spaces/{space}/spaceReadState |
| Returns | |
|---|---|
| Type | Description |
SpaceReadState |
|
getSpaceReadStateCallable()
public final UnaryCallable<GetSpaceReadStateRequest,SpaceReadState> getSpaceReadStateCallable()Returns details about a user's read state within a space, used to identify read and unread messages. For an example, see Get details about a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetSpaceReadStateRequest request =
GetSpaceReadStateRequest.newBuilder()
.setName(SpaceReadStateName.of("[USER]", "[SPACE]").toString())
.build();
ApiFuture<SpaceReadState> future =
chatServiceClient.getSpaceReadStateCallable().futureCall(request);
// Do something.
SpaceReadState response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetSpaceReadStateRequest,SpaceReadState> |
|
getStub()
public ChatServiceStub getStub()| Returns | |
|---|---|
| Type | Description |
ChatServiceStub |
|
getThreadReadState(GetThreadReadStateRequest request)
public final ThreadReadState getThreadReadState(GetThreadReadStateRequest request)Returns details about a user's read state within a thread, used to identify read and unread messages. For an example, see Get details about a user's thread read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetThreadReadStateRequest request =
GetThreadReadStateRequest.newBuilder()
.setName(ThreadReadStateName.of("[USER]", "[SPACE]", "[THREAD]").toString())
.build();
ThreadReadState response = chatServiceClient.getThreadReadState(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
GetThreadReadStateRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
ThreadReadState |
|
getThreadReadState(ThreadReadStateName name)
public final ThreadReadState getThreadReadState(ThreadReadStateName name)Returns details about a user's read state within a thread, used to identify read and unread messages. For an example, see Get details about a user's thread read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ThreadReadStateName name = ThreadReadStateName.of("[USER]", "[SPACE]", "[THREAD]");
ThreadReadState response = chatServiceClient.getThreadReadState(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
ThreadReadStateNameRequired. Resource name of the thread read state to retrieve. Only supports getting read state for the calling user. To refer to the calling user, set one of the following: - The - Their Workspace email address. For example,
- Their user id. For example,
Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState |
| Returns | |
|---|---|
| Type | Description |
ThreadReadState |
|
getThreadReadState(String name)
public final ThreadReadState getThreadReadState(String name)Returns details about a user's read state within a thread, used to identify read and unread messages. For an example, see Get details about a user's thread read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String name = ThreadReadStateName.of("[USER]", "[SPACE]", "[THREAD]").toString();
ThreadReadState response = chatServiceClient.getThreadReadState(name);
}
| Parameter | |
|---|---|
| Name | Description |
name |
StringRequired. Resource name of the thread read state to retrieve. Only supports getting read state for the calling user. To refer to the calling user, set one of the following: - The - Their Workspace email address. For example,
- Their user id. For example,
Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState |
| Returns | |
|---|---|
| Type | Description |
ThreadReadState |
|
getThreadReadStateCallable()
public final UnaryCallable<GetThreadReadStateRequest,ThreadReadState> getThreadReadStateCallable()Returns details about a user's read state within a thread, used to identify read and unread messages. For an example, see Get details about a user's thread read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
GetThreadReadStateRequest request =
GetThreadReadStateRequest.newBuilder()
.setName(ThreadReadStateName.of("[USER]", "[SPACE]", "[THREAD]").toString())
.build();
ApiFuture<ThreadReadState> future =
chatServiceClient.getThreadReadStateCallable().futureCall(request);
// Do something.
ThreadReadState response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<GetThreadReadStateRequest,ThreadReadState> |
|
isShutdown()
public boolean isShutdown()| Returns | |
|---|---|
| Type | Description |
boolean |
|
isTerminated()
public boolean isTerminated()| Returns | |
|---|---|
| Type | Description |
boolean |
|
listMemberships(ListMembershipsRequest request)
public final ChatServiceClient.ListMembershipsPagedResponse listMemberships(ListMembershipsRequest request)Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMembershipsRequest request =
ListMembershipsRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setShowGroups(true)
.setShowInvited(true)
.build();
for (Membership element : chatServiceClient.listMemberships(request).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
request |
ListMembershipsRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMembershipsPagedResponse |
|
listMemberships(SpaceName parent)
public final ChatServiceClient.ListMembershipsPagedResponse listMemberships(SpaceName parent)Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName parent = SpaceName.of("[SPACE]");
for (Membership element : chatServiceClient.listMemberships(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
SpaceNameRequired. The resource name of the space for which to fetch a membership list. Format: spaces/{space} |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMembershipsPagedResponse |
|
listMemberships(String parent)
public final ChatServiceClient.ListMembershipsPagedResponse listMemberships(String parent)Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = SpaceName.of("[SPACE]").toString();
for (Membership element : chatServiceClient.listMemberships(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
StringRequired. The resource name of the space for which to fetch a membership list. Format: spaces/{space} |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMembershipsPagedResponse |
|
listMembershipsCallable()
public final UnaryCallable<ListMembershipsRequest,ListMembershipsResponse> listMembershipsCallable()Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMembershipsRequest request =
ListMembershipsRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setShowGroups(true)
.setShowInvited(true)
.build();
while (true) {
ListMembershipsResponse response =
chatServiceClient.listMembershipsCallable().call(request);
for (Membership element : response.getMembershipsList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListMembershipsRequest,ListMembershipsResponse> |
|
listMembershipsPagedCallable()
public final UnaryCallable<ListMembershipsRequest,ChatServiceClient.ListMembershipsPagedResponse> listMembershipsPagedCallable()Lists memberships in a space. For an example, see List users and Google Chat apps in a space. Listing memberships with app authentication lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with User authentication lists memberships in spaces that the authenticated user has access to.
Requires authentication. Supports app authentication and user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMembershipsRequest request =
ListMembershipsRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setShowGroups(true)
.setShowInvited(true)
.build();
ApiFuture<Membership> future =
chatServiceClient.listMembershipsPagedCallable().futureCall(request);
// Do something.
for (Membership element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListMembershipsRequest,ListMembershipsPagedResponse> |
|
listMessages(ListMessagesRequest request)
public final ChatServiceClient.ListMessagesPagedResponse listMessages(ListMessagesRequest request)Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMessagesRequest request =
ListMessagesRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setOrderBy("orderBy-1207110587")
.setShowDeleted(true)
.build();
for (Message element : chatServiceClient.listMessages(request).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
request |
ListMessagesRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMessagesPagedResponse |
|
listMessages(SpaceName parent)
public final ChatServiceClient.ListMessagesPagedResponse listMessages(SpaceName parent)Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceName parent = SpaceName.of("[SPACE]");
for (Message element : chatServiceClient.listMessages(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
SpaceNameRequired. The resource name of the space to list messages from. Format: |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMessagesPagedResponse |
|
listMessages(String parent)
public final ChatServiceClient.ListMessagesPagedResponse listMessages(String parent)Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = SpaceName.of("[SPACE]").toString();
for (Message element : chatServiceClient.listMessages(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
StringRequired. The resource name of the space to list messages from. Format: |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListMessagesPagedResponse |
|
listMessagesCallable()
public final UnaryCallable<ListMessagesRequest,ListMessagesResponse> listMessagesCallable()Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMessagesRequest request =
ListMessagesRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setOrderBy("orderBy-1207110587")
.setShowDeleted(true)
.build();
while (true) {
ListMessagesResponse response = chatServiceClient.listMessagesCallable().call(request);
for (Message element : response.getMessagesList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListMessagesRequest,ListMessagesResponse> |
|
listMessagesPagedCallable()
public final UnaryCallable<ListMessagesRequest,ChatServiceClient.ListMessagesPagedResponse> listMessagesPagedCallable()Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see List messages. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListMessagesRequest request =
ListMessagesRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.setOrderBy("orderBy-1207110587")
.setShowDeleted(true)
.build();
ApiFuture<Message> future = chatServiceClient.listMessagesPagedCallable().futureCall(request);
// Do something.
for (Message element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListMessagesRequest,ListMessagesPagedResponse> |
|
listReactions(ListReactionsRequest request)
public final ChatServiceClient.ListReactionsPagedResponse listReactions(ListReactionsRequest request)Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListReactionsRequest request =
ListReactionsRequest.newBuilder()
.setParent(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
for (Reaction element : chatServiceClient.listReactions(request).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
request |
ListReactionsRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListReactionsPagedResponse |
|
listReactions(MessageName parent)
public final ChatServiceClient.ListReactionsPagedResponse listReactions(MessageName parent)Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
MessageName parent = MessageName.of("[SPACE]", "[MESSAGE]");
for (Reaction element : chatServiceClient.listReactions(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
MessageNameRequired. The message users reacted to. Format: |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListReactionsPagedResponse |
|
listReactions(String parent)
public final ChatServiceClient.ListReactionsPagedResponse listReactions(String parent)Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
String parent = MessageName.of("[SPACE]", "[MESSAGE]").toString();
for (Reaction element : chatServiceClient.listReactions(parent).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
parent |
StringRequired. The message users reacted to. Format: |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListReactionsPagedResponse |
|
listReactionsCallable()
public final UnaryCallable<ListReactionsRequest,ListReactionsResponse> listReactionsCallable()Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListReactionsRequest request =
ListReactionsRequest.newBuilder()
.setParent(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
while (true) {
ListReactionsResponse response = chatServiceClient.listReactionsCallable().call(request);
for (Reaction element : response.getReactionsList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListReactionsRequest,ListReactionsResponse> |
|
listReactionsPagedCallable()
public final UnaryCallable<ListReactionsRequest,ChatServiceClient.ListReactionsPagedResponse> listReactionsPagedCallable()Lists reactions to a message. For an example, see List reactions for a message. Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListReactionsRequest request =
ListReactionsRequest.newBuilder()
.setParent(MessageName.of("[SPACE]", "[MESSAGE]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
ApiFuture<Reaction> future =
chatServiceClient.listReactionsPagedCallable().futureCall(request);
// Do something.
for (Reaction element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListReactionsRequest,ListReactionsPagedResponse> |
|
listSpaces()
public final ChatServiceClient.ListSpacesPagedResponse listSpaces()Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces.
Requires authentication. Supports app authentication and user authentication.
Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
for (Space element : chatServiceClient.listSpaces().iterateAll()) {
// doThingsWith(element);
}
}
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListSpacesPagedResponse |
|
listSpaces(ListSpacesRequest request)
public final ChatServiceClient.ListSpacesPagedResponse listSpaces(ListSpacesRequest request)Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces.
Requires authentication. Supports app authentication and user authentication.
Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListSpacesRequest request =
ListSpacesRequest.newBuilder()
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
for (Space element : chatServiceClient.listSpaces(request).iterateAll()) {
// doThingsWith(element);
}
}
| Parameter | |
|---|---|
| Name | Description |
request |
ListSpacesRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
ChatServiceClient.ListSpacesPagedResponse |
|
listSpacesCallable()
public final UnaryCallable<ListSpacesRequest,ListSpacesResponse> listSpacesCallable()Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces.
Requires authentication. Supports app authentication and user authentication.
Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListSpacesRequest request =
ListSpacesRequest.newBuilder()
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
while (true) {
ListSpacesResponse response = chatServiceClient.listSpacesCallable().call(request);
for (Space element : response.getSpacesList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListSpacesRequest,ListSpacesResponse> |
|
listSpacesPagedCallable()
public final UnaryCallable<ListSpacesRequest,ChatServiceClient.ListSpacesPagedResponse> listSpacesPagedCallable()Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces.
Requires authentication. Supports app authentication and user authentication.
Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
ListSpacesRequest request =
ListSpacesRequest.newBuilder()
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
ApiFuture<Space> future = chatServiceClient.listSpacesPagedCallable().futureCall(request);
// Do something.
for (Space element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<ListSpacesRequest,ListSpacesPagedResponse> |
|
setUpSpace(SetUpSpaceRequest request)
public final Space setUpSpace(SetUpSpaceRequest request)Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see Set up a space with initial members.
To specify the human members to add, add memberships with the appropriate
membership.member.name. To add a human user, use users/{user}, where {user} can be the
email address for the user. For users in the same Workspace organization {user} can also be
the id for the person from the People API, or the id for the user in the Directory API. For
example, if the People API Person profile ID for user@example.com is 123456789,
you can add the user to the space by setting the membership.member.name to
users/user@example.com or users/123456789.
For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space.
To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created.
To create a DM between the calling user and the calling app, set Space.singleUserBotDm to
true and don't specify any memberships. You can only use this method to set up a DM with the
calling app. To add the calling app as a member of a space or an existing DM between two human
users, see Invite or add a user or app to a
space.
If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned.
Spaces with threaded replies aren't supported. If you receive the error message
ALREADY_EXISTS when setting up a space, try a different displayName. An existing space
within the Google Workspace organization might already use this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SetUpSpaceRequest request =
SetUpSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setRequestId("requestId693933066")
.addAllMemberships(new ArrayList<Membership>())
.build();
Space response = chatServiceClient.setUpSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
SetUpSpaceRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Space |
|
setUpSpaceCallable()
public final UnaryCallable<SetUpSpaceRequest,Space> setUpSpaceCallable()Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see Set up a space with initial members.
To specify the human members to add, add memberships with the appropriate
membership.member.name. To add a human user, use users/{user}, where {user} can be the
email address for the user. For users in the same Workspace organization {user} can also be
the id for the person from the People API, or the id for the user in the Directory API. For
example, if the People API Person profile ID for user@example.com is 123456789,
you can add the user to the space by setting the membership.member.name to
users/user@example.com or users/123456789.
For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space.
To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created.
To create a DM between the calling user and the calling app, set Space.singleUserBotDm to
true and don't specify any memberships. You can only use this method to set up a DM with the
calling app. To add the calling app as a member of a space or an existing DM between two human
users, see Invite or add a user or app to a
space.
If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned.
Spaces with threaded replies aren't supported. If you receive the error message
ALREADY_EXISTS when setting up a space, try a different displayName. An existing space
within the Google Workspace organization might already use this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SetUpSpaceRequest request =
SetUpSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setRequestId("requestId693933066")
.addAllMemberships(new ArrayList<Membership>())
.build();
ApiFuture<Space> future = chatServiceClient.setUpSpaceCallable().futureCall(request);
// Do something.
Space response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<SetUpSpaceRequest,Space> |
|
shutdown()
public void shutdown()shutdownNow()
public void shutdownNow()updateMembership(Membership membership, FieldMask updateMask)
public final Membership updateMembership(Membership membership, FieldMask updateMask)Updates a membership. For an example, see Update a user's membership in a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
Membership membership = Membership.newBuilder().build();
FieldMask updateMask = FieldMask.newBuilder().build();
Membership response = chatServiceClient.updateMembership(membership, updateMask);
}
| Parameters | |
|---|---|
| Name | Description |
membership |
MembershipRequired. The membership to update. Only fields specified by |
updateMask |
FieldMaskRequired. The field paths to update. Separate multiple values with commas or
use Currently supported field paths: - |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
updateMembership(UpdateMembershipRequest request)
public final Membership updateMembership(UpdateMembershipRequest request)Updates a membership. For an example, see Update a user's membership in a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateMembershipRequest request =
UpdateMembershipRequest.newBuilder()
.setMembership(Membership.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
Membership response = chatServiceClient.updateMembership(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
UpdateMembershipRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Membership |
|
updateMembershipCallable()
public final UnaryCallable<UpdateMembershipRequest,Membership> updateMembershipCallable()Updates a membership. For an example, see Update a user's membership in a space.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateMembershipRequest request =
UpdateMembershipRequest.newBuilder()
.setMembership(Membership.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
ApiFuture<Membership> future =
chatServiceClient.updateMembershipCallable().futureCall(request);
// Do something.
Membership response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<UpdateMembershipRequest,Membership> |
|
updateMessage(Message message, FieldMask updateMask)
public final Message updateMessage(Message message, FieldMask updateMask)Updates a message. There's a difference between the patch and update methods. The patch
method uses a patch request while the update method uses a put request. We recommend
using the patch method. For an example, see Update a
message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only update messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
Message message = Message.newBuilder().build();
FieldMask updateMask = FieldMask.newBuilder().build();
Message response = chatServiceClient.updateMessage(message, updateMask);
}
| Parameters | |
|---|---|
| Name | Description |
message |
MessageRequired. Message with fields updated. |
updateMask |
FieldMaskRequired. The field paths to update. Separate multiple values with commas or
use Currently supported field paths: - - - - - |
| Returns | |
|---|---|
| Type | Description |
Message |
|
updateMessage(UpdateMessageRequest request)
public final Message updateMessage(UpdateMessageRequest request)Updates a message. There's a difference between the patch and update methods. The patch
method uses a patch request while the update method uses a put request. We recommend
using the patch method. For an example, see Update a
message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only update messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateMessageRequest request =
UpdateMessageRequest.newBuilder()
.setMessage(Message.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.setAllowMissing(true)
.build();
Message response = chatServiceClient.updateMessage(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
UpdateMessageRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Message |
|
updateMessageCallable()
public final UnaryCallable<UpdateMessageRequest,Message> updateMessageCallable()Updates a message. There's a difference between the patch and update methods. The patch
method uses a patch request while the update method uses a put request. We recommend
using the patch method. For an example, see Update a
message.
Requires authentication. Supports app authentication and user authentication. When using app authentication, requests can only update messages created by the calling Chat app.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateMessageRequest request =
UpdateMessageRequest.newBuilder()
.setMessage(Message.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.setAllowMissing(true)
.build();
ApiFuture<Message> future = chatServiceClient.updateMessageCallable().futureCall(request);
// Do something.
Message response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<UpdateMessageRequest,Message> |
|
updateSpace(Space space, FieldMask updateMask)
public final Space updateSpace(Space space, FieldMask updateMask)Updates a space. For an example, see Update a space.
If you're updating the displayName field and receive the error message ALREADY_EXISTS,
try a different display name.. An existing space within the Google Workspace organization might
already use this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
Space space = Space.newBuilder().build();
FieldMask updateMask = FieldMask.newBuilder().build();
Space response = chatServiceClient.updateSpace(space, updateMask);
}
| Parameters | |
|---|---|
| Name | Description |
space |
SpaceRequired. Space with fields to be updated. |
updateMask |
FieldMaskRequired. The updated field paths, comma separated if there are multiple. Currently supported field paths: - - - - - Developer Preview: |
| Returns | |
|---|---|
| Type | Description |
Space |
|
updateSpace(UpdateSpaceRequest request)
public final Space updateSpace(UpdateSpaceRequest request)Updates a space. For an example, see Update a space.
If you're updating the displayName field and receive the error message ALREADY_EXISTS,
try a different display name.. An existing space within the Google Workspace organization might
already use this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateSpaceRequest request =
UpdateSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
Space response = chatServiceClient.updateSpace(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
UpdateSpaceRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
Space |
|
updateSpaceCallable()
public final UnaryCallable<UpdateSpaceRequest,Space> updateSpaceCallable()Updates a space. For an example, see Update a space.
If you're updating the displayName field and receive the error message ALREADY_EXISTS,
try a different display name.. An existing space within the Google Workspace organization might
already use this display name.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateSpaceRequest request =
UpdateSpaceRequest.newBuilder()
.setSpace(Space.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
ApiFuture<Space> future = chatServiceClient.updateSpaceCallable().futureCall(request);
// Do something.
Space response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<UpdateSpaceRequest,Space> |
|
updateSpaceReadState(SpaceReadState spaceReadState, FieldMask updateMask)
public final SpaceReadState updateSpaceReadState(SpaceReadState spaceReadState, FieldMask updateMask)Updates a user's read state within a space, used to identify read and unread messages. For an example, see Update a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
SpaceReadState spaceReadState = SpaceReadState.newBuilder().build();
FieldMask updateMask = FieldMask.newBuilder().build();
SpaceReadState response = chatServiceClient.updateSpaceReadState(spaceReadState, updateMask);
}
| Parameters | |
|---|---|
| Name | Description |
spaceReadState |
SpaceReadStateRequired. The space read state and fields to update. Only supports updating read state for the calling user. To refer to the calling user, set one of the following: - The - Their Workspace email address. For example,
- Their user id. For example, Format: users/{user}/spaces/{space}/spaceReadState |
updateMask |
FieldMaskRequired. The field paths to update. Currently supported field paths: - When the To mark the space as read, set |
| Returns | |
|---|---|
| Type | Description |
SpaceReadState |
|
updateSpaceReadState(UpdateSpaceReadStateRequest request)
public final SpaceReadState updateSpaceReadState(UpdateSpaceReadStateRequest request)Updates a user's read state within a space, used to identify read and unread messages. For an example, see Update a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateSpaceReadStateRequest request =
UpdateSpaceReadStateRequest.newBuilder()
.setSpaceReadState(SpaceReadState.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
SpaceReadState response = chatServiceClient.updateSpaceReadState(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
UpdateSpaceReadStateRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
SpaceReadState |
|
updateSpaceReadStateCallable()
public final UnaryCallable<UpdateSpaceReadStateRequest,SpaceReadState> updateSpaceReadStateCallable()Updates a user's read state within a space, used to identify read and unread messages. For an example, see Update a user's space read state.
Requires user authentication.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UpdateSpaceReadStateRequest request =
UpdateSpaceReadStateRequest.newBuilder()
.setSpaceReadState(SpaceReadState.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
ApiFuture<SpaceReadState> future =
chatServiceClient.updateSpaceReadStateCallable().futureCall(request);
// Do something.
SpaceReadState response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<UpdateSpaceReadStateRequest,SpaceReadState> |
|
uploadAttachment(UploadAttachmentRequest request)
public final UploadAttachmentResponse uploadAttachment(UploadAttachmentRequest request)Uploads an attachment. For an example, see Upload media as a file attachment. Requires user authentication.
You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see File types blocked by Google Chat.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UploadAttachmentRequest request =
UploadAttachmentRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setFilename("filename-734768633")
.build();
UploadAttachmentResponse response = chatServiceClient.uploadAttachment(request);
}
| Parameter | |
|---|---|
| Name | Description |
request |
UploadAttachmentRequestThe request object containing all of the parameters for the API call. |
| Returns | |
|---|---|
| Type | Description |
UploadAttachmentResponse |
|
uploadAttachmentCallable()
public final UnaryCallable<UploadAttachmentRequest,UploadAttachmentResponse> uploadAttachmentCallable()Uploads an attachment. For an example, see Upload media as a file attachment. Requires user authentication.
You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see File types blocked by Google Chat.
Sample code:
// 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.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try (ChatServiceClient chatServiceClient = ChatServiceClient.create()) {
UploadAttachmentRequest request =
UploadAttachmentRequest.newBuilder()
.setParent(SpaceName.of("[SPACE]").toString())
.setFilename("filename-734768633")
.build();
ApiFuture<UploadAttachmentResponse> future =
chatServiceClient.uploadAttachmentCallable().futureCall(request);
// Do something.
UploadAttachmentResponse response = future.get();
}
| Returns | |
|---|---|
| Type | Description |
UnaryCallable<UploadAttachmentRequest,UploadAttachmentResponse> |
|