Method: courses.courseWorkMaterials.patch

Aktualisiert ein oder mehrere Felder eines Kursarbeitsmaterials.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn das anfragende Entwicklerprojekt Zugriffsfehler aufweist.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn die angeforderten Kursmaterialien bereits gelöscht wurden.
  • NOT_FOUND, wenn das angeforderte Kurs- oder Kursarbeitsmaterial nicht vorhanden ist

HTTP-Anfrage

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

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

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, mit der angegeben wird, welche Felder im Kursmaterial 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 Kursmaterialobjekt angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten ist und nicht im Kursmaterialobjekt festgelegt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Die folgenden Felder können von Lehrkräften angegeben werden:

  • title
  • description
  • state
  • scheduledTime
  • topicId

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Anfragetext

Der Anfragetext enthält eine Instanz von CourseWorkMaterial.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.