Method: courses.courseWork.modifyAssignees

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

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

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

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

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{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.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של CourseWork.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/classroom.coursework.students

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