Method: courses.students.get

لعرض طالب في دورة تدريبية.

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

  • PERMISSION_DENIED إذا لم يُسمَح للمستخدم الذي قدّم الطلب بالاطّلاع على طلاب هذه الدورة التدريبية أو بسبب أخطاء الوصول.
  • NOT_FOUND إذا لم يكن لدى أي طالب في هذه الدورة التدريبية رقم التعريف المطلوب أو إذا لم تكن هذه الدورة التدريبية متوفّرة.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
courseId

string

رقم تعريف الدورة التدريبية ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو alias.

userId

string

معرّف الطالب المطلوب إرجاعه. يمكن أن يكون المعرِّف واحدًا مما يلي:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • السلسلة الحرفية "me"، مع الإشارة إلى المستخدم الذي قدّم الطلب

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Student.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات 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

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