Method: courses.courseWork.modifyAssignees

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

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

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

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

בקשת HTTP

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

גוף התשובה

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

היקפי הרשאה

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

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

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