Method: courses.students.get

تعرِض هذه السمة طالبًا في دورة تدريبية.

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

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

طلب HTTP

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

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

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

المعلمات
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

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