Method: courses.topics.patch

تُعدِّل حقلاً واحدًا أو أكثر في أحد المواضيع.

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

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

طلب HTTP

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

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

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

المَعلمات
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

لمزيد من المعلومات، راجِع دليل التفويض.