Method: courses.courseWork.patch

Aktualisiert ein oder mehrere Felder einer Kursaufgabe.

Weitere Informationen dazu, welche Felder aktualisiert werden können und wer sie ändern kann, finden Sie unter google.classroom.v1.CourseWork.

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zur Erstellung des entsprechenden Arbeitselements des Kurses verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn das anfragende Entwicklerprojekt die entsprechende Kursaufgabe nicht erstellt hat, der Nutzer nicht berechtigt ist, die angeforderte Änderung an der Einreichung des Schülers/Studenten vorzunehmen, oder wenn Zugriffsfehler vorliegen.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn die angeforderte Kursaufgabe bereits gelöscht wurde.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursaufgabe oder die Aufgabe des Schülers/Studenten nicht vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.
id

string

ID der Kursaufgabe.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder im Kurs aktualisiert werden müssen. Dieses Feld ist für eine Aktualisierung 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 das Feld in der Aktualisierungsmaske und nicht im CourseWork-Objekt angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in die Aktualisierungsmaske aufgenommen und nicht im CourseWork-Objekt festgelegt wird, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.

Die folgenden Felder können von Lehrkräften festgelegt werden:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

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

Anfragetext

Der Anfragetext enthält eine Instanz von CourseWork.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.coursework.students

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.