Method: courses.students.list

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

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

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

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

المَعلمات

المَعلمات
`courseId`	`string` تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي ضبطه في Classroom أو `alias`.

courseId

string

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

المَعلمات

المَعلمات
`pageSize`	`integer` الحدّ الأقصى لعدد السلع المطلوب إرجاعها وتكون القيمة التلقائية 30 إذا لم يتم تحديدها أو إذا كانت `0`. قد يعرض الخادم نتائج أقل من العدد المحدّد من النتائج.
`pageToken`	`string` تم عرض قيمة `nextPageToken` من استدعاء `list` سابق، ما يعني أنّه يجب عرض صفحة النتائج اللاحقة. ويجب أن يكون طلب `list` مطابقًا للطلب الذي نتج عنه هذا الرمز المميّز.

pageSize

integer

الحدّ الأقصى لعدد السلع المطلوب إرجاعها وتكون القيمة التلقائية 30 إذا لم يتم تحديدها أو إذا كانت 0.

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

pageToken

string

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

ويجب أن يكون طلب list مطابقًا للطلب الذي نتج عنه هذا الرمز المميّز.

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

الرد عند إدراج الطلاب في قائمة الطلاب

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

تمثيل JSON
{ "students": [ { object (`Student`) } ], "nextPageToken": string }

الحقول

الحقول
`students[]`	`object (Student)` الطلاب الذين يتطابقون مع طلب القائمة.
`nextPageToken`	`string` رمز مميز يحدّد الصفحة التالية من النتائج المطلوب عرضها إذا كان هذا الحقل فارغًا، لن تتوفّر أي نتائج أخرى.

students[]

object (Student)

الطلاب الذين يتطابقون مع طلب القائمة.

nextPageToken

string

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

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

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