Creates a Google Workspace subscription. To learn how to use this method, see Create a Google Workspace subscription.
For a subscription on a Chat target resource, you can create a subscription as:
A Chat app by specifying an authorization scope that begins with
chat.appand getting one-time administrator approval (Developer Preview). To learn more, see Authorize as a Chat app with administrator approval.A user by specifying an authorization scope that doesn't include
appin its name. To learn more, see Authorize as a Chat user.
HTTP request
POST https://workspaceevents.googleapis.com/v1beta/subscriptions
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters | |
|---|---|
validateOnly |
Optional. If set to |
Request body
The request body contains an instance of Subscription.
Response body
If successful, the response body contains a newly created instance of Operation.
- The
metadatafield contains an empty array. - The
responsefield contains a new instance ofSubscription.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.messageshttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.messages.reactionshttps://www.googleapis.com/auth/chat.messages.reactions.readonlyhttps://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.app.membershipshttps://www.googleapis.com/auth/chat.app.messages.readonlyhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonlyhttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.readonly
For more information, see the Authorization guide.