Method: courses.courseWorkMaterials.create

تنشئ هذه الطريقة مادة عمل للدورة التدريبية.

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

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

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

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

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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