هل يستخدم المستخدمون Classroom مع Google Meet؟ راجِع البدء السريع لبرمجة التطبيقات والذي يتناول كيفية التحقّق من حضور الطلاب في دورات Google Meet.

Method: courses.teachers.create

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

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

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

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

طلب HTTP

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

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

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

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

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