Method: courses.announcements.getAddOnContext

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}/announcements/{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 ekli olduğu Announcement, CourseWork veya CourseWorkMaterial öğesinin tanımlayıcısı. Bu alan zorunludur ancak postId öğesinden 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ğıdakilerin hiçbiri doğru olmadığında yetkilendirme jetonu gerekir:

  • Eklentinin yayında ekleri vardır.
  • İsteği gönderen geliştirici projesi, yayını oluşturan projeyle aynıdır.
attachmentId

string

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