Add-on Google Classroom kini tersedia secara umum untuk developer. Lihat
dokumentasi add-on untuk informasi selengkapnya.
Method: registrations.create
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat Registration, yang menyebabkan Classroom mulai mengirim notifikasi dari feed yang diberikan ke tujuan yang diberikan di cloudPubSubTopic.
Menampilkan Registration yang dibuat. Saat ini, ini akan sama dengan argumen, tetapi dengan kolom yang ditetapkan server seperti expiryTime dan id diisi.
Perhatikan bahwa nilai apa pun yang ditentukan untuk kolom expiryTime atau id akan diabaikan.
Meskipun Classroom dapat memvalidasi cloudPubSubTopic dan menampilkan error berdasarkan upaya terbaik, pemanggil bertanggung jawab untuk memastikan bahwa cloudPubSubTopic ada dan Classroom memiliki izin untuk memublikasikan ke cloudPubSubTopic tersebut.
Metode ini dapat menampilkan kode error berikut:
PERMISSION_DENIED if:
- pengguna yang diautentikasi tidak memiliki izin untuk menerima notifikasi dari kolom yang diminta; atau
- pengguna saat ini belum memberikan akses ke project Cloud saat ini dengan cakupan yang sesuai untuk feed yang diminta. Perhatikan bahwa delegasi otorisasi tingkat domain saat ini tidak didukung untuk tujuan ini. Jika permintaan memiliki cakupan yang sesuai, tetapi tidak ada pemberian, [Request Errors][
@MissingGrant error] akan ditampilkan.
- Error akses lain terjadi.
INVALID_ARGUMENT if:
- tidak ada
cloudPubsubTopic yang ditentukan, atau cloudPubsubTopic yang ditentukan tidak valid; atau
- tidak ada
feed yang ditentukan, atau feed yang ditentukan tidak valid.
NOT_FOUND if:
feed yang ditentukan tidak dapat ditemukan, atau pengguna yang meminta tidak memiliki izin untuk menentukan apakah feed tersebut ada atau tidak; ataucloudPubsubTopic yang ditentukan tidak dapat ditemukan, atau Classroom belum diberi izin untuk memublikasikan ke cloudPubsubTopic tersebut.
Permintaan HTTP
POST https://classroom.googleapis.com/v1/registrations
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat instance Registration.
Isi respons
Jika berhasil, isi respons memuat instance Registration yang baru dibuat.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.push-notifications
Untuk 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."],[],[],null,["# Method: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
