Method: courses.courseWork.modifyAssignees

Ändert den Zuweisungsmodus und die Optionen eines Kurses.

Nur die Lehrkraft des Kurses, der die Kursarbeit enthält, darf diese Methode aufrufen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf den angeforderten Kurs oder die angeforderten Kursmaterialien zugreifen darf, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursarbeit 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

Kennung des Kurses. Diese Kennung kann entweder die in 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)

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

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Legen Sie fest, welchen Schülern oder Studenten die Kursarbeit zugewiesen ist 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 Leitfaden zur Autorisierung.