Method: courses.courseWorkMaterials.addOnAttachments.list

عرض جميع المرفقات التي تم إنشاؤها بواسطة إحدى الإضافات أسفل المشاركة.

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

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

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

طلب HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments

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

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

المَعلمات
courseId

string

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

string

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

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

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

string

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

integer

الحد الأقصى لعدد المرفقات المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. وفي حال عدم تحديد هذا الحقل، سيتم عرض 20 مرفقًا كحدّ أقصى. الحد الأقصى للقيمة هو 20، وسيتم فرض القيم التي تزيد عن 20 لتصبح 20.
pageToken

string

رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ addOnAttachments.list. قم بإدخاله لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى addOnAttachments.list مع الطلب الذي قدَّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ListAddOnAttachmentsResponse.

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

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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