Method: courses.courseWork.modifyAssignees

Ändert den Zuweisungsmodus und die Optionen eines Kurses.

Nur eine Lehrkraft 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 den angeforderten Kurs oder die Kursarbeit zuzugreifen, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursarbeit nicht vorhanden ist.
  • FAILED_PRECONDITION für den folgenden Anfragefehler:
    • EmptyAssignees

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

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

string

Kennung des Kurses.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

enum (AssigneeMode)

Modus der Kursarbeit, der beschreibt, ob sie allen Schülern/Studenten oder bestimmten einzelnen Schülern/Studenten zugewiesen wird.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Legen Sie fest, welche Schüler oder Studenten dem Kurs zugewiesen sind oder nicht. Muss nur angegeben werden, wenn assigneeMode INDIVIDUAL_STUDENTS ist.

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 Autorisierungsleitfaden.