Method: courses.posts.addOnAttachments.create

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

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

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

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

طلب HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments

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

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

المعلمات
courseId

string

مطلوب. معرّف الدورة التدريبية.
postId
(deprecated)

string

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

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

المعلمات
itemId

string

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

string

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

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

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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