Method: subscriptions.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
HTTP-Anfrage
POST https://workspaceevents.googleapis.com/v1/subscriptions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
validateOnly |
boolean
Optional. Wenn true festgelegt ist, wird die Anfrage validiert und in der Vorschau angezeigt, aber das Abo wird nicht erstellt.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Subscription.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.
- Das Feld
metadata enthält ein leeres Array. - Das Feld
response enthält eine neue Instanz von Subscription.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Weitere Informationen finden Sie im Autorisierungsleitfaden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eThis method creates a Google Workspace subscription and provides instructions on how to use it through a provided link.\u003c/p\u003e\n"],["\u003cp\u003eThe request can be previewed without creating a subscription by setting the \u003ccode\u003evalidateOnly\u003c/code\u003e query parameter to \u003ccode\u003etrue\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA successful response includes an \u003ccode\u003eOperation\u003c/code\u003e object containing the newly created \u003ccode\u003eSubscription\u003c/code\u003e details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the listed OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/chat.spaces\u003c/code\u003e or others related to chat, messages, memberships, and meetings, with more information available in the Authorization guide.\u003c/p\u003e\n"]]],["This describes how to create a Google Workspace subscription via a `POST` request to `https://workspaceevents.googleapis.com/v1/subscriptions`. The request includes an instance of `Subscription` in the body. The `validateOnly` query parameter can be used to preview the request. Successful responses contain an `Operation` instance, where `response` field has a new `Subscription`. This process requires one of several listed OAuth scopes for authorization.\n"],null,["# Method: subscriptions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription).\n\n### HTTP request\n\n`POST https://workspaceevents.googleapis.com/v1/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------|\n| `validateOnly` | `boolean` Optional. If set to `true`, validates and previews the request, but doesn't create the subscription. |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/workspace/events/reference/rest/v1/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/workspace/events/reference/rest/v1/operations#Operation).\n\n- The `metadata` field contains an empty array.\n- The `response` field contains a new instance of [Subscription](/workspace/events/reference/rest/v1beta/subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.spaces`\n- `\n https://www.googleapis.com/auth/chat.spaces.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages`\n- `\n https://www.googleapis.com/auth/chat.messages.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions.readonly`\n- `\n https://www.googleapis.com/auth/chat.memberships`\n- `\n https://www.googleapis.com/auth/chat.memberships.readonly`\n- `\n https://www.googleapis.com/auth/meetings.space.created`\n- `\n https://www.googleapis.com/auth/meetings.space.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
