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

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