Skip to content

Commit 4608a16

Browse files
1 parent fae4f13 commit 4608a16

2 files changed

Lines changed: 31 additions & 15 deletions

File tree

src/HangoutsChat/Resource/Spaces.php

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,15 @@ public function completeImport($name, CompleteImportSpaceRequest $postBody, $opt
8080
* `https://www.googleapis.com/auth/chat.spaces` -
8181
* `https://www.googleapis.com/auth/chat.import` (import mode spaces only) When
8282
* authenticating as an app, the `space.customer` field must be set in the
83-
* request. Space membership upon creation depends on whether the space is
84-
* created in `Import mode`: * **Import mode:** No members are created. * **All
85-
* other modes:** The calling user is added as a member. This is: * The app
86-
* itself when using app authentication. * The human user when using user
83+
* request. When authenticating as an app, the Chat app is added as a member of
84+
* the space. However, unlike human authentication, the Chat app is not added as
85+
* a space manager. By default, the Chat app can be removed from the space by
86+
* all space members. To allow only space managers to remove the app from a
87+
* space, set `space.permission_settings.manage_apps` to `managers_allowed`.
88+
* Space membership upon creation depends on whether the space is created in
89+
* `Import mode`: * **Import mode:** No members are created. * **All other
90+
* modes:** The calling user is added as a member. This is: * The app itself
91+
* when using app authentication. * The human user when using user
8792
* authentication. If you receive the error message `ALREADY_EXISTS` when
8893
* creating a space, try a different `displayName`. An existing space within the
8994
* Google Workspace organization might already use this display name.
@@ -211,7 +216,11 @@ public function findDirectMessage($optParams = [])
211216
* administrator privileges when an administrator account authenticates,
212217
* `use_admin_access` is `true`, and one of the following authorization scopes
213218
* is used: - `https://www.googleapis.com/auth/chat.admin.spaces.readonly` -
214-
* `https://www.googleapis.com/auth/chat.admin.spaces` (spaces.get)
219+
* `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has
220+
* the following limitations: - `space.access_settings` is only populated when
221+
* using the `chat.app.spaces` scope. - `space.predefind_permission_settings`
222+
* and `space.permission_settings` are only populated when using the
223+
* `chat.app.spaces` scope, and only for spaces the app created. (spaces.get)
215224
*
216225
* @param string $name Required. Resource name of the space, in the form
217226
* `spaces/{space}`. Format: `spaces/{space}`
@@ -302,7 +311,12 @@ public function listSpaces($optParams = [])
302311
* User authentication grants administrator privileges when an administrator
303312
* account authenticates, `use_admin_access` is `true`, and the following
304313
* authorization scopes is used: -
305-
* `https://www.googleapis.com/auth/chat.admin.spaces` (spaces.patch)
314+
* `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has
315+
* the following limitations: - To update either
316+
* `space.predefined_permission_settings` or `space.permission_settings`, the
317+
* app must be the space creator. - Updating the
318+
* `space.access_settings.audience` is not supported for app authentication.
319+
* (spaces.patch)
306320
*
307321
* @param string $name Identifier. Resource name of the space. Format:
308322
* `spaces/{space}` Where `{space}` represents the system-assigned ID for the

src/HangoutsChat/Resource/SpacesMembers.php

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -53,10 +53,12 @@ class SpacesMembers extends \Google\Service\Resource
5353
* mode spaces only) - User authentication grants administrator privileges when
5454
* an administrator account authenticates, `use_admin_access` is `true`, and the
5555
* following authorization scope is used: -
56-
* `https://www.googleapis.com/auth/chat.admin.memberships` For example usage,
57-
* see: - [Invite or add a user to a
58-
* space](https://developers.google.com/workspace/chat/create-members#create-
59-
* user-membership). - [Invite or add a Google Group to a
56+
* `https://www.googleapis.com/auth/chat.admin.memberships` App authentication
57+
* is not supported for the following use cases: - Inviting users external to
58+
* the Workspace organization that owns the space. - Adding a Google Group to a
59+
* space. - Adding a Chat app to a space. For example usage, see: - [Invite or
60+
* add a user to a space](https://developers.google.com/workspace/chat/create-
61+
* members#create-user-membership). - [Invite or add a Google Group to a
6062
* space](https://developers.google.com/workspace/chat/create-members#create-
6163
* group-membership). - [Add the Chat app to a
6264
* space](https://developers.google.com/workspace/chat/create-members#create-
@@ -105,12 +107,12 @@ public function create($parent, Membership $postBody, $optParams = [])
105107
* mode spaces only) - User authentication grants administrator privileges when
106108
* an administrator account authenticates, `use_admin_access` is `true`, and the
107109
* following authorization scope is used: -
108-
* `https://www.googleapis.com/auth/chat.admin.memberships` To delete
109-
* memberships for space managers, the requester must be a space manager. If
110-
* you're using [app
110+
* `https://www.googleapis.com/auth/chat.admin.memberships` App authentication
111+
* is not supported for the following use cases: - Removing a Google Group from
112+
* a space. - Removing a Chat app from a space. To delete memberships for space
113+
* managers, the requester must be a space manager. If you're using [app
111114
* authentication](https://developers.google.com/workspace/chat/authenticate-
112-
* authorize-chat-app) the application must be the space creator.
113-
* (members.delete)
115+
* authorize-chat-app) the Chat app must be the space creator. (members.delete)
114116
*
115117
* @param string $name Required. Resource name of the membership to delete. Chat
116118
* apps can delete human users' or their own memberships. Chat apps can't delete

0 commit comments

Comments
 (0)