Method: courses.teachers.list

فهرستی از معلمان این دوره را که درخواست کننده مجاز به مشاهده آنهاست، برمی گرداند.

این روش کدهای خطای زیر را برمی گرداند:

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
course Id

string

شناسه دوره این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا alias باشد.

پارامترهای پرس و جو

پارامترها
page Size

integer

حداکثر تعداد اقلام برای بازگشت. پیش فرض 30 در صورت نامشخص یا 0 است.

سرور ممکن است کمتر از تعداد مشخص شده نتایج را برگرداند.

page Token

string

مقدار nextPageToken برگردانده شده از فراخوانی list قبلی، نشان می دهد که صفحه بعدی نتایج باید برگردانده شود.

در غیر این صورت، درخواست list باید با درخواستی که منجر به این نشانه شده است، یکسان باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ هنگام لیست کردن معلمان

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "teachers": [
    {
      object (Teacher)
    }
  ],
  "nextPageToken": string
}
فیلدها
teachers[]

object ( Teacher )

معلمانی که با درخواست لیست مطابقت دارند.

next Page Token

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.