Method: courses.courseWork.create

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

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
courseId

string

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

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

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

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