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