Method: courses.create

دوره ایجاد می کند.

کاربری مشخص شده در ownerId مالک دوره ایجاد شده است و به عنوان معلم اضافه شده است. یک کاربر غیر مدیر درخواست کننده فقط می تواند یک دوره با خود به عنوان مالک ایجاد کند. ادمین های دامنه می توانند دوره های آموزشی متعلق به هر کاربری را در دامنه خود ایجاد کنند.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED اگر کاربر درخواست کننده مجاز به ایجاد دوره ها یا خطاهای دسترسی نباشد.
  • اگر معلم اصلی کاربر معتبری نباشد، NOT_FOUND .
  • FAILED_PRECONDITION اگر حساب مالک دوره غیرفعال باشد یا برای خطاهای درخواستی زیر:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • اگر نام مستعار در id مشخص شده باشد و از قبل وجود داشته باشد، ALREADY_EXISTS .

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست شامل نمونه ای از Course است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Course است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.courses

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