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

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

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

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

string

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

addOnToken

string

اختيارية: رمز مميّز يمنح الإذن بالطلب.

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

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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