Method: courses.courseWork.create

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

کار درسی حاصل (و ارسال‌های دانشجوی مربوطه) با پروژه Developer Console از شناسه مشتری OAuth که برای ارسال درخواست استفاده می‌شود، مرتبط است. درخواست‌های Classroom API برای تغییر کار درسی و ارسال‌های دانش‌آموز باید با شناسه مشتری OAuth از پروژه Developer Console مرتبط انجام شود.

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

  • PERMISSION_DENIED اگر کاربر درخواست کننده اجازه دسترسی به دوره درخواستی را نداشته باشد، کار دوره را در دوره درخواستی ایجاد کند، پیوست Drive را به اشتراک بگذارد، یا خطاهای دسترسی داشته باشد .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر دوره درخواستی وجود نداشته باشد، NOT_FOUND .
  • FAILED_PRECONDITION برای خطای درخواست زیر:
    • پیوست غیرقابل مشاهده

درخواست HTTP

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

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

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

مولفه های
courseId

string

شناسه دوره این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا alias باشد.

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

مولفه های
previewVersion

enum ( PreviewVersion )

اختیاری. نسخه پیش نمایش نقطه پایانی. این باید برای دسترسی به قابلیت‌های API جدیدی که در برنامه پیش‌نمایش برای توسعه‌دهندگان در دسترس است، تنظیم شود.

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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