Method: courses.courseWork.addOnAttachments.create

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

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

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

  • PERMISSION_DENIED بحثًا عن أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.
  • NOT_FOUND إذا لم يكن أحد الموارد التي تم تحديدها موجودًا.

طلب HTTP

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

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

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

المَعلمات
courseId

string

مطلوبة. معرّف الدورة التدريبية.

itemId

string

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

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

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

string

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

addOnToken

string

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

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

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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