Method: courses.courseWorkMaterials.patch

Aktualisiert ein oder mehrere Felder eines Kursmaterials.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn im Entwicklerprojekt, das die Anfrage stellt, Zugriffsfehler auftreten.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn das angeforderte Kursmaterial bereits gelöscht wurde.
  • NOT_FOUND, wenn der angeforderte Kurs oder das angeforderte Kursmaterial 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 von Classroom zugewiesene Kennung oder eine alias sein.
id

string

Kennung des Kursarbeitsmaterials.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder des Kursmaterials aktualisiert werden sollen. Dieses Feld ist für ein Update erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben sind. Wenn ein Feld leere Werte unterstützt, kann es gelöscht werden, indem es in der Aktualisierungsmaske, aber nicht im Objekt für Kursmaterial angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten ist und nicht im Kursmaterialobjekt festgelegt ist, wird ein INVALID_ARGUMENT-Fehler 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".
previewVersion

enum (PreviewVersion)

Optional. Die Vorschauversion des Endpunkts.

PREVIEW_VERSION_9001 bietet neue Funktionen: * Aktualisierungen von Materialien werden unterstützt. Verwenden Sie die updateMask „materials“, um Materialien zu aktualisieren. Die Liste der Materialien, die im CourseWorkMaterial-Objekt der Anfrage angegeben sind, ersetzt die vorhandene Liste vollständig. Das Feld „materials“ kann gelöscht werden, indem Sie „materials“ in der Aktualisierungsmaske und nicht im CourseWorkMaterial-Objekt angeben. Aktualisierungen von PUBLISHED CourseWorkMaterial werden derzeit nicht unterstützt.

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