Method: courses.courseWork.patch

Aktualisiert ein oder mehrere Felder einer Kursarbeit.

Unter google.classroom.v1.CourseWork finden Sie Details dazu, welche Felder aktualisiert werden können und wer sie ändern darf.

Diese Anfrage muss vom Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zum Erstellen des entsprechenden Kursarbeitselements verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn das anfragende Entwicklerprojekt die entsprechende Kursarbeit nicht erstellt hat, wenn der Nutzer nicht berechtigt ist, die angeforderte Änderung an der Abgabe des Schülers vorzunehmen, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn die angeforderte Kursarbeit bereits gelöscht wurde.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursarbeit nicht vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

string

ID der Kursarbeit.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder der Kursarbeit aktualisiert werden sollen. Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden. Wenn ein Feld leere Werte unterstützt, kann es gelöscht werden, indem es in der Aktualisierungsmaske und nicht im CourseWork-Objekt angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten ist und nicht im CourseWork-Objekt festgelegt ist, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.

Die folgenden Felder können von Lehrern angegeben werden:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese Version muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext enthält eine Instanz von CourseWork.

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.