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

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