Method: registrations.create

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; atau
    • cloudPubsubTopic 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.