ChatServiceClient.java

/*
 * Copyright 2024 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.chat.v1;

import com.google.api.core.ApiFuture;
import com.google.api.core.ApiFutures;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.chat.v1.stub.ChatServiceStub;
import com.google.chat.v1.stub.ChatServiceStubSettings;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.protobuf.Empty;
import com.google.protobuf.FieldMask;
import java.io.IOException;
import java.util.List;
import java.util.concurrent.TimeUnit;
import javax.annotation.Generated;

// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
 * Service Description: Enables developers to build Chat apps and integrations on Google Chat
 * Platform.
 *
 * <p>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:
 *
 * <pre>{@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);
 * }
 * }</pre>
 *
 * <p>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().
 *
 * <table>
 *    <caption>Methods</caption>
 *    <tr>
 *      <th>Method</th>
 *      <th>Description</th>
 *      <th>Method Variants</th>
 *    </tr>
 *    <tr>
 *      <td><p> CreateMessage</td>
 *      <td><p> Creates a message in a Google Chat space. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages).
 * <p>  Calling this method requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and supports the following authentication types:
 * <p>  - 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.)</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> createMessage(CreateMessageRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> createMessage(SpaceName parent, Message message, String messageId)
 *           <li><p> createMessage(String parent, Message message, String messageId)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> createMessageCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> ListMessages</td>
 *      <td><p> 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](/chat/api/guides/v1/messages/list). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> listMessages(ListMessagesRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> listMessages(SpaceName parent)
 *           <li><p> listMessages(String parent)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> listMessagesPagedCallable()
 *           <li><p> listMessagesCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> ListMemberships</td>
 *      <td><p> Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to.
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> listMemberships(ListMembershipsRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> listMemberships(SpaceName parent)
 *           <li><p> listMemberships(String parent)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> listMembershipsPagedCallable()
 *           <li><p> listMembershipsCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> GetMembership</td>
 *      <td><p> Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> getMembership(GetMembershipRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> getMembership(MembershipName name)
 *           <li><p> getMembership(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> getMembershipCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> GetMessage</td>
 *      <td><p> Returns details about a message. For an example, see [Get details about a message](https://developers.google.com/workspace/chat/get-messages).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
 * <p>  Note: Might return a message from a blocked member or space.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> getMessage(GetMessageRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> getMessage(MessageName name)
 *           <li><p> getMessage(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> getMessageCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> UpdateMessage</td>
 *      <td><p> 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](https://developers.google.com/workspace/chat/update-messages).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only update messages created by the calling Chat app.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> updateMessage(UpdateMessageRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> updateMessage(Message message, FieldMask updateMask)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> updateMessageCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> DeleteMessage</td>
 *      <td><p> Deletes a message. For an example, see [Delete a message](https://developers.google.com/workspace/chat/delete-messages).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only delete messages created by the calling Chat app.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> deleteMessage(DeleteMessageRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> deleteMessage(MessageName name)
 *           <li><p> deleteMessage(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> deleteMessageCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> GetAttachment</td>
 *      <td><p> Gets the metadata of a message attachment. The attachment data is fetched using the [media API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an example, see [Get metadata about a message attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> getAttachment(GetAttachmentRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> getAttachment(AttachmentName name)
 *           <li><p> getAttachment(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> getAttachmentCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> UploadAttachment</td>
 *      <td><p> Uploads an attachment. For an example, see [Upload media as a file attachment](https://developers.google.com/workspace/chat/upload-media-attachments). Requires user [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
 * <p>  You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see [File types blocked by Google Chat](https://support.google.com/chat/answer/7651457?&amp;co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> uploadAttachment(UploadAttachmentRequest request)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> uploadAttachmentCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> ListSpaces</td>
 *      <td><p> 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](https://developers.google.com/workspace/chat/list-spaces).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
 * <p>  Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> listSpaces(ListSpacesRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> listSpaces()
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> listSpacesPagedCallable()
 *           <li><p> listSpacesCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> GetSpace</td>
 *      <td><p> Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces).
 * <p>  Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> getSpace(GetSpaceRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> getSpace(SpaceName name)
 *           <li><p> getSpace(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> getSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> CreateSpace</td>
 *      <td><p> Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces).
 * <p>   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.
 * <p>  Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> createSpace(CreateSpaceRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> createSpace(Space space)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> createSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> SetUpSpace</td>
 *      <td><p> 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](https://developers.google.com/workspace/chat/set-up-spaces).
 * <p>  To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. 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{@literal @}example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or `users/123456789`.
 * <p>  For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space.
 * <p>  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.
 * <p>  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](https://developers.google.com/workspace/chat/create-members).
 * <p>  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.
 * <p>  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.
 * <p>  Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> setUpSpace(SetUpSpaceRequest request)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> setUpSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> UpdateSpace</td>
 *      <td><p> Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces).
 * <p>  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.
 * <p>  Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> updateSpace(UpdateSpaceRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> updateSpace(Space space, FieldMask updateMask)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> updateSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> DeleteSpace</td>
 *      <td><p> 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](https://developers.google.com/workspace/chat/delete-spaces). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) from a user who has permission to delete the space.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> deleteSpace(DeleteSpaceRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> deleteSpace(SpaceName name)
 *           <li><p> deleteSpace(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> deleteSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> CompleteImportSpace</td>
 *      <td><p> Completes the [import process](https://developers.google.com/workspace/chat/import-data) 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](https://developers.google.com/workspace/chat/authorize-import).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> completeImportSpace(CompleteImportSpaceRequest request)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> completeImportSpaceCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> FindDirectMessage</td>
 *      <td><p> 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](/chat/api/guides/v1/spaces/find-direct-message).
 * <p>  With [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user.
 * <p>  With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app.
 * <p>  Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) or [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> findDirectMessage(FindDirectMessageRequest request)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> findDirectMessageCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> CreateMembership</td>
 *      <td><p> 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](https://developers.google.com/workspace/chat/create-members). 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](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
 * <p>  To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`:
 * <p>  - 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.
 * <p>  - 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{@literal @}example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or `users/123456789`.</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> createMembership(CreateMembershipRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> createMembership(SpaceName parent, Membership membership)
 *           <li><p> createMembership(String parent, Membership membership)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> createMembershipCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> UpdateMembership</td>
 *      <td><p> Updates a membership. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> updateMembership(UpdateMembershipRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> updateMembership(Membership membership, FieldMask updateMask)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> updateMembershipCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> DeleteMembership</td>
 *      <td><p> Deletes a membership. For an example, see [Remove a user or a Google Chat app from a space](https://developers.google.com/workspace/chat/delete-members).
 * <p>  Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> deleteMembership(DeleteMembershipRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> deleteMembership(MembershipName name)
 *           <li><p> deleteMembership(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> deleteMembershipCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> CreateReaction</td>
 *      <td><p> Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see [Add a reaction to a message](https://developers.google.com/workspace/chat/create-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> createReaction(CreateReactionRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> createReaction(MessageName parent, Reaction reaction)
 *           <li><p> createReaction(String parent, Reaction reaction)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> createReactionCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> ListReactions</td>
 *      <td><p> Lists reactions to a message. For an example, see [List reactions for a message](https://developers.google.com/workspace/chat/list-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> listReactions(ListReactionsRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> listReactions(MessageName parent)
 *           <li><p> listReactions(String parent)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> listReactionsPagedCallable()
 *           <li><p> listReactionsCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *    <tr>
 *      <td><p> DeleteReaction</td>
 *      <td><p> Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</td>
 *      <td>
 *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
 *      <ul>
 *           <li><p> deleteReaction(DeleteReactionRequest request)
 *      </ul>
 *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
 *      <ul>
 *           <li><p> deleteReaction(ReactionName name)
 *           <li><p> deleteReaction(String name)
 *      </ul>
 *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
 *      <ul>
 *           <li><p> deleteReactionCallable()
 *      </ul>
 *       </td>
 *    </tr>
 *  </table>
 *
 * <p>See the individual methods for example code.
 *
 * <p>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.
 *
 * <p>This class can be customized by passing in a custom instance of ChatServiceSettings to
 * create(). For example:
 *
 * <p>To customize credentials:
 *
 * <pre>{@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
 * ChatServiceSettings chatServiceSettings =
 *     ChatServiceSettings.newBuilder()
 *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
 *         .build();
 * ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
 * }</pre>
 *
 * <p>To customize the endpoint:
 *
 * <pre>{@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
 * ChatServiceSettings chatServiceSettings =
 *     ChatServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 * ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
 * }</pre>
 *
 * <p>To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over
 * the wire:
 *
 * <pre>{@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
 * ChatServiceSettings chatServiceSettings = ChatServiceSettings.newHttpJsonBuilder().build();
 * ChatServiceClient chatServiceClient = ChatServiceClient.create(chatServiceSettings);
 * }</pre>
 *
 * <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
 */
@Generated("by gapic-generator-java")
public class ChatServiceClient implements BackgroundResource {
  private final ChatServiceSettings settings;
  private final ChatServiceStub stub;

  /** Constructs an instance of ChatServiceClient with default settings. */
  public static final ChatServiceClient create() throws IOException {
    return create(ChatServiceSettings.newBuilder().build());
  }

  /**
   * 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.
   */
  public static final ChatServiceClient create(ChatServiceSettings settings) throws IOException {
    return new ChatServiceClient(settings);
  }

  /**
   * Constructs an instance of ChatServiceClient, using the given stub for making calls. This is for
   * advanced usage - prefer using create(ChatServiceSettings).
   */
  public static final ChatServiceClient create(ChatServiceStub stub) {
    return new ChatServiceClient(stub);
  }

  /**
   * 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.
   */
  protected ChatServiceClient(ChatServiceSettings settings) throws IOException {
    this.settings = settings;
    this.stub = ((ChatServiceStubSettings) settings.getStubSettings()).createStub();
  }

  protected ChatServiceClient(ChatServiceStub stub) {
    this.settings = null;
    this.stub = stub;
  }

  public final ChatServiceSettings getSettings() {
    return settings;
  }

  public ChatServiceStub getStub() {
    return stub;
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a message in a Google Chat space. For an example, see [Send a
   * message](https://developers.google.com/workspace/chat/create-messages).
   *
   * <p>Calling this method requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and
   * supports the following authentication types:
   *
   * <p>- 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.)
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space in which to create a message.
   *     <p>Format: `spaces/{space}`
   * @param message Required. Message body.
   * @param messageId Optional. 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 `name` field).
   *     <p>The value for this field must meet the following requirements:
   *     <ul>
   *       <li>Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but
   *           `custom-name` is not.
   *       <li>Contains up to 63 characters and only lowercase letters, numbers, and hyphens.
   *       <li>Is unique within a space. A Chat app can't use the same custom ID for different
   *           messages.
   *     </ul>
   *     <p>For details, see [Name a
   *     message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message createMessage(SpaceName parent, Message message, String messageId) {
    CreateMessageRequest request =
        CreateMessageRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setMessage(message)
            .setMessageId(messageId)
            .build();
    return createMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a message in a Google Chat space. For an example, see [Send a
   * message](https://developers.google.com/workspace/chat/create-messages).
   *
   * <p>Calling this method requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and
   * supports the following authentication types:
   *
   * <p>- 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.)
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space in which to create a message.
   *     <p>Format: `spaces/{space}`
   * @param message Required. Message body.
   * @param messageId Optional. 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 `name` field).
   *     <p>The value for this field must meet the following requirements:
   *     <ul>
   *       <li>Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but
   *           `custom-name` is not.
   *       <li>Contains up to 63 characters and only lowercase letters, numbers, and hyphens.
   *       <li>Is unique within a space. A Chat app can't use the same custom ID for different
   *           messages.
   *     </ul>
   *     <p>For details, see [Name a
   *     message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message createMessage(String parent, Message message, String messageId) {
    CreateMessageRequest request =
        CreateMessageRequest.newBuilder()
            .setParent(parent)
            .setMessage(message)
            .setMessageId(messageId)
            .build();
    return createMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a message in a Google Chat space. For an example, see [Send a
   * message](https://developers.google.com/workspace/chat/create-messages).
   *
   * <p>Calling this method requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and
   * supports the following authentication types:
   *
   * <p>- 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.)
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message createMessage(CreateMessageRequest request) {
    return createMessageCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a message in a Google Chat space. For an example, see [Send a
   * message](https://developers.google.com/workspace/chat/create-messages).
   *
   * <p>Calling this method requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and
   * supports the following authentication types:
   *
   * <p>- 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.)
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<CreateMessageRequest, Message> createMessageCallable() {
    return stub.createMessageCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/messages/list).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space to list messages from.
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMessagesPagedResponse listMessages(SpaceName parent) {
    ListMessagesRequest request =
        ListMessagesRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listMessages(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/messages/list).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space to list messages from.
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMessagesPagedResponse listMessages(String parent) {
    ListMessagesRequest request = ListMessagesRequest.newBuilder().setParent(parent).build();
    return listMessages(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/messages/list).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMessagesPagedResponse listMessages(ListMessagesRequest request) {
    return listMessagesPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/messages/list).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListMessagesRequest, ListMessagesPagedResponse>
      listMessagesPagedCallable() {
    return stub.listMessagesPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/messages/list).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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;
   *     }
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListMessagesRequest, ListMessagesResponse> listMessagesCallable() {
    return stub.listMessagesCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists memberships in a space. For an example, see [List users and Google Chat apps in a
   * space](https://developers.google.com/workspace/chat/list-members). Listing memberships with
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships,
   * including its own. Listing memberships with [User
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * lists memberships in spaces that the authenticated user has access to.
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space for which to fetch a membership list.
   *     <p>Format: spaces/{space}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMembershipsPagedResponse listMemberships(SpaceName parent) {
    ListMembershipsRequest request =
        ListMembershipsRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listMemberships(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists memberships in a space. For an example, see [List users and Google Chat apps in a
   * space](https://developers.google.com/workspace/chat/list-members). Listing memberships with
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships,
   * including its own. Listing memberships with [User
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * lists memberships in spaces that the authenticated user has access to.
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space for which to fetch a membership list.
   *     <p>Format: spaces/{space}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMembershipsPagedResponse listMemberships(String parent) {
    ListMembershipsRequest request = ListMembershipsRequest.newBuilder().setParent(parent).build();
    return listMemberships(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists memberships in a space. For an example, see [List users and Google Chat apps in a
   * space](https://developers.google.com/workspace/chat/list-members). Listing memberships with
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships,
   * including its own. Listing memberships with [User
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * lists memberships in spaces that the authenticated user has access to.
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListMembershipsPagedResponse listMemberships(ListMembershipsRequest request) {
    return listMembershipsPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists memberships in a space. For an example, see [List users and Google Chat apps in a
   * space](https://developers.google.com/workspace/chat/list-members). Listing memberships with
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships,
   * including its own. Listing memberships with [User
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * lists memberships in spaces that the authenticated user has access to.
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListMembershipsRequest, ListMembershipsPagedResponse>
      listMembershipsPagedCallable() {
    return stub.listMembershipsPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists memberships in a space. For an example, see [List users and Google Chat apps in a
   * space](https://developers.google.com/workspace/chat/list-members). Listing memberships with
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships,
   * including its own. Listing memberships with [User
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * lists memberships in spaces that the authenticated user has access to.
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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;
   *     }
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListMembershipsRequest, ListMembershipsResponse>
      listMembershipsCallable() {
    return stub.listMembershipsCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a membership. For an example, see [Get details about a user's or Google
   * Chat app's membership](https://developers.google.com/workspace/chat/get-members).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the membership to retrieve.
   *     <p>To get the app's own membership, you can optionally use `spaces/{space}/members/app`.
   *     <p>Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
   *     <p>When [authenticated as a
   *     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you
   *     can use the user's email as an alias for `{member}`. For example,
   *     `spaces/{space}/members/example{@literal @}gmail.com` where `example{@literal @}gmail.com`
   *     is the email of the Google Chat user.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership getMembership(MembershipName name) {
    GetMembershipRequest request =
        GetMembershipRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a membership. For an example, see [Get details about a user's or Google
   * Chat app's membership](https://developers.google.com/workspace/chat/get-members).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the membership to retrieve.
   *     <p>To get the app's own membership, you can optionally use `spaces/{space}/members/app`.
   *     <p>Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
   *     <p>When [authenticated as a
   *     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you
   *     can use the user's email as an alias for `{member}`. For example,
   *     `spaces/{space}/members/example{@literal @}gmail.com` where `example{@literal @}gmail.com`
   *     is the email of the Google Chat user.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership getMembership(String name) {
    GetMembershipRequest request = GetMembershipRequest.newBuilder().setName(name).build();
    return getMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a membership. For an example, see [Get details about a user's or Google
   * Chat app's membership](https://developers.google.com/workspace/chat/get-members).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership getMembership(GetMembershipRequest request) {
    return getMembershipCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a membership. For an example, see [Get details about a user's or Google
   * Chat app's membership](https://developers.google.com/workspace/chat/get-members).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<GetMembershipRequest, Membership> getMembershipCallable() {
    return stub.getMembershipCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a message. For an example, see [Get details about a
   * message](https://developers.google.com/workspace/chat/get-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Note: Might return a message from a blocked member or space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the message.
   *     <p>Format: `spaces/{space}/messages/{message}`
   *     <p>If you've set a custom ID for your message, you can use the value from the
   *     `clientAssignedMessageId` field for `{message}`. For details, see [Name a message]
   *     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message getMessage(MessageName name) {
    GetMessageRequest request =
        GetMessageRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a message. For an example, see [Get details about a
   * message](https://developers.google.com/workspace/chat/get-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Note: Might return a message from a blocked member or space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the message.
   *     <p>Format: `spaces/{space}/messages/{message}`
   *     <p>If you've set a custom ID for your message, you can use the value from the
   *     `clientAssignedMessageId` field for `{message}`. For details, see [Name a message]
   *     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message getMessage(String name) {
    GetMessageRequest request = GetMessageRequest.newBuilder().setName(name).build();
    return getMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a message. For an example, see [Get details about a
   * message](https://developers.google.com/workspace/chat/get-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Note: Might return a message from a blocked member or space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message getMessage(GetMessageRequest request) {
    return getMessageCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a message. For an example, see [Get details about a
   * message](https://developers.google.com/workspace/chat/get-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Note: Might return a message from a blocked member or space.
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<GetMessageRequest, Message> getMessageCallable() {
    return stub.getMessageCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/update-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only update messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param message Required. Message with fields updated.
   * @param updateMask Required. The field paths to update. Separate multiple values with commas or
   *     use `&#42;` to update all field paths.
   *     <p>Currently supported field paths:
   *     <p>- `text`
   *     <p>- `attachment`
   *     <p>- `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)
   *     <p>- `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)
   *     <p>- `accessory_widgets` (Requires [app
   *     authentication](/chat/api/guides/auth/service-accounts).)
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message updateMessage(Message message, FieldMask updateMask) {
    UpdateMessageRequest request =
        UpdateMessageRequest.newBuilder().setMessage(message).setUpdateMask(updateMask).build();
    return updateMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/update-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only update messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Message updateMessage(UpdateMessageRequest request) {
    return updateMessageCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/update-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only update messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<UpdateMessageRequest, Message> updateMessageCallable() {
    return stub.updateMessageCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a message. For an example, see [Delete a
   * message](https://developers.google.com/workspace/chat/delete-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only delete messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the message.
   *     <p>Format: `spaces/{space}/messages/{message}`
   *     <p>If you've set a custom ID for your message, you can use the value from the
   *     `clientAssignedMessageId` field for `{message}`. For details, see [Name a message]
   *     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteMessage(MessageName name) {
    DeleteMessageRequest request =
        DeleteMessageRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    deleteMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a message. For an example, see [Delete a
   * message](https://developers.google.com/workspace/chat/delete-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only delete messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the message.
   *     <p>Format: `spaces/{space}/messages/{message}`
   *     <p>If you've set a custom ID for your message, you can use the value from the
   *     `clientAssignedMessageId` field for `{message}`. For details, see [Name a message]
   *     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteMessage(String name) {
    DeleteMessageRequest request = DeleteMessageRequest.newBuilder().setName(name).build();
    deleteMessage(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a message. For an example, see [Delete a
   * message](https://developers.google.com/workspace/chat/delete-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only delete messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteMessage(DeleteMessageRequest request) {
    deleteMessageCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a message. For an example, see [Delete a
   * message](https://developers.google.com/workspace/chat/delete-messages).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   * When using app authentication, requests can only delete messages created by the calling Chat
   * app.
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<DeleteMessageRequest, Empty> deleteMessageCallable() {
    return stub.deleteMessageCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets the metadata of a message attachment. The attachment data is fetched using the [media
   * API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an
   * example, see [Get metadata about a message
   * attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the attachment, in the form
   *     `spaces/&#42;/messages/&#42;/attachments/&#42;`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Attachment getAttachment(AttachmentName name) {
    GetAttachmentRequest request =
        GetAttachmentRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getAttachment(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets the metadata of a message attachment. The attachment data is fetched using the [media
   * API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an
   * example, see [Get metadata about a message
   * attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the attachment, in the form
   *     `spaces/&#42;/messages/&#42;/attachments/&#42;`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Attachment getAttachment(String name) {
    GetAttachmentRequest request = GetAttachmentRequest.newBuilder().setName(name).build();
    return getAttachment(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets the metadata of a message attachment. The attachment data is fetched using the [media
   * API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an
   * example, see [Get metadata about a message
   * attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Attachment getAttachment(GetAttachmentRequest request) {
    return getAttachmentCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets the metadata of a message attachment. The attachment data is fetched using the [media
   * API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an
   * example, see [Get metadata about a message
   * attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<GetAttachmentRequest, Attachment> getAttachmentCallable() {
    return stub.getAttachmentCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Uploads an attachment. For an example, see [Upload media as a file
   * attachment](https://developers.google.com/workspace/chat/upload-media-attachments). Requires
   * user
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>You can upload attachments up to 200 MB. Certain file types aren't supported. For details,
   * see [File types blocked by Google
   * Chat](https://support.google.com/chat/answer/7651457?&amp;co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final UploadAttachmentResponse uploadAttachment(UploadAttachmentRequest request) {
    return uploadAttachmentCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Uploads an attachment. For an example, see [Upload media as a file
   * attachment](https://developers.google.com/workspace/chat/upload-media-attachments). Requires
   * user
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>You can upload attachments up to 200 MB. Certain file types aren't supported. For details,
   * see [File types blocked by Google
   * Chat](https://support.google.com/chat/answer/7651457?&amp;co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<UploadAttachmentRequest, UploadAttachmentResponse>
      uploadAttachmentCallable() {
    return stub.uploadAttachmentCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/list-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed
   * until the first message is sent.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListSpacesPagedResponse listSpaces() {
    ListSpacesRequest request = ListSpacesRequest.newBuilder().build();
    return listSpaces(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/list-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed
   * until the first message is sent.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListSpacesPagedResponse listSpaces(ListSpacesRequest request) {
    return listSpacesPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/list-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed
   * until the first message is sent.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListSpacesRequest, ListSpacesPagedResponse> listSpacesPagedCallable() {
    return stub.listSpacesPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/list-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed
   * until the first message is sent.
   *
   * <p>Sample code:
   *
   * <pre>{@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;
   *     }
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListSpacesRequest, ListSpacesResponse> listSpacesCallable() {
    return stub.listSpacesCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a space. For an example, see [Get details about a
   * space](https://developers.google.com/workspace/chat/get-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the space, in the form "spaces/&#42;".
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space getSpace(SpaceName name) {
    GetSpaceRequest request =
        GetSpaceRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a space. For an example, see [Get details about a
   * space](https://developers.google.com/workspace/chat/get-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the space, in the form "spaces/&#42;".
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space getSpace(String name) {
    GetSpaceRequest request = GetSpaceRequest.newBuilder().setName(name).build();
    return getSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a space. For an example, see [Get details about a
   * space](https://developers.google.com/workspace/chat/get-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space getSpace(GetSpaceRequest request) {
    return getSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Returns details about a space. For an example, see [Get details about a
   * space](https://developers.google.com/workspace/chat/get-spaces).
   *
   * <p>Requires
   * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports
   * [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   * and [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<GetSpaceRequest, Space> getSpaceCallable() {
    return stub.getSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a
   * space](https://developers.google.com/workspace/chat/create-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param space Required. The `displayName` and `spaceType` fields must be populated. Only
   *     `SpaceType.SPACE` is supported.
   *     <p>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.
   *     <p>The space `name` is assigned on the server so anything specified in this field will be
   *     ignored.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space createSpace(Space space) {
    CreateSpaceRequest request = CreateSpaceRequest.newBuilder().setSpace(space).build();
    return createSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a
   * space](https://developers.google.com/workspace/chat/create-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space createSpace(CreateSpaceRequest request) {
    return createSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a
   * space](https://developers.google.com/workspace/chat/create-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<CreateSpaceRequest, Space> createSpaceCallable() {
    return stub.createSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/set-up-spaces).
   *
   * <p>To specify the human members to add, add memberships with the appropriate `member.name` in
   * the `SetUpSpaceRequest`. 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{@literal @}example.com` is `123456789`,
   * you can add the user to the space by setting the `membership.member.name` to
   * `users/user{@literal @}example.com` or `users/123456789`.
   *
   * <p>For a space or group chat, if the caller blocks or is blocked by some members, then those
   * members aren't added to the created space.
   *
   * <p>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.
   *
   * <p>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](https://developers.google.com/workspace/chat/create-members).
   *
   * <p>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.
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space setUpSpace(SetUpSpaceRequest request) {
    return setUpSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/set-up-spaces).
   *
   * <p>To specify the human members to add, add memberships with the appropriate `member.name` in
   * the `SetUpSpaceRequest`. 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{@literal @}example.com` is `123456789`,
   * you can add the user to the space by setting the `membership.member.name` to
   * `users/user{@literal @}example.com` or `users/123456789`.
   *
   * <p>For a space or group chat, if the caller blocks or is blocked by some members, then those
   * members aren't added to the created space.
   *
   * <p>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.
   *
   * <p>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](https://developers.google.com/workspace/chat/create-members).
   *
   * <p>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.
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<SetUpSpaceRequest, Space> setUpSpaceCallable() {
    return stub.setUpSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a space. For an example, see [Update a
   * space](https://developers.google.com/workspace/chat/update-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param space Required. Space with fields to be updated. `Space.name` must be populated in the
   *     form of `spaces/{space}`. Only fields specified by `update_mask` are updated.
   * @param updateMask Required. The updated field paths, comma separated if there are multiple.
   *     <p>Currently supported field paths:
   *     <p>- `display_name` (Only supports changing the display name of a space with the `SPACE`
   *     type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to
   *     `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space
   *     results in an invalid argument error. If you receive the error message `ALREADY_EXISTS`
   *     when updating the `displayName`, try a different `displayName`. An existing space within
   *     the Google Workspace organization might already use this display name.)
   *     <p>- `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include
   *     `display_name` together with `space_type` in the update mask and ensure that the specified
   *     space has a non-empty display name and the `SPACE` space type. Including the `space_type`
   *     mask and the `SPACE` type in the specified space when updating the display name is optional
   *     if the existing space already has the `SPACE` type. Trying to update the space type in
   *     other ways results in an invalid argument error).
   *     <p>- `space_details`
   *     <p>- `space_history_state` (Supports [turning history on or off for the
   *     space](https://support.google.com/chat/answer/7664687) if [the organization allows users to
   *     change their history setting](https://support.google.com/a/answer/7664184). Warning:
   *     mutually exclusive with all other field paths.)
   *     <p>- Developer Preview: `access_settings.audience` (Supports changing the [access
   *     setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is
   *     specified in the access setting, the space's access setting is updated to restricted.
   *     Warning: mutually exclusive with all other field paths.)
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space updateSpace(Space space, FieldMask updateMask) {
    UpdateSpaceRequest request =
        UpdateSpaceRequest.newBuilder().setSpace(space).setUpdateMask(updateMask).build();
    return updateSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a space. For an example, see [Update a
   * space](https://developers.google.com/workspace/chat/update-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space updateSpace(UpdateSpaceRequest request) {
    return updateSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a space. For an example, see [Update a
   * space](https://developers.google.com/workspace/chat/update-spaces).
   *
   * <p>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.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<UpdateSpaceRequest, Space> updateSpaceCallable() {
    return stub.updateSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/delete-spaces).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * from a user who has permission to delete the space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the space to delete.
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteSpace(SpaceName name) {
    DeleteSpaceRequest request =
        DeleteSpaceRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    deleteSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/delete-spaces).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * from a user who has permission to delete the space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Resource name of the space to delete.
   *     <p>Format: `spaces/{space}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteSpace(String name) {
    DeleteSpaceRequest request = DeleteSpaceRequest.newBuilder().setName(name).build();
    deleteSpace(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/delete-spaces).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * from a user who has permission to delete the space.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteSpace(DeleteSpaceRequest request) {
    deleteSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/delete-spaces).
   * Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * from a user who has permission to delete the space.
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<DeleteSpaceRequest, Empty> deleteSpaceCallable() {
    return stub.deleteSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Completes the [import process](https://developers.google.com/workspace/chat/import-data) 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](https://developers.google.com/workspace/chat/authorize-import).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final CompleteImportSpaceResponse completeImportSpace(CompleteImportSpaceRequest request) {
    return completeImportSpaceCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Completes the [import process](https://developers.google.com/workspace/chat/import-data) 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](https://developers.google.com/workspace/chat/authorize-import).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<CompleteImportSpaceRequest, CompleteImportSpaceResponse>
      completeImportSpaceCallable() {
    return stub.completeImportSpaceCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/spaces/find-direct-message).
   *
   * <p>With [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
   * returns the direct message space between the specified user and the authenticated user.
   *
   * <p>With [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
   * returns the direct message space between the specified user and the calling Chat app.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * or [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Space findDirectMessage(FindDirectMessageRequest request) {
    return findDirectMessageCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](/chat/api/guides/v1/spaces/find-direct-message).
   *
   * <p>With [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
   * returns the direct message space between the specified user and the authenticated user.
   *
   * <p>With [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
   * returns the direct message space between the specified user and the calling Chat app.
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   * or [app
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<FindDirectMessageRequest, Space> findDirectMessageCallable() {
    return stub.findDirectMessageCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/create-members). 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](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>To specify the member to add, set the `membership.member.name` in the
   * `CreateMembershipRequest`:
   *
   * <p>- 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.
   *
   * <p>- 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{@literal @}example.com` is `123456789`, you can add the user to
   * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
   * `users/123456789`.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space for which to create the membership.
   *     <p>Format: spaces/{space}
   * @param membership Required. The membership relation to create. The `memberType` field must
   *     contain a user with the `user.name` and `user.type` fields populated. The server will
   *     assign a resource name and overwrite anything specified. When a Chat app creates a
   *     membership relation for a human user, it must use the `chat.memberships` scope, set
   *     `user.type` to `HUMAN`, and set `user.name` with format `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` of the
   *     [person](https://developers.google.com/people/api/rest/v1/people) 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{@literal @}example.com` is `123456789`, you can add the user to the space by
   *     setting the `membership.member.name` to `users/user{@literal @}example.com` or
   *     `users/123456789`. When a Chat app creates a membership relation for itself, it must use
   *     the `chat.memberships.app` scope, set `user.type` to `BOT`, and set `user.name` to
   *     `users/app`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership createMembership(SpaceName parent, Membership membership) {
    CreateMembershipRequest request =
        CreateMembershipRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setMembership(membership)
            .build();
    return createMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/create-members). 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](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>To specify the member to add, set the `membership.member.name` in the
   * `CreateMembershipRequest`:
   *
   * <p>- 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.
   *
   * <p>- 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{@literal @}example.com` is `123456789`, you can add the user to
   * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
   * `users/123456789`.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The resource name of the space for which to create the membership.
   *     <p>Format: spaces/{space}
   * @param membership Required. The membership relation to create. The `memberType` field must
   *     contain a user with the `user.name` and `user.type` fields populated. The server will
   *     assign a resource name and overwrite anything specified. When a Chat app creates a
   *     membership relation for a human user, it must use the `chat.memberships` scope, set
   *     `user.type` to `HUMAN`, and set `user.name` with format `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` of the
   *     [person](https://developers.google.com/people/api/rest/v1/people) 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{@literal @}example.com` is `123456789`, you can add the user to the space by
   *     setting the `membership.member.name` to `users/user{@literal @}example.com` or
   *     `users/123456789`. When a Chat app creates a membership relation for itself, it must use
   *     the `chat.memberships.app` scope, set `user.type` to `BOT`, and set `user.name` to
   *     `users/app`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership createMembership(String parent, Membership membership) {
    CreateMembershipRequest request =
        CreateMembershipRequest.newBuilder().setParent(parent).setMembership(membership).build();
    return createMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/create-members). 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](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>To specify the member to add, set the `membership.member.name` in the
   * `CreateMembershipRequest`:
   *
   * <p>- 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.
   *
   * <p>- 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{@literal @}example.com` is `123456789`, you can add the user to
   * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
   * `users/123456789`.
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership createMembership(CreateMembershipRequest request) {
    return createMembershipCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * 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](https://developers.google.com/workspace/chat/create-members). 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](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>To specify the member to add, set the `membership.member.name` in the
   * `CreateMembershipRequest`:
   *
   * <p>- 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.
   *
   * <p>- 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{@literal @}example.com` is `123456789`, you can add the user to
   * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
   * `users/123456789`.
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<CreateMembershipRequest, Membership> createMembershipCallable() {
    return stub.createMembershipCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a membership. Requires [user
   * authentication](https://developers.google.com/chat/api/guides/auth/users).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param membership Required. The membership to update. Only fields specified by `update_mask`
   *     are updated.
   * @param updateMask Required. The field paths to update. Separate multiple values with commas or
   *     use `&#42;` to update all field paths.
   *     <p>Currently supported field paths:
   *     <p>- `role`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership updateMembership(Membership membership, FieldMask updateMask) {
    UpdateMembershipRequest request =
        UpdateMembershipRequest.newBuilder()
            .setMembership(membership)
            .setUpdateMask(updateMask)
            .build();
    return updateMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a membership. Requires [user
   * authentication](https://developers.google.com/chat/api/guides/auth/users).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership updateMembership(UpdateMembershipRequest request) {
    return updateMembershipCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a membership. Requires [user
   * authentication](https://developers.google.com/chat/api/guides/auth/users).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<UpdateMembershipRequest, Membership> updateMembershipCallable() {
    return stub.updateMembershipCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a membership. For an example, see [Remove a user or a Google Chat app from a
   * space](https://developers.google.com/workspace/chat/delete-members).
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. 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.
   *     <p>When deleting a human membership, requires the `chat.memberships` scope and
   *     `spaces/{space}/members/{member}` format. You can use the email as an alias for `{member}`.
   *     For example, `spaces/{space}/members/example{@literal @}gmail.com` where
   *     `example{@literal @}gmail.com` is the email of the Google Chat user.
   *     <p>When deleting an app membership, requires the `chat.memberships.app` scope and
   *     `spaces/{space}/members/app` format.
   *     <p>Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership deleteMembership(MembershipName name) {
    DeleteMembershipRequest request =
        DeleteMembershipRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return deleteMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a membership. For an example, see [Remove a user or a Google Chat app from a
   * space](https://developers.google.com/workspace/chat/delete-members).
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. 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.
   *     <p>When deleting a human membership, requires the `chat.memberships` scope and
   *     `spaces/{space}/members/{member}` format. You can use the email as an alias for `{member}`.
   *     For example, `spaces/{space}/members/example{@literal @}gmail.com` where
   *     `example{@literal @}gmail.com` is the email of the Google Chat user.
   *     <p>When deleting an app membership, requires the `chat.memberships.app` scope and
   *     `spaces/{space}/members/app` format.
   *     <p>Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership deleteMembership(String name) {
    DeleteMembershipRequest request = DeleteMembershipRequest.newBuilder().setName(name).build();
    return deleteMembership(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a membership. For an example, see [Remove a user or a Google Chat app from a
   * space](https://developers.google.com/workspace/chat/delete-members).
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Membership deleteMembership(DeleteMembershipRequest request) {
    return deleteMembershipCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a membership. For an example, see [Remove a user or a Google Chat app from a
   * space](https://developers.google.com/workspace/chat/delete-members).
   *
   * <p>Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<DeleteMembershipRequest, Membership> deleteMembershipCallable() {
    return stub.deleteMembershipCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example,
   * see [Add a reaction to a
   * message](https://developers.google.com/workspace/chat/create-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The message where the reaction is created.
   *     <p>Format: `spaces/{space}/messages/{message}`
   * @param reaction Required. The reaction to create.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Reaction createReaction(MessageName parent, Reaction reaction) {
    CreateReactionRequest request =
        CreateReactionRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setReaction(reaction)
            .build();
    return createReaction(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example,
   * see [Add a reaction to a
   * message](https://developers.google.com/workspace/chat/create-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param parent Required. The message where the reaction is created.
   *     <p>Format: `spaces/{space}/messages/{message}`
   * @param reaction Required. The reaction to create.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Reaction createReaction(String parent, Reaction reaction) {
    CreateReactionRequest request =
        CreateReactionRequest.newBuilder().setParent(parent).setReaction(reaction).build();
    return createReaction(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example,
   * see [Add a reaction to a
   * message](https://developers.google.com/workspace/chat/create-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final Reaction createReaction(CreateReactionRequest request) {
    return createReactionCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example,
   * see [Add a reaction to a
   * message](https://developers.google.com/workspace/chat/create-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<CreateReactionRequest, Reaction> createReactionCallable() {
    return stub.createReactionCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists reactions to a message. For an example, see [List reactions for a
   * message](https://developers.google.com/workspace/chat/list-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The message users reacted to.
   *     <p>Format: `spaces/{space}/messages/{message}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListReactionsPagedResponse listReactions(MessageName parent) {
    ListReactionsRequest request =
        ListReactionsRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listReactions(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists reactions to a message. For an example, see [List reactions for a
   * message](https://developers.google.com/workspace/chat/list-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param parent Required. The message users reacted to.
   *     <p>Format: `spaces/{space}/messages/{message}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListReactionsPagedResponse listReactions(String parent) {
    ListReactionsRequest request = ListReactionsRequest.newBuilder().setParent(parent).build();
    return listReactions(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists reactions to a message. For an example, see [List reactions for a
   * message](https://developers.google.com/workspace/chat/list-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListReactionsPagedResponse listReactions(ListReactionsRequest request) {
    return listReactionsPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists reactions to a message. For an example, see [List reactions for a
   * message](https://developers.google.com/workspace/chat/list-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListReactionsRequest, ListReactionsPagedResponse>
      listReactionsPagedCallable() {
    return stub.listReactionsPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists reactions to a message. For an example, see [List reactions for a
   * message](https://developers.google.com/workspace/chat/list-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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;
   *     }
   *   }
   * }
   * }</pre>
   */
  public final UnaryCallable<ListReactionsRequest, ListReactionsResponse> listReactionsCallable() {
    return stub.listReactionsCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete
   * a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Name of the reaction to delete.
   *     <p>Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteReaction(ReactionName name) {
    DeleteReactionRequest request =
        DeleteReactionRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    deleteReaction(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete
   * a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param name Required. Name of the reaction to delete.
   *     <p>Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteReaction(String name) {
    DeleteReactionRequest request = DeleteReactionRequest.newBuilder().setName(name).build();
    deleteReaction(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete
   * a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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);
   * }
   * }</pre>
   *
   * @param request The request object containing all of the parameters for the API call.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final void deleteReaction(DeleteReactionRequest request) {
    deleteReactionCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete
   * a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user
   * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   *
   * <p>Sample code:
   *
   * <pre>{@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();
   * }
   * }</pre>
   */
  public final UnaryCallable<DeleteReactionRequest, Empty> deleteReactionCallable() {
    return stub.deleteReactionCallable();
  }

  @Override
  public final void close() {
    stub.close();
  }

  @Override
  public void shutdown() {
    stub.shutdown();
  }

  @Override
  public boolean isShutdown() {
    return stub.isShutdown();
  }

  @Override
  public boolean isTerminated() {
    return stub.isTerminated();
  }

  @Override
  public void shutdownNow() {
    stub.shutdownNow();
  }

  @Override
  public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
    return stub.awaitTermination(duration, unit);
  }

  public static class ListMessagesPagedResponse
      extends AbstractPagedListResponse<
          ListMessagesRequest,
          ListMessagesResponse,
          Message,
          ListMessagesPage,
          ListMessagesFixedSizeCollection> {

    public static ApiFuture<ListMessagesPagedResponse> createAsync(
        PageContext<ListMessagesRequest, ListMessagesResponse, Message> context,
        ApiFuture<ListMessagesResponse> futureResponse) {
      ApiFuture<ListMessagesPage> futurePage =
          ListMessagesPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListMessagesPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListMessagesPagedResponse(ListMessagesPage page) {
      super(page, ListMessagesFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListMessagesPage
      extends AbstractPage<ListMessagesRequest, ListMessagesResponse, Message, ListMessagesPage> {

    private ListMessagesPage(
        PageContext<ListMessagesRequest, ListMessagesResponse, Message> context,
        ListMessagesResponse response) {
      super(context, response);
    }

    private static ListMessagesPage createEmptyPage() {
      return new ListMessagesPage(null, null);
    }

    @Override
    protected ListMessagesPage createPage(
        PageContext<ListMessagesRequest, ListMessagesResponse, Message> context,
        ListMessagesResponse response) {
      return new ListMessagesPage(context, response);
    }

    @Override
    public ApiFuture<ListMessagesPage> createPageAsync(
        PageContext<ListMessagesRequest, ListMessagesResponse, Message> context,
        ApiFuture<ListMessagesResponse> futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListMessagesFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListMessagesRequest,
          ListMessagesResponse,
          Message,
          ListMessagesPage,
          ListMessagesFixedSizeCollection> {

    private ListMessagesFixedSizeCollection(List<ListMessagesPage> pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListMessagesFixedSizeCollection createEmptyCollection() {
      return new ListMessagesFixedSizeCollection(null, 0);
    }

    @Override
    protected ListMessagesFixedSizeCollection createCollection(
        List<ListMessagesPage> pages, int collectionSize) {
      return new ListMessagesFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListMembershipsPagedResponse
      extends AbstractPagedListResponse<
          ListMembershipsRequest,
          ListMembershipsResponse,
          Membership,
          ListMembershipsPage,
          ListMembershipsFixedSizeCollection> {

    public static ApiFuture<ListMembershipsPagedResponse> createAsync(
        PageContext<ListMembershipsRequest, ListMembershipsResponse, Membership> context,
        ApiFuture<ListMembershipsResponse> futureResponse) {
      ApiFuture<ListMembershipsPage> futurePage =
          ListMembershipsPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListMembershipsPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListMembershipsPagedResponse(ListMembershipsPage page) {
      super(page, ListMembershipsFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListMembershipsPage
      extends AbstractPage<
          ListMembershipsRequest, ListMembershipsResponse, Membership, ListMembershipsPage> {

    private ListMembershipsPage(
        PageContext<ListMembershipsRequest, ListMembershipsResponse, Membership> context,
        ListMembershipsResponse response) {
      super(context, response);
    }

    private static ListMembershipsPage createEmptyPage() {
      return new ListMembershipsPage(null, null);
    }

    @Override
    protected ListMembershipsPage createPage(
        PageContext<ListMembershipsRequest, ListMembershipsResponse, Membership> context,
        ListMembershipsResponse response) {
      return new ListMembershipsPage(context, response);
    }

    @Override
    public ApiFuture<ListMembershipsPage> createPageAsync(
        PageContext<ListMembershipsRequest, ListMembershipsResponse, Membership> context,
        ApiFuture<ListMembershipsResponse> futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListMembershipsFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListMembershipsRequest,
          ListMembershipsResponse,
          Membership,
          ListMembershipsPage,
          ListMembershipsFixedSizeCollection> {

    private ListMembershipsFixedSizeCollection(
        List<ListMembershipsPage> pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListMembershipsFixedSizeCollection createEmptyCollection() {
      return new ListMembershipsFixedSizeCollection(null, 0);
    }

    @Override
    protected ListMembershipsFixedSizeCollection createCollection(
        List<ListMembershipsPage> pages, int collectionSize) {
      return new ListMembershipsFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListSpacesPagedResponse
      extends AbstractPagedListResponse<
          ListSpacesRequest,
          ListSpacesResponse,
          Space,
          ListSpacesPage,
          ListSpacesFixedSizeCollection> {

    public static ApiFuture<ListSpacesPagedResponse> createAsync(
        PageContext<ListSpacesRequest, ListSpacesResponse, Space> context,
        ApiFuture<ListSpacesResponse> futureResponse) {
      ApiFuture<ListSpacesPage> futurePage =
          ListSpacesPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage, input -> new ListSpacesPagedResponse(input), MoreExecutors.directExecutor());
    }

    private ListSpacesPagedResponse(ListSpacesPage page) {
      super(page, ListSpacesFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListSpacesPage
      extends AbstractPage<ListSpacesRequest, ListSpacesResponse, Space, ListSpacesPage> {

    private ListSpacesPage(
        PageContext<ListSpacesRequest, ListSpacesResponse, Space> context,
        ListSpacesResponse response) {
      super(context, response);
    }

    private static ListSpacesPage createEmptyPage() {
      return new ListSpacesPage(null, null);
    }

    @Override
    protected ListSpacesPage createPage(
        PageContext<ListSpacesRequest, ListSpacesResponse, Space> context,
        ListSpacesResponse response) {
      return new ListSpacesPage(context, response);
    }

    @Override
    public ApiFuture<ListSpacesPage> createPageAsync(
        PageContext<ListSpacesRequest, ListSpacesResponse, Space> context,
        ApiFuture<ListSpacesResponse> futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListSpacesFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListSpacesRequest,
          ListSpacesResponse,
          Space,
          ListSpacesPage,
          ListSpacesFixedSizeCollection> {

    private ListSpacesFixedSizeCollection(List<ListSpacesPage> pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListSpacesFixedSizeCollection createEmptyCollection() {
      return new ListSpacesFixedSizeCollection(null, 0);
    }

    @Override
    protected ListSpacesFixedSizeCollection createCollection(
        List<ListSpacesPage> pages, int collectionSize) {
      return new ListSpacesFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListReactionsPagedResponse
      extends AbstractPagedListResponse<
          ListReactionsRequest,
          ListReactionsResponse,
          Reaction,
          ListReactionsPage,
          ListReactionsFixedSizeCollection> {

    public static ApiFuture<ListReactionsPagedResponse> createAsync(
        PageContext<ListReactionsRequest, ListReactionsResponse, Reaction> context,
        ApiFuture<ListReactionsResponse> futureResponse) {
      ApiFuture<ListReactionsPage> futurePage =
          ListReactionsPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListReactionsPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListReactionsPagedResponse(ListReactionsPage page) {
      super(page, ListReactionsFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListReactionsPage
      extends AbstractPage<
          ListReactionsRequest, ListReactionsResponse, Reaction, ListReactionsPage> {

    private ListReactionsPage(
        PageContext<ListReactionsRequest, ListReactionsResponse, Reaction> context,
        ListReactionsResponse response) {
      super(context, response);
    }

    private static ListReactionsPage createEmptyPage() {
      return new ListReactionsPage(null, null);
    }

    @Override
    protected ListReactionsPage createPage(
        PageContext<ListReactionsRequest, ListReactionsResponse, Reaction> context,
        ListReactionsResponse response) {
      return new ListReactionsPage(context, response);
    }

    @Override
    public ApiFuture<ListReactionsPage> createPageAsync(
        PageContext<ListReactionsRequest, ListReactionsResponse, Reaction> context,
        ApiFuture<ListReactionsResponse> futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListReactionsFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListReactionsRequest,
          ListReactionsResponse,
          Reaction,
          ListReactionsPage,
          ListReactionsFixedSizeCollection> {

    private ListReactionsFixedSizeCollection(List<ListReactionsPage> pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListReactionsFixedSizeCollection createEmptyCollection() {
      return new ListReactionsFixedSizeCollection(null, 0);
    }

    @Override
    protected ListReactionsFixedSizeCollection createCollection(
        List<ListReactionsPage> pages, int collectionSize) {
      return new ListReactionsFixedSizeCollection(pages, collectionSize);
    }
  }
}