Belirli bir yayının bağlamında Classroom eklentilerinin meta verilerini alır.
Eklenti, kendi veri ve izin modelinin bütünlüğünü korumak amacıyla bir iframe'de her açıldığında sorgu parametrelerini ve istekte bulunan kullanıcının rolünü doğrulamak için bunu çağırmalıdır.
Bu yöntem aşağıdaki hata kodlarını döndürür:
- Erişim hataları için
PERMISSION_DENIED
. - İstek bozuksa
INVALID_ARGUMENT
. - Belirlenen kaynaklardan biri yoksa
NOT_FOUND
.
HTTP isteği
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
courseId |
Zorunlu. Kursun tanımlayıcısı. |
itemId |
Ekin ekli olduğu duyurunun,courseWork veyacourseWorkMaterial'ın tanımlayıcısı. Bu alan zorunludur ancak postId öğesinden taşıma işlemi devam ederken bu şekilde işaretlenmez. |
Sorgu parametreleri
Parametreler | |
---|---|
addOnToken |
İsteğe bağlı. İsteği yetkilendiren jeton. Kullanıcı, Classroom'dan eklentinin URL'sine yönlendirildiğinde jeton, sorgu parametresi olarak iletilir. Aşağıdakilerin ikisi de doğru olmadığında yetkilendirme jetonu gerekir:
|
attachmentId |
İsteğe bağlı. Ekin tanımlayıcısı. Bu alan, kullanıcının Ek Discovery iframe'inde olduğu durumlar hariç tüm istekler için gereklidir. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, AddOnContext
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.