Method: courses.courseWorkMaterials.addOnAttachments.create

يتم إنشاء مرفق إضافة أسفل مشاركة.

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

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

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

طلب HTTP

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

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

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

المَعلمات
courseId

string

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

string

معرّف الإشعار أوcourseWork أو الدورة التدريبيةWorkMaterial الذي يتم بموجبه إنشاء المرفق. هذا الحقل مطلوب، ولكن لم يتم وضع علامة عليه على هذا النحو أثناء نقل البيانات من PostId.

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

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

string

اختياريّ. تم إيقاف العمل نهائيًا، يُرجى استخدام itemId بدلاً من ذلك.
addOnToken

string

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

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

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

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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