تعرض قائمة بمواد عمل الدورة الدراسية التي يُسمح لمقدّم الطلب بعرضها.
يمكن لطلاب الدورة التدريبية عرض 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
لمزيد من المعلومات، راجِع دليل التفويض.