Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.
Bir eklenti, kendi verilerinin ve izin modelinin bütünlüğünü korumak için sorgu parametrelerini ve eklenti bir iframe'de açıldığında 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 hatalıysa
INVALID_ARGUMENT
. - Belirlenen kaynaklardan biri yoksa
NOT_FOUND
.
HTTP isteği
GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
courseId |
Zorunlu. Kursun tanımlayıcısı. |
postId |
İsteğe bağlı. Kullanımdan kaldırıldı, bunun yerine itemId değerini kullanın. |
Sorgu parametreleri
Parametreler | |
---|---|
itemId |
Ekin eklendiği duyuru,courseWork veyacourseWorkMaterial'ın kimliği. Bu alan zorunludur ancak postId'den taşıma işlemi devam ederken bu şekilde işaretlenmez. |
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ğıdakilerden hiçbiri doğru olmadığında yetkilendirme jetonu 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ılavuzuna göz atın.