Method: courses.courseWorkMaterials.patch

Aktualisiert ein oder mehrere Felder eines Kursmaterials.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED bei Zugriffsfehlern für das anfragende Entwicklerprojekt.
  • 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 ein alias sein.
id

string

Kennung des Kursmaterials.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder des Kursmaterials 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, aber 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.

Lehrer können die folgenden Felder angeben:

  • title
  • description
  • state
  • scheduledTime
  • topicId
  • learningGoals

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

enum (PreviewVersion)

Optional. Die Vorschauversion des Endpunkts.

PREVIEW_VERSION_9001 umfasst neue Funktionen: * Aktualisierungen von Materialien werden unterstützt. Verwenden Sie zum Aktualisieren von Materialien die Aktualisierungsmaske „materials“. 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 „materials“ in der Aktualisierungsmaske, aber nicht im CourseWorkMaterial-Objekt angegeben wird. 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.