Method: courses.update

يعدِّل دورة تدريبية.

ملاحظة: على عكس الحقول الأخرى، لا تتم إزالة قيمة levels إذا تم حذفها من الطلب. لا يعدِّل طريقة courses.update قيمة levels إلا إذا تم توفيرها بشكل صريح، وإلا سيتم الاحتفاظ بالقيمة الحالية. استخدِم طريقة courses.patch لإزالة قيمة الحقل levels.

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

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي يطلب الدورة التدريبية بتعديلها أو في حال حدوث أخطاء في الوصول.
  • NOT_FOUND إذا لم تكن هناك دورة تدريبية بالمعرّف المطلوب
  • FAILED_PRECONDITION لأخطاء الطلب التالية:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

طلب HTTP

PUT https://classroom.googleapis.com/v1/courses/{id}

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

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

المعلمات
id

string

معرّف الدورة التدريبية المطلوب تعديلها يمكن أن يكون هذا المعرّف المعرّف الذي خصّصه Classroom أو alias.

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Course.

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

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

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

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