Method: courses.announcements.modifyAssignees

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

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

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

  • ‫PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה לגשת לקורס או לעבודה בקורס המבוקשים, או לשגיאות גישה.
  • ‫INVALID_ARGUMENT אם הבקשה לא תקינה.
  • ‫NOT_FOUND אם הקורס או העבודה בקורס המבוקשים לא קיימים.
  • FAILED_PRECONDITION בנוגע לשגיאה בבקשה הבאה:
    • EmptyAssignees

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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

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