تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
إرسال ملاحظات
Method: courses.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض قائمة بالدورات التدريبية المسموح للمستخدم الذي قدّم الطلب بعرضها، مقتصرة على الدورات التي تتطابق مع الطلب. يتم ترتيب الدورات التدريبية التي تم إرجاعها حسب وقت الإنشاء، وتكون الدورات التدريبية التي تم إنشاؤها مؤخرًا أولاً.
تُرجع هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
بسبب أخطاء الوصول .
INVALID_ARGUMENT
إذا كانت وسيطة طلب البحث مكتوبة بشكلٍ غير صحيح.
NOT_FOUND
في حال عدم توفّر أي مستخدمين محدّدين في وسيطات طلب البحث.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses
يستخدِم عنوان URL بنية تحويل ترميز gRPC .
معامِلات طلب البحث
المعلمات
studentId
string
يؤدي هذا الخيار إلى حصر الدورات التدريبية التي يتم إرجاعها على الطلاب الذين لديهم طالب يحمل المعرّف المحدّد. يمكن أن يكون المعرّف واحدًا مما يلي:
المعرّف الرقمي للمستخدم
عنوان البريد الإلكتروني للمستخدم
السلسلة الحرفية "me"
، للإشارة إلى المستخدم صاحب الطلب
teacherId
string
يؤدي هذا الخيار إلى حصر الدورات التدريبية التي تم إرجاعها على تلك التي لها معلّم لديه المعرّف المحدّد. يمكن أن يكون المعرّف واحدًا مما يلي:
المعرّف الرقمي للمستخدم
عنوان البريد الإلكتروني للمستخدم
السلسلة الحرفية "me"
، للإشارة إلى المستخدم صاحب الطلب
courseStates[]
enum (CourseState
)
لتقييد الدورات التدريبية التي تم إرجاعها إلى تلك الموجودة في إحدى الحالات المحددة. القيمة التلقائية هي ACTIVE, ARCHIVED, PROVISIONED, decLINED.
pageSize
integer
الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير "صفر" أو "غير محدَّد" إلى أنّ الخادم قد يعيّن حدًا أقصى.
قد يعرض الخادم عددًا أقل من العدد المحدّد من النتائج.
pageToken
string
قيمة nextPageToken
التي تم عرضها من طلب list
سابق، للإشارة إلى أنه يجب عرض صفحة النتائج اللاحقة.
يجب أن يكون طلب list
مطابقًا للطلب الذي نتج عنه هذا الرمز المميّز.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة عند إدراج الدورات التدريبية.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON
{
"courses" : [
{
object (Course
)
}
] ,
"nextPageToken" : string
}
الحقول
courses[]
object (Course
)
الدورات التدريبية التي تتطابق مع طلب القائمة
nextPageToken
string
رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها. إذا كان هذا الحقل فارغًا، لن تتوفّر أي نتائج أخرى.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-04 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-04 (حسب التوقيت العالمي المتفَّق عليه)"]]