تعرض قائمة بمواد مهام الدورة التدريبية المسموح لمقدّم الطلب الاطّلاع عليها.
يمكن لطلاب الدورة التدريبية الاطّلاع على مواد العمل الخاصة بالدورة التدريبية "PUBLISHED
" فقط. يستطيع معلمو الدورة التدريبية ومشرفو النطاقات عرض جميع مواد عمل الدورة التدريبية.
تُرجع هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يتم السماح للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية المطلوبة أو بسبب أخطاء الوصول.INVALID_ARGUMENT
إذا كان الطلب غير صحيح.NOT_FOUND
إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
courseId |
تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي حدّده Classroom أو المعرّف |
معامِلات طلب البحث
المعلمات | |
---|---|
courseWorkMaterialStates[] |
تقييد على حالة العمل لإرجاعه. لا يتم إرجاع سوى مواد عمل الدورة التدريبية المطابقة. في حال عدم تحديد قيمة هذه السمة، يتم إرجاع العناصر التي تحمل حالة العمل " |
orderBy |
ترتيب اختياري للنتائج قائمة حقول مفصولة بفواصل مع كلمة رئيسية اختيارية لاتجاه الترتيب. الحقل المتوافق هو |
pageSize |
الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير "صفر" أو "غير محدَّد" إلى أنّ الخادم قد يعيّن حدًا أقصى. قد يعرض الخادم عددًا أقل من العدد المحدّد من النتائج. |
pageToken |
قيمة يجب أن يكون طلب |
materialLink |
فلترة اختيارية لمواد الدورات التدريبية التي تتضمّن مادة رابط واحدة على الأقل يتطابق عنوان URL الخاص بها جزئيًا مع السلسلة المقدَّمة |
materialDriveId |
فلترة اختيارية لمادة عمل الدورة التدريبية التي تتضمّن مادة Drive واحدة على الأقل يتطابق رقم تعريفها مع السلسلة المقدَّمة إذا تم أيضًا تحديد |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تمثّل هذه السمة الإجابة عند سرد مواد عمل الدورة التدريبية.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"courseWorkMaterial": [
{
object ( |
الحقول | |
---|---|
courseWorkMaterial[] |
عناصر مواد عمل الدورة التدريبية التي تتطابق مع الطلب. |
nextPageToken |
رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها. إذا كان هذا الحقل فارغًا، لن تتوفّر أي نتائج أخرى. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.courseworkmaterials
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.