Method: courses.teachers.create

لإنشاء معلّم لدورة تدريبية

يُسمح لمشرفي النطاقات بإضافة المستخدمين في نطاقاتهم كمعلّمين إلى الدورات التدريبية في نطاقاتهم مباشرةً. على المستخدمين غير المشرفين إرسال Invitation بدلاً من ذلك.

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

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم المُقدّم للطلب بإنشاء معلّمين في هذه الدورة التدريبية أو بسبب أخطاء في الوصول
  • NOT_FOUND إذا لم يكن رقم تعريف الدورة التدريبية المطلوب متوفّرًا
  • FAILED_PRECONDITION إذا كان حساب المستخدم المطلوب غير مفعّل، في حال حدوث أخطاء في الطلب التالية:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • CourseTeacherLimitReached
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS إذا كان المستخدم معلّمًا أو طالبًا في الدورة الدراسية

طلب HTTP

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

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

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

المعلمات
courseId

string

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

نص الطلب

يحتوي نص الطلب على مثال Teacher.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من Teacher.

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

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

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

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