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)

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

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

  • name

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

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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