Method: courses.announcements.modifyAssignees

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

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

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

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