Mendapatkan metadata untuk add-on Classroom dalam konteks postingan tertentu.
Untuk menjaga integritas data dan model izinnya sendiri, add-on harus memanggil ini untuk memvalidasi parameter kueri dan peran pengguna yang meminta setiap kali add-on dibuka di iframe.
Metode ini menampilkan kode error berikut:
PERMISSION_DENIED
untuk error akses.INVALID_ARGUMENT
jika permintaan memiliki format yang salah.NOT_FOUND
jika salah satu resource yang diidentifikasi tidak ada.
Permintaan HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
course |
Wajib. ID kursus. |
item |
ID |
Parameter kueri
Parameter | |
---|---|
add |
Opsional. Token yang memberikan otorisasi pada permintaan. Token diteruskan sebagai parameter kueri saat pengguna dialihkan dari Classroom ke URL add-on. Token otorisasi diperlukan jika salah satu hal berikut tidak terpenuhi:
|
attachment |
Opsional. ID lampiran. Kolom ini diperlukan untuk semua permintaan, kecuali jika pengguna berada di iframe Penemuan Lampiran. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat instance AddOnContext
.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Untuk informasi selengkapnya, lihat Panduan otorisasi.