تعدّل حقلاً واحدًا أو أكثر في الدورة التدريبية.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يُسمح للمستخدم الذي قدّم الطلب بتعديل الدورة التدريبية المطلوبة أو بشأن أخطاء الوصولNOT_FOUND
في حال عدم توفُّر دورة تدريبية برقم التعريف المطلوب.INVALID_ARGUMENT
إذا تم تحديد حقول غير صالحة في قناع التعديل أو لم يتم تقديم قناع تحديث.FAILED_PRECONDITION
مقابل أخطاء الطلب التالية:- دورة تدريبية غير مُتاحة
- مالك الدورة التدريبية غير النشطة
- مالك غير مؤهّل
طلب HTTP
PATCH https://classroom.googleapis.com/v1/courses/{id}
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المعلّمات | |
---|---|
id |
رقم تعريف الدورة التدريبية المطلوب تعديلها ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو |
معامِلات طلب البحث
المعلّمات | |
---|---|
updateMask |
قناع يحدد الحقول التي سيتم تعديلها في الدورة التدريبية. هذا الحقل مطلوب لإجراء تعديل. سيتعذّر إجراء التحديث إذا تم تحديد حقول غير صالحة. الحقول التالية صالحة:
ملاحظة: يتم التعامل مع رموز التصحيح على userId على أنّها فعّالة على الفور، ولكن من الناحية العملية، قد يستغرق نقل ملكية جميع الموارد المتأثرة بعض الوقت. عند تعيينه في معلمة طلب بحث، يجب تحديده
تتكوّن هذه القائمة من أسماء حقول مؤهّلة بالكامل مفصولة بفواصل. مثال: |
نص الطلب
يحتوي نص الطلب على مثال Course
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Course
.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.courses
لمزيد من المعلومات، اطّلِع على دليل التفويض.