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 Zugriffsfehler aufgetreten sind.NOT_FOUND
, wenn kein Kurs mit der angeforderten ID vorhanden ist.INVALID_ARGUMENT
, wenn in der Aktualisierungsmaske ungültige Felder angegeben oder keine Aktualisierungsmaske angegeben ist.FAILED_PRECONDITION
für die folgenden Anfragefehler:- CourseNotModifiable
- InactiveCourseOwner
- IneligibleOwner
HTTP-Anfrage
PATCH https://classroom.googleapis.com/v1/courses/{id}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
id |
ID des zu aktualisierenden Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine |
Abfrageparameter
Parameter | |
---|---|
updateMask |
Maske, die angibt, welche Felder im Kurs aktualisiert werden sollen. Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden. Die folgenden Felder sind gültig:
Hinweis: Patches für „ownerId“ gelten als 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 ist, sollte es so angegeben werden:
Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: |
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 Leitfaden zur Autorisierung.