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 Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.