Method: courses.courseWorkMaterials.getAddOnContext

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}/courseWorkMaterials/{itemId}/addOnContext

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
courseId

string

Zorunlu. Kursun tanımlayıcısı.
itemId

string

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.

Sorgu parametreleri

Parametreler
addOnToken

string

İ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:

  • Eklentinin yayında ekleri var.
  • İsteği veren geliştirici projesi, yayını oluşturan projedir.

İ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.