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

מידע נוסף זמין במדריך להרשאות.