Method: courses.topics.patch

تعدّل هذا الحقل حقلاً واحدًا أو أكثر للموضوع.

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

  • PERMISSION_DENIED إذا لم يُنشئ مشروع مطوِّر الطلبات مقدِّم الطلب الموضوع المعني أو لأخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح
  • NOT_FOUND في حال عدم توفُّر الدورة التدريبية المطلوبة أو الموضوع المطلوب

طلب HTTP

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

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

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

المعلّمات
courseId

string

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

string

رقم تعريف الموضوع.

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

المعلّمات
updateMask

string (FieldMask format)

قناع يحدّد الحقول المطلوب تعديلها بشأن الموضوع. هذا الحقل مطلوب لإجراء تعديل. يتعذّر التعديل في حال تحديد حقول غير صالحة. إذا كان أحد الحقول يتوافق مع قيم فارغة، يمكن محوه من خلال تحديده في قناع التحديث وليس في كائن "الموضوع". إذا كان الحقل الذي لا يتوافق مع القيم الفارغة مضمّنًا في قناع التعديل ولم يتم ضبطه في عنصر الموضوع، سيتم عرض خطأ INVALID_ARGUMENT.

يمكن تحديد الحقول التالية:

  • name

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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