You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: java-chat/google-cloud-chat/src/main/java/com/google/chat/v1/ChatServiceClient.java
+62-6Lines changed: 62 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -307,6 +307,7 @@
307
307
* <td><p> SetUpSpace</td>
308
308
* <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).
309
309
* <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`.
310
+
* <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.
310
311
* <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.
311
312
* <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.
312
313
* <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 @@
397
398
* <tr>
398
399
* <td><p> CreateMembership</td>
399
400
* <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).
400
-
* <p> To specify the member to add, set the `membership.member.name` for the human or app member.
401
+
* <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.
401
402
* <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.
402
-
* <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>
403
+
* <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`.
404
+
* <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>
403
405
* <td>
404
406
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
405
407
* <ul>
@@ -2546,6 +2548,15 @@ public final UnaryCallable<CreateSpaceRequest, Space> createSpaceCallable() {
2546
2548
* you can add the user to the space by setting the `membership.member.name` to
2547
2549
* `users/user{@literal @}example.com` or `users/123456789`.
2548
2550
*
2551
+
* <p>To specify the Google groups to add, add memberships with the appropriate
2552
+
* `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where
2553
+
* `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can
2554
+
* use [Cloud Identity Groups lookup
2555
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
2556
+
* `123456789` for group email `group{@literal @}example.com`, then you can add the group to the
2557
+
* space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not
2558
+
* supported, and Google groups can only be added as members in named spaces.
2559
+
*
2549
2560
* <p>For a named space or group chat, if the caller blocks, or is blocked by some members, or
2550
2561
* doesn't have permission to add some members, then those members aren't added to the created
2551
2562
* space.
@@ -2610,6 +2621,15 @@ public final Space setUpSpace(SetUpSpaceRequest request) {
2610
2621
* you can add the user to the space by setting the `membership.member.name` to
2611
2622
* `users/user{@literal @}example.com` or `users/123456789`.
2612
2623
*
2624
+
* <p>To specify the Google groups to add, add memberships with the appropriate
2625
+
* `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where
2626
+
* `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can
2627
+
* use [Cloud Identity Groups lookup
2628
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
2629
+
* `123456789` for group email `group{@literal @}example.com`, then you can add the group to the
2630
+
* space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not
2631
+
* supported, and Google groups can only be added as members in named spaces.
2632
+
*
2613
2633
* <p>For a named space or group chat, if the caller blocks, or is blocked by some members, or
2614
2634
* doesn't have permission to add some members, then those members aren't added to the created
2615
2635
* space.
@@ -3072,7 +3092,8 @@ public final UnaryCallable<FindDirectMessageRequest, Space> findDirectMessageCal
3072
3092
* adds the member directly to the specified space. Requires [user
* <p>To specify the member to add, set the `membership.member.name` for the human or app member.
3095
+
* <p>To specify the member to add, set the `membership.member.name` for the human or app member,
3096
+
* or set the `membership.group_member.name` for the group member.
3076
3097
*
3077
3098
* <p>- To add the calling app to a space or a direct message between two human users, use
3078
3099
* `users/app`. Unable to add other apps to the space.
@@ -3084,6 +3105,14 @@ public final UnaryCallable<FindDirectMessageRequest, Space> findDirectMessageCal
3084
3105
* the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
3085
3106
* `users/123456789`.
3086
3107
*
3108
+
* <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
3109
+
* the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
3110
+
* Identity Groups lookup
3111
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
3112
+
* `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
3113
+
* group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
3114
+
* Group email is not supported, and Google groups can only be added as members in named spaces.
3115
+
*
3087
3116
* <p>Sample code:
3088
3117
*
3089
3118
* <pre>{@code
@@ -3136,7 +3165,8 @@ public final Membership createMembership(SpaceName parent, Membership membership
3136
3165
* adds the member directly to the specified space. Requires [user
* <p>To specify the member to add, set the `membership.member.name` for the human or app member.
3168
+
* <p>To specify the member to add, set the `membership.member.name` for the human or app member,
3169
+
* or set the `membership.group_member.name` for the group member.
3140
3170
*
3141
3171
* <p>- To add the calling app to a space or a direct message between two human users, use
3142
3172
* `users/app`. Unable to add other apps to the space.
@@ -3148,6 +3178,14 @@ public final Membership createMembership(SpaceName parent, Membership membership
3148
3178
* the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
3149
3179
* `users/123456789`.
3150
3180
*
3181
+
* <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
3182
+
* the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
3183
+
* Identity Groups lookup
3184
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
3185
+
* `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
3186
+
* group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
3187
+
* Group email is not supported, and Google groups can only be added as members in named spaces.
3188
+
*
3151
3189
* <p>Sample code:
3152
3190
*
3153
3191
* <pre>{@code
@@ -3197,7 +3235,8 @@ public final Membership createMembership(String parent, Membership membership) {
3197
3235
* adds the member directly to the specified space. Requires [user
* <p>To specify the member to add, set the `membership.member.name` for the human or app member.
3238
+
* <p>To specify the member to add, set the `membership.member.name` for the human or app member,
3239
+
* or set the `membership.group_member.name` for the group member.
3201
3240
*
3202
3241
* <p>- To add the calling app to a space or a direct message between two human users, use
3203
3242
* `users/app`. Unable to add other apps to the space.
@@ -3209,6 +3248,14 @@ public final Membership createMembership(String parent, Membership membership) {
3209
3248
* the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
3210
3249
* `users/123456789`.
3211
3250
*
3251
+
* <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
3252
+
* the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
3253
+
* Identity Groups lookup
3254
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
3255
+
* `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
3256
+
* group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
3257
+
* Group email is not supported, and Google groups can only be added as members in named spaces.
3258
+
*
3212
3259
* <p>Sample code:
3213
3260
*
3214
3261
* <pre>{@code
@@ -3244,7 +3291,8 @@ public final Membership createMembership(CreateMembershipRequest request) {
3244
3291
* adds the member directly to the specified space. Requires [user
* <p>To specify the member to add, set the `membership.member.name` for the human or app member.
3294
+
* <p>To specify the member to add, set the `membership.member.name` for the human or app member,
3295
+
* or set the `membership.group_member.name` for the group member.
3248
3296
*
3249
3297
* <p>- To add the calling app to a space or a direct message between two human users, use
3250
3298
* `users/app`. Unable to add other apps to the space.
@@ -3256,6 +3304,14 @@ public final Membership createMembership(CreateMembershipRequest request) {
3256
3304
* the space by setting the `membership.member.name` to `users/user{@literal @}example.com` or
3257
3305
* `users/123456789`.
3258
3306
*
3307
+
* <p>- To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is
3308
+
* the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud
3309
+
* Identity Groups lookup
3310
+
* API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID
3311
+
* `123456789` for group email `group{@literal @}example.com`, then you can add or invite the
3312
+
* group to a named space by setting the `membership.group_member.name` to `groups/123456789`.
3313
+
* Group email is not supported, and Google groups can only be added as members in named spaces.
0 commit comments