Method: registrations.create

Membuat Registration, yang menyebabkan Classroom mulai mengirim notifikasi dari feed yang disediakan ke tujuan yang disediakan di cloudPubSubTopic.

Menampilkan Registration yang dibuat. Saat ini, argumen ini akan sama dengan argumen, tetapi dengan kolom yang ditetapkan server seperti expiryTime dan id yang terisi.

Perlu diketahui 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 Classroom tersebut ada dan memiliki izin untuk memublikasikannya.

Metode ini dapat menampilkan kode error berikut:

  • PERMISSION_DENIED jika:
    • pengguna terautentikasi 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. Perlu diperhatikan bahwa pendelegasian otoritas di seluruh domain saat ini tidak didukung untuk tujuan ini. Jika permintaan memiliki cakupan yang sesuai, tetapi tidak ada hibah, [Error Permintaan][@MissingGrant error] akan ditampilkan.
    • Terjadi error akses lagi.
  • INVALID_ARGUMENT jika:
    • 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 jika:
    • feed yang ditentukan tidak dapat ditemukan, atau pengguna yang meminta tidak memiliki izin untuk menentukan apakah keberadaannya ada atau tidak; atau
    • cloudPubsubTopic yang ditentukan tidak dapat ditemukan, atau Classroom belum diberi izin untuk memublikasikannya.

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 ini:

  • https://www.googleapis.com/auth/classroom.push-notifications

Untuk informasi selengkapnya, lihat Panduan otorisasi.