Method: courses.courseWork.create

تنشئ أعمال الدورة التدريبية.

يرتبط عمل الدورة التدريبية الناتج (وعمليات إرسال الطلاب المقابلة) بمشروع وحدة تحكم مطوّري البرامج لمعرِّف عميل OAuth المستخدَم في تقديم الطلب. يجب إرسال طلبات Classroom API لتعديل أعمال الدورة التدريبية وعمليات الإرسال التي يجريها الطلاب باستخدام معرّف عميل OAuth من مشروع Play 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

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