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

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