Method: courses.announcements.patch

تُعدِّل حقلاً واحدًا أو أكثر من الإشعارات.

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

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

طلب HTTP

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

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

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

المَعلمات
courseId

string

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

id

string

هو معرّف الإشعار.

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

المَعلمات
updateMask

string (FieldMask format)

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

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

  • text
  • state
  • scheduledTime

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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