Method: courses.create

• درخواست HTTP
• پارامترهای پرس و جو
• درخواست بدنه
• بدنه پاسخ
• دامنه‌های مجوز
• امتحانش کن!

یک دوره آموزشی ایجاد می‌کند.

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

این متد کدهای خطای زیر را برمی‌گرداند:

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
previewVersion	enum ( PreviewVersion ) اختیاری. نسخه پیش‌نمایش API. این گزینه باید تنظیم شود تا بتوان به قابلیت‌های جدید API که در برنامه پیش‌نمایش در اختیار توسعه‌دهندگان قرار گرفته است، دسترسی پیدا کرد.

درخواست بدنه

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

بدنه پاسخ

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

دامنه‌های مجوز

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

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

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