Method: courses.announcements.modifyAssignees

تعديل وضع المستخدم المعيّن وخيارات إشعار

يمكن فقط لمعلّم الدورة التدريبية التي تتضمّن الإشعار استدعاء هذه الطريقة.

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

  • ‫PERMISSION_DENIED إذا لم يكن لدى المستخدم الذي يقدّم الطلب إذن بالوصول إلى الدورة التدريبية أو العمل المطلوب أو في حال حدوث أخطاء في الوصول
  • INVALID_ARGUMENT إذا كان الطلب غير صالح
  • ‫NOT_FOUND إذا لم تكن الدورة التدريبية أو المهمة الدراسية المطلوبة متاحة
  • FAILED_PRECONDITION للتعرّف على خطأ الطلب التالي:
    • EmptyAssignees

طلب 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

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