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

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