שינוי של מצב מקבל ההקצאה והאפשרויות של העבודה לכיתה.
רק מורה בקורס שכולל את העבודה לכיתה יכול לקרוא לשיטה הזו.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED
אם המשתמש ששלח את הבקשה לא מורשה לגשת לקורס או לעבודת הקורס המבוקשים, או במקרה של שגיאות גישה.INVALID_ARGUMENT
אם הבקשה לא תקינה.NOT_FOUND
אם הקורס או העבודה בקורס לא קיימים.
בקשת HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}:modifyAssignees
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
courseId |
מזהה הקורס. המזהה יכול להיות המזהה שהוקצה ל-Classroom או |
id |
המזהה של העבודה בקורס. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "assigneeMode": enum ( |
שדות | |
---|---|
assigneeMode |
מצב העבודה לכיתה שמתארת אם היא תוקצה לכל התלמידים או לתלמידים מסוימים. |
modifyIndividualStudentsOptions |
להגדיר אילו תלמידים יוקצו או לא יוקצו לעבודה לכיתה. חובה לציין רק אם הערך של |
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של CourseWork
.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/classroom.coursework.students
למידע נוסף, ניתן לעיין במדריך ההרשאות.