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ını gerektirir.

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

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

Ek oluşturmak için kullanılacak duyuru,courseWork veya ClassroomWorkMaterial'ın kimliği. Bu alan zorunludur ancak postId'den 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 değerini 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çinse isteğe bağlıdır. İş ortağı öncelikli ek oluşturma için sağlanmazsa bir hata döndürür ve eki oluşturan geliştirici projeleri ile üst akış öğesi eşleşmiyor.

İ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şturulan 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ılavuzuna göz atın.