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

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