Method: courses.courseWorkMaterials.list

تعرض قائمة بمواد عمل الدورة الدراسية التي يُسمح لمقدّم الطلب بعرضها.

يمكن لطلاب الدورة التدريبية عرض PUBLISHED مواد عمل الدورة التدريبية فقط. يمكن لمعلّمي الدورة التدريبية ومشرفي النطاق الاطّلاع على جميع مواد عمل الدورة التدريبية.

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

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

طلب HTTP

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

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

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

المَعلمات
courseId

string

معرّف الدورة التدريبية. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو alias.

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

المَعلمات
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

فرض قيود على حالة العمل المطلوب إرجاعها. يتم فقط عرض مواد عمل الدورة التدريبية المطابقة. في حال عدم تحديد هذه السمة، يتم إرجاع السلع التي تكون حالة عملها هي PUBLISHED.
orderBy

string

ترتيب اختياري للنتائج قائمة حقول مفصولة بفواصل مع كلمة رئيسية اختيارية لتوجيه الترتيب. الحقل المتاح هو updateTime. الكلمات الرئيسية المسموح بها للاتجاهات هما asc وdesc. إذا لم يتم تحديد السياسة، سيكون updateTime desc هو السلوك التلقائي. أمثلة: updateTime asc وupdateTime
pageSize

integer

الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير الخيار "صفر" أو "غير محدّد" إلى أنّ الخادم قد يعيّن حدًّا أقصى.

قد يعرض الخادم عددًا أقل من عدد النتائج المحدّد.
pageToken

string

تم عرض قيمة nextPageToken من استدعاء list سابق، للإشارة إلى أنه يجب عرض صفحة النتائج اللاحقة.

ويجب أن يكون طلب list مطابقًا للطلب الذي أدى إلى إنشاء هذا الرمز المميّز.
materialDriveId

string

فلترة اختيارية لمادة عمل الدورة الدراسية مع مادة واحدة على الأقل على Drive يتطابق رقم تعريفها مع السلسلة المقدَّمة. إذا تم تحديد السمة materialLink أيضًا، يجب أن تحتوي مواد عمل الدورة التدريبية على مواد تتطابق مع كلا الفلترَين.

نص الطلب

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

نص الاستجابة

الرد عند سرد مواد عمل الدورة التدريبية.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
الحقول
courseWorkMaterial[]

object (CourseWorkMaterial)

عناصر مواد عمل الدورة الدراسية التي تتطابق مع الطلب.
nextPageToken

string

رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها إذا كان هذا الحقل فارغًا، لن يتم توفير أي نتائج أخرى.

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

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

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