Method: courses.announcements.modifyAssignees

لتعديل وضع المُسنَد إليه وخيارات الإشعار.

لا يجوز لأحد تسمية هذه الطريقة سوى معلّم الدورة التدريبية الذي يحتوي على الإشعار.

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

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

طلب HTTP

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

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

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

المَعلمات
courseId

string

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

string

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
الحقول
assigneeMode

enum (AssigneeMode)

وضع الإشعار الذي يصف ما إذا كان يمكن لجميع الطلاب أو طلاب معيّنين الوصول إليه.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

يمكنك تحديد الطلاب الذين يمكنهم الاطّلاع على الإشعار أو عدم السماح لهم بالاطّلاع عليه. يجب تحديد قيمة السمة assigneeMode فقط عندما تكون القيمة INDIVIDUAL_STUDENTS.

نص الاستجابة

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

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

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

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

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