Method: courses.courseWork.modifyAssignees

Ändert den Modus für die Zuweisung und die Optionen einer Kursaufgabe.

Nur ein Kursleiter des Kurses, der die Kursaufgaben enthält, darf diese Methode aufrufen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf die angeforderte Kurs- oder Kursaufgabe zuzugreifen, oder wenn Zugriffsfehler vorliegen.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursaufgabe nicht vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene Kennung oder eine alias sein.
id

string

Die ID der Kursaufgaben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
Felder
assigneeMode

enum (AssigneeMode)

Modus der Kursaufgabe, der beschreibt, ob die Aufgabe allen oder nur bestimmten Schülern/Studenten zugewiesen wird.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Sie können festlegen, welche Schüler/Studenten den Kursaufgaben zugewiesen werden und welche nicht. Muss nur angegeben werden, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von CourseWork.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.