- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Deletes a membership. For an example, see Remove a user or a Google Chat app from a space.
Supports the following types of authentication:
App authentication with administrator approval in Developer Preview and the authorization scope:
https://www.googleapis.com/auth/chat.app.memberships
User authentication with one of the following authorization scopes:
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
(to remove the calling app from the space)https://www.googleapis.com/auth/chat.import
(import mode spaces only)- User authentication grants administrator privileges when an administrator account authenticates,
useAdminAccess
istrue
, 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 authentication the application must be the space creator.
HTTP request
DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
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. When deleting a human membership, requires the When deleting an app membership, requires the Format: |
Query parameters
Parameters | |
---|---|
useAdminAccess |
Optional. When The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege. Requires the Deleting app memberships in a space isn't supported using admin access. |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Membership
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/chat.app.memberships
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
For more information, see the Authorization guide.