Method: courses.teachers.list

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

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

  • NOT_FOUND في حال عدم توفُّر الدورة التدريبية.
  • PERMISSION_DENIED في ما يتعلق بأخطاء الوصول.

طلب HTTP

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

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

مَعلمات المسار

المَعلمات
courseId

string

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

معلمات طلب البحث

المَعلمات
pageSize

integer

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

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

pageToken

string

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

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

نص الطلب

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

نص الاستجابة

الرد عند إدراج بيانات المعلّمين

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

تمثيل JSON
{
  "teachers": [
    {
      object (Teacher)
    }
  ],
  "nextPageToken": string
}
الحقول
teachers[]

object (Teacher)

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

nextPageToken

string

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

نطاقات التفويض

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

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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