Method: courses.courseWork.create

إنشاء عمل الدورة التدريبية

ويتم ربط العمل الناتج عن الدورة التدريبية (والأعمال المرسَلة من الطلاب ذات الصلة) بمشروع Developer Console الخاص بمعرّف عميل OAuth المستخدَم لتقديم الطلب. يجب تقديم طلبات Classroom API لتعديل أعمال الدورة التدريبية والمحتوى الذي يرسله الطلاب باستخدام معرّف عميل OAuth من مشروع Developer Console المرتبط.

تُرجع هذه الطريقة رموز الأخطاء التالية:

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي يطلب الوصول إلى الدورة التدريبية المطلوبة، أو إنشاء عمل دورة تدريبية في الدورة التدريبية المطلوبة، أو مشاركة مرفق في Drive، أو بسبب أخطاء في الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صالح
  • NOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.
  • FAILED_PRECONDITION بسبب خطأ الطلب التالي:
    • AttachmentNotVisible

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو alias.

مَعلمات طلب البحث

المعلمات
previewVersion

enum (PreviewVersion)

اختيارية: إصدار المعاينة لنقطة النهاية يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الطلب

يحتوي نص الطلب على مثال CourseWork.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من CourseWork.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.