diff --git a/src/HangoutsChat/Resource/Spaces.php b/src/HangoutsChat/Resource/Spaces.php index 924db4bf238..450d66f55c5 100644 --- a/src/HangoutsChat/Resource/Spaces.php +++ b/src/HangoutsChat/Resource/Spaces.php @@ -80,10 +80,15 @@ public function completeImport($name, CompleteImportSpaceRequest $postBody, $opt * `https://www.googleapis.com/auth/chat.spaces` - * `https://www.googleapis.com/auth/chat.import` (import mode spaces only) When * authenticating as an app, the `space.customer` field must be set in the - * request. Space membership upon creation depends on whether the space is - * created in `Import mode`: * **Import mode:** No members are created. * **All - * other modes:** The calling user is added as a member. This is: * The app - * itself when using app authentication. * The human user when using user + * request. When authenticating as an app, the Chat app is added as a member of + * the space. However, unlike human authentication, the Chat app is not added as + * a space manager. By default, the Chat app can be removed from the space by + * all space members. To allow only space managers to remove the app from a + * space, set `space.permission_settings.manage_apps` to `managers_allowed`. + * Space membership upon creation depends on whether the space is created in + * `Import mode`: * **Import mode:** No members are created. * **All other + * modes:** The calling user is added as a member. This is: * The app itself + * when using app authentication. * The human user when using user * authentication. 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. @@ -211,7 +216,11 @@ public function findDirectMessage($optParams = []) * administrator privileges when an administrator account authenticates, * `use_admin_access` is `true`, and one of the following authorization scopes * is used: - `https://www.googleapis.com/auth/chat.admin.spaces.readonly` - - * `https://www.googleapis.com/auth/chat.admin.spaces` (spaces.get) + * `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has + * the following limitations: - `space.access_settings` is only populated when + * using the `chat.app.spaces` scope. - `space.predefind_permission_settings` + * and `space.permission_settings` are only populated when using the + * `chat.app.spaces` scope, and only for spaces the app created. (spaces.get) * * @param string $name Required. Resource name of the space, in the form * `spaces/{space}`. Format: `spaces/{space}` @@ -302,7 +311,12 @@ public function listSpaces($optParams = []) * User authentication grants administrator privileges when an administrator * account authenticates, `use_admin_access` is `true`, and the following * authorization scopes is used: - - * `https://www.googleapis.com/auth/chat.admin.spaces` (spaces.patch) + * `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has + * the following limitations: - To update either + * `space.predefined_permission_settings` or `space.permission_settings`, the + * app must be the space creator. - Updating the + * `space.access_settings.audience` is not supported for app authentication. + * (spaces.patch) * * @param string $name Identifier. Resource name of the space. Format: * `spaces/{space}` Where `{space}` represents the system-assigned ID for the diff --git a/src/HangoutsChat/Resource/SpacesMembers.php b/src/HangoutsChat/Resource/SpacesMembers.php index 4b1b09acff4..1ffd2012fbe 100644 --- a/src/HangoutsChat/Resource/SpacesMembers.php +++ b/src/HangoutsChat/Resource/SpacesMembers.php @@ -53,10 +53,12 @@ class SpacesMembers extends \Google\Service\Resource * mode spaces only) - User authentication grants administrator privileges when * an administrator account authenticates, `use_admin_access` is `true`, and the * following authorization scope is used: - - * `https://www.googleapis.com/auth/chat.admin.memberships` For example usage, - * see: - [Invite or add a user to a - * space](https://developers.google.com/workspace/chat/create-members#create- - * user-membership). - [Invite or add a Google Group to a + * `https://www.googleapis.com/auth/chat.admin.memberships` App authentication + * is not supported for the following use cases: - Inviting users external to + * the Workspace organization that owns the space. - Adding a Google Group to a + * space. - Adding a Chat app to a space. For example usage, see: - [Invite or + * add a user to a space](https://developers.google.com/workspace/chat/create- + * members#create-user-membership). - [Invite or add a Google Group to a * space](https://developers.google.com/workspace/chat/create-members#create- * group-membership). - [Add the Chat app to a * space](https://developers.google.com/workspace/chat/create-members#create- @@ -105,12 +107,12 @@ public function create($parent, Membership $postBody, $optParams = []) * mode spaces only) - User authentication grants administrator privileges when * an administrator account authenticates, `use_admin_access` is `true`, and the * following authorization scope is used: - - * `https://www.googleapis.com/auth/chat.admin.memberships` To delete - * memberships for space managers, the requester must be a space manager. If - * you're using [app + * `https://www.googleapis.com/auth/chat.admin.memberships` App authentication + * is not supported for the following use cases: - Removing a Google Group from + * a space. - Removing a Chat app from a space. To delete memberships for space + * managers, the requester must be a space manager. If you're using [app * authentication](https://developers.google.com/workspace/chat/authenticate- - * authorize-chat-app) the application must be the space creator. - * (members.delete) + * authorize-chat-app) the Chat app must be the space creator. (members.delete) * * @param string $name Required. Resource name of the membership to delete. Chat * apps can delete human users' or their own memberships. Chat apps can't delete