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.

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

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

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