Method: courses.courseWork.patch

Aktualisiert ein oder mehrere Felder einer Kursaufgabe.

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

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zum Erstellen des entsprechenden Kursarbeitselements verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn durch das anfragende Entwicklerprojekt die entsprechende Kursaufgabe nicht erstellt wurde, der Nutzer nicht berechtigt ist, die angeforderten Änderungen an den eingereichten Arbeiten der Schüler/Studenten vorzunehmen, oder wenn es Zugriffsfehler gab.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn die angeforderte Kursaufgabe bereits gelöscht wurde.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursaufgabe 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 Kennung oder eine alias sein.
id

string

Die Kennung der Kursaufgabe.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

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. Wenn ein Feld leere Werte unterstützt, können Sie es löschen, indem Sie es in der Aktualisierungsmaske und nicht im CourseWork-Objekt angeben. Wenn die Aktualisierungsmaske ein Feld enthält, das keine leeren Werte unterstützt und nicht im CourseWork-Objekt festgelegt wird, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Verfügbar ab V1_20240401_PREVIEW

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

enum (PreviewVersion)

Optional. Die Vorschauversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorschauprogramm zur Verfügung stehen.

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.