Method: courses.announcements.addOnAttachments.list

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

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

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية.

itemId

string

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

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

المعلمات
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

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