دوره ایجاد می کند.
کاربری مشخص شده در ownerId مالک دوره ایجاد شده است و به عنوان معلم اضافه شده است. یک کاربر غیر مدیر درخواست کننده فقط می تواند یک دوره با خود به عنوان مالک ایجاد کند. ادمین های دامنه می توانند دوره های آموزشی متعلق به هر کاربری را در دامنه خود ایجاد کنند.
این روش کدهای خطای زیر را برمی گرداند:
-
PERMISSION_DENIEDاگر کاربر درخواست کننده مجاز به ایجاد دوره ها یا خطاهای دسترسی نباشد. - اگر معلم اصلی کاربر معتبری نباشد،
NOT_FOUND. -
FAILED_PRECONDITIONاگر حساب مالک دوره غیرفعال باشد یا برای خطاهای درخواستی زیر:- UserCannotOwnCourse
- UserGroupsMembershipLimitReached
- CourseTitleCannotContainUrl
- اگر نام مستعار در
idمشخص شده باشد و از قبل وجود داشته باشد،ALREADY_EXISTS.
درخواست HTTP
POST https://classroom.googleapis.com/v1/courses
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست شامل نمونه ای از Course است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Course است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.courses
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.