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 Transcode.

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

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

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