إنشاء عمل الدورة التدريبية
ويتم ربط العمل الناتج عن الدورة التدريبية (والأعمال المرسَلة من الطلاب ذات الصلة) بمشروع 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.
مَعلمات المسار
المعلمات | |
---|---|
course |
معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو |
مَعلمات طلب البحث
المعلمات | |
---|---|
preview |
اختيارية: إصدار المعاينة لنقطة النهاية يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة". |
نص الطلب
يحتوي نص الطلب على مثال CourseWork
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من CourseWork
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.coursework.students
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.