Method: courses.patch

تعدّل حقلاً واحدًا أو أكثر في الدورة التدريبية.

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
id

string

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

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

المعلّمات
updateMask

string (FieldMask format)

قناع يحدد الحقول التي سيتم تعديلها في الدورة التدريبية. هذا الحقل مطلوب لإجراء تعديل. سيتعذّر إجراء التحديث إذا تم تحديد حقول غير صالحة. الحقول التالية صالحة:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

ملاحظة: يتم التعامل مع رموز التصحيح على userId على أنّها فعّالة على الفور، ولكن من الناحية العملية، قد يستغرق نقل ملكية جميع الموارد المتأثرة بعض الوقت.

عند تعيينه في معلمة طلب بحث، يجب تحديده

updateMask=<field1>,<field2>,...

تتكوّن هذه القائمة من أسماء حقول مؤهّلة بالكامل مفصولة بفواصل. مثال: "user.displayName,photo"

نص الطلب

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

نص الاستجابة

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

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

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

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

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