Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

Method: courses.courseWorkMaterials.patch

Aktualisiert ein oder mehrere Felder eines Kursmaterials.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn das anfordernde Entwicklerprojekt für Zugriffsfehler gilt.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn das angeforderte Kursmaterial bereits gelöscht wurde.
  • NOT_FOUND, wenn das angeforderte Kurs- oder 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 Kursmaterials.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, 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, können Sie es löschen, indem Sie es in der Aktualisierungsmaske und nicht im Arbeitsmaterialobjekt des Kurses angeben. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten und nicht im Arbeitsmaterialobjekt des Kurses festgelegt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Folgende 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 in der OAuth 2.0-Übersicht.