Method: courses.courseWork.create

تؤدي هذه السياسة إلى إنشاء عمل في الدورة الدراسية.

وتربط أعمال الدورة التدريبية الناتجة (وعمليات تسليم الطلاب المقابلة) بمشروع وحدة تحكم مطوّري البرامج في معرِّف عميل OAuth المستخدَم لإنشاء الطلب. يجب تقديم طلبات Classroom API لتعديل مهام الدورة الدراسية وعمليات إرسال الطلاب باستخدام معرّف عميل OAuth من مشروع وحدة تحكّم المطوّرين المرتبط.

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

  • 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.

نص الطلب

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

نص الاستجابة

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

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

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

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

لمزيد من المعلومات، راجِع دليل التفويض.