ينشئ مرفق إضافة ضمن مشاركة.
تتطلب الإضافة الحصول على إذن لإنشاء مرفقات جديدة في المشاركة.
تُرجع هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
بسبب أخطاء الوصول.INVALID_ARGUMENT
إذا كان الطلب غير صحيح.NOT_FOUND
في حال عدم توفّر أحد الموارد المحدَّدة.
طلب HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
courseId |
مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية. |
postId |
اختياريّ. متوقّفة نهائيًا، واستخدِم |
معامِلات طلب البحث
المعلمات | |
---|---|
itemId |
معرّف |
addOnToken |
اختياريّ. الرمز المميز الذي يخوّل الطلب. يتم تمرير الرمز المميّز كمَعلمة طلب بحث عند إعادة توجيه المستخدم من Classroom إلى عنوان URL الخاص بالإضافة. هذا الرمز المميّز للتفويض مطلوب لإنشاء المرفقات في Classroom ولكنه اختياري لإنشاء المُرفقات التي يضعها الشريك أولاً. عرض رسالة خطأ إذا لم يتم توفيرها لإنشاء المرفق الذي يقدّمه الشريك أولاً، وفي حال كانت مشاريع مطوّر البرامج التي أنشأت هذا المرفق مع عنصر ساحة المشاركات الرئيسي له غير متطابقة. |
نص الطلب
يحتوي نص الطلب على مثال AddOnAttachment
.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل AddOnAttachment
تم إنشاؤه حديثًا.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.addons.teacher
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.