Method: subscriptions.create
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Permintaan HTTP
POST https://workspaceevents.googleapis.com/v1beta/subscriptions
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
validateOnly |
boolean
Opsional. Jika disetel ke true, permintaan akan divalidasi dan dilihat pratinjaunya, tetapi langganan tidak akan dibuat.
|
Isi permintaan
Isi permintaan memuat instance Subscription.
Isi respons
Jika berhasil, isi respons memuat instance Operation yang baru dibuat.
- Kolom
metadata berisi array kosong. - Kolom
response berisi instance Subscription baru.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
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
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eCreates a Google Workspace subscription using an HTTP POST request to a specified URL.\u003c/p\u003e\n"],["\u003cp\u003eAllows validation and preview of the request without creating a subscription using the \u003ccode\u003evalidateOnly\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a Subscription object in the request body and returns an Operation object in the response, containing the new subscription details.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes, such as chat and meeting related scopes, for access control and permissions.\u003c/p\u003e\n"],["\u003cp\u003eIs currently available as part of the Google Workspace Developer Preview Program.\u003c/p\u003e\n"]]],["This document details creating a Google Workspace subscription via a `POST` request to `https://workspaceevents.googleapis.com/v1beta/subscriptions`. The request includes optional `validateOnly` query parameter for previewing. The request body requires a `Subscription` instance, and successful responses return an `Operation` instance, which contains an array and a new `Subscription` instance. Creating subscription needs to use one of the authorization scopes. This feature is in developer preview.\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\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](/workspace/preview), which grants early access to certain features.\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/v1beta/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/v1beta/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/workspace/events/reference/rest/v1beta/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- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
