Method: courses.announcements.addOnAttachments.create

Bir gönderinin altına eklenti eki oluşturur.

Eklentinin, gönderide yeni ek oluşturma iznine sahip olması gerekir.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • PERMISSION_DENIED için erişim hataları.
  • INVALID_ARGUMENT ise istek hatalı biçimlendirilmiştir.
  • Tanımlanan kaynaklardan biri mevcut değilse NOT_FOUND.

HTTP isteği

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

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

Yol parametreleri

Parametreler
courseId

string

Zorunlu. Dersin tanımlayıcısıdır.
itemId

string

Eki oluşturmak için kullanılacak Announcement, CourseWork veya CourseWorkMaterial öğesinin tanımlayıcısıdır. Bu alan zorunludur ancak postId'den taşınırken bu şekilde işaretlenmemiştir.

Sorgu parametreleri

Parametreler
postId
(deprecated)

string

İsteğe bağlı. Desteği sonlandırıldı. Bunun yerine itemId kullanın.
addOnToken

string

İsteğe bağlı. İsteği yetkilendiren jeton.

Kullanıcı Classroom'dan eklentinin URL'sine yönlendirildiğinde jeton bir sorgu parametresi olarak iletilir.

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

İstek içeriği

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

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş bir AddOnAttachment örneği 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 bakın.