Method: courses.announcements.modifyAssignees

שינוי המצב והאפשרויות של הקצאת ההודעה.

רק מורים בקורס שמכיל את ההודעה יכולים להפעיל את השיטה הזו.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה לגשת לקורס או למטלה המבוקשים, או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס או מטלת הקורס המבוקשים לא קיימים.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

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