Method: courses.announcements.addOnAttachments.create

ينشئ مرفق إضافة ضمن مشاركة.

تتطلب الإضافة الحصول على إذن لإنشاء مرفقات جديدة في المشاركة.

تُرجع هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED بسبب أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح.
  • NOT_FOUND في حال عدم توفّر أحد الموارد المحدَّدة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية.

itemId

string

معرّف Announcement أو CourseWork أو CourseWorkMaterial المطلوب إنشاء المرفق بموجبه هذا الحقل مطلوب، ولكن لم يتم وضع علامة عليه لتوضيح ذلك أثناء عملية النقل من رقم تعريف المنشور.

معامِلات طلب البحث

المعلمات
postId
(deprecated)

string

اختياريّ. متوقّفة نهائيًا، واستخدِم itemId بدلاً منها.

addOnToken

string

اختياريّ. الرمز المميز الذي يخوّل الطلب.

يتم تمرير الرمز المميّز كمَعلمة طلب بحث عند إعادة توجيه المستخدم من Classroom إلى عنوان URL الخاص بالإضافة.

هذا الرمز المميّز للتفويض مطلوب لإنشاء المرفقات في Classroom ولكنه اختياري لإنشاء المُرفقات التي يضعها الشريك أولاً. عرض رسالة خطأ إذا لم يتم توفيرها لإنشاء المرفق الذي يقدّمه الشريك أولاً، وفي حال كانت مشاريع مطوّر البرامج التي أنشأت هذا المرفق مع عنصر ساحة المشاركات الرئيسي له غير متطابقة.

نص الطلب

يحتوي نص الطلب على مثال AddOnAttachment.

نص الاستجابة

في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل AddOnAttachment تم إنشاؤه حديثًا.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.