Mendapatkan metadata untuk add-on Classroom dalam konteks postingan tertentu.
Untuk mempertahankan 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 akan menampilkan kode error berikut:
PERMISSION_DENIED
untuk error akses.INVALID_ARGUMENT
jika permintaan salah format.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 | |
---|---|
courseId |
Wajib. ID kursus. |
itemId |
ID pengumuman, courseWork, atau courseWorkMaterial yang melampirkan lampiran. Kolom ini wajib ada, tetapi tidak ditandai seperti itu saat kami bermigrasi dari postId. |
Parameter kueri
Parameter | |
---|---|
addOnToken |
Opsional. Token yang mengizinkan permintaan. Token diteruskan sebagai parameter kueri saat pengguna dialihkan dari Classroom ke URL add-on. Token otorisasi diperlukan jika tidak satu pun kondisi berikut terpenuhi:
|
attachmentId |
Opsional. ID lampiran. Kolom ini wajib ada untuk semua permintaan, kecuali jika pengguna berada dalam iframe Lampiran 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.