chore: Update generation configuration at Thu Jun 27 02:13:53 UTC 2024 (

#10995)

* chore: Update generation configuration at Thu Jun 27 02:13:53 UTC 2024

* chore: generate libraries at Thu Jun 27 02:17:16 UTC 2024

generation_config.yaml

@@ -1,5 +1,5 @@
 gapic_generator_version: 2.42.0
-googleapis_commitish: 46eb6505cc4b8340d304510d7226de96bafe9314
+googleapis_commitish: efae79d0ba30034f2dd075d0213d09e93ebeccff
 libraries_bom_version: 26.42.0
 
 # the libraries are ordered with respect to library name, which is

java-chat/google-cloud-chat/src/main/java/com/google/chat/v1/ChatServiceClient.java

@@ -307,6 +307,7 @@
  *      <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 `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user{@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>  To specify the Google groups to add, add memberships with the appropriate `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group{@literal @}example.com`, then you can add the group to the space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces.
  * <p>  For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space.
  * <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).
@@ -397,9 +398,10 @@
  *    <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` for the human or app member.
+ * <p>  To specify the member to add, set the `membership.member.name` for the human or app member, or set the `membership.group_member.name` for the group member.
  * <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>
+ * <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>  - To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group{@literal @}example.com`, then you can add or invite the group to a named space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -2546,6 +2548,15 @@ public final UnaryCallable<CreateSpaceRequest, Space> createSpaceCallable() {
    * you can add the user to the space by setting the `membership.member.name` to
    * `users/user{@literal @}example.com` or `users/123456789`.
    *
+   * <p>To specify the Google groups to add, add memberships with the appropriate
+   * `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where
+   * `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can
+   * use [Cloud Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add the group to the
+   * space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not
+   * supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>For a named space or group chat, if the caller blocks, or is blocked by some members, or
    * doesn't have permission to add some members, then those members aren't added to the created
    * space.
@@ -2610,6 +2621,15 @@ public final Space setUpSpace(SetUpSpaceRequest request) {
    * you can add the user to the space by setting the `membership.member.name` to
    * `users/user{@literal @}example.com` or `users/123456789`.
    *
+   * <p>To specify the Google groups to add, add memberships with the appropriate
+   * `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where
+   * `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can
+   * use [Cloud Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add the group to the
+   * space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not
+   * supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>For a named space or group chat, if the caller blocks, or is blocked by some members, or
    * doesn't have permission to add some members, then those members aren't added to the created
    * space.
@@ -3072,7 +3092,8 @@ public final UnaryCallable<FindDirectMessageRequest, Space> findDirectMessageCal
    * 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` for the human or app member.
+   * <p>To specify the member to add, set the `membership.member.name` for the human or app member,
+   * or set the `membership.group_member.name` for the group member.
    *
    * <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.
@@ -3084,6 +3105,14 @@ public final UnaryCallable<FindDirectMessageRequest, Space> findDirectMessageCal
    * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
    * `users/123456789`.
    *
+   * <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
+   * the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
+   * Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
+   * group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
+   * Group email is not supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -3136,7 +3165,8 @@ public final Membership createMembership(SpaceName parent, Membership 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` for the human or app member.
+   * <p>To specify the member to add, set the `membership.member.name` for the human or app member,
+   * or set the `membership.group_member.name` for the group member.
    *
    * <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.
@@ -3148,6 +3178,14 @@ public final Membership createMembership(SpaceName parent, Membership membership
    * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
    * `users/123456789`.
    *
+   * <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
+   * the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
+   * Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
+   * group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
+   * Group email is not supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -3197,7 +3235,8 @@ public final Membership createMembership(String parent, Membership 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` for the human or app member.
+   * <p>To specify the member to add, set the `membership.member.name` for the human or app member,
+   * or set the `membership.group_member.name` for the group member.
    *
    * <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.
@@ -3209,6 +3248,14 @@ public final Membership createMembership(String parent, Membership membership) {
    * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
    * `users/123456789`.
    *
+   * <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
+   * the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
+   * Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
+   * group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
+   * Group email is not supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -3244,7 +3291,8 @@ public final Membership createMembership(CreateMembershipRequest request) {
    * 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` for the human or app member.
+   * <p>To specify the member to add, set the `membership.member.name` for the human or app member,
+   * or set the `membership.group_member.name` for the group member.
    *
    * <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.
@@ -3256,6 +3304,14 @@ public final Membership createMembership(CreateMembershipRequest request) {
    * the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
    * `users/123456789`.
    *
+   * <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
+   * the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
+   * Identity Groups lookup
+   * API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
+   * `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
+   * group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
+   * Group email is not supported, and Google groups can only be added as members in named spaces.
+   *
    * <p>Sample code:
    *
    * <pre>{@code