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.

نص الطلب

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

نص الاستجابة

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

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

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

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

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