Method: courses.patch

Aktualisiert ein oder mehrere Felder in einem Kurs.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, den angeforderten Kurs zu ändern, oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn kein Kurs mit der angeforderten ID vorhanden ist.
  • INVALID_ARGUMENT, wenn in der Aktualisierungsmaske ungültige Felder angegeben sind oder keine Aktualisierungsmaske angegeben wurde.
  • FAILED_PRECONDITION für die folgenden Anfragefehler:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
id

string

Kennung des Kurses, der aktualisiert werden soll. Diese Kennung kann entweder die von Classroom zugewiesene Kennung oder eine alias sein.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder des Kurses aktualisiert werden sollen. Dieses Feld ist für ein Update erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben sind. Die folgenden Felder sind gültig:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Hinweis: Änderungen an ownerId werden zwar sofort wirksam, in der Praxis kann es jedoch einige Zeit dauern, bis die Übertragung der Inhaberschaft aller betroffenen Ressourcen abgeschlossen ist.

Wenn dieses Feld in einem Abfrageparameter festgelegt wird, sollte es als

updateMask=<field1>,<field2>,...

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

Anfragetext

Der Anfragetext enthält eine Instanz von Course.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.