Method: courses.courseWork.addOnAttachments.create

Bir yayının altında eklenti eki oluşturur.

Eklentinin yayında yeni ekler oluşturma iznine sahip olması gerekir.

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

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments

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 oluşturulacağı 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
postId
(deprecated)

string

İsteğe bağlı. Kullanımdan kaldırıldı, bunun yerine itemId politikasını kullanın.
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.

Bu yetkilendirme jetonu Classroom'da ek oluşturmak için gereklidir, iş ortağı öncelikli ek oluşturmak için isteğe bağlıdır. İş ortağı öncelikli ek oluşturma için sağlanmamışsa ve eki oluşturan geliştirici projeleri ile üst akış öğesi eşleşmiyorsa bir hata döndürür.

İstek içeriği

İstek metni, AddOnAttachment öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulmuş bir AddOnAttachment örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/classroom.addons.teacher

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.