Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

Aktualisiert Daten, die mit einem eingereichten Add-on-Anhang verknüpft sind.

Dafür muss das Add-on der ursprüngliche Ersteller des Anhangs gewesen sein. Der Anhang muss einen positiven maxPoints-Wert haben.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED für Zugriffsfehler.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn eine der identifizierten Ressourcen nicht vorhanden ist.

HTTP-Anfrage

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. ID des Kurses.
itemId

string

ID der Ankündigung, von „courseWork“ oder „courseWorkMaterial“, unter der der Anhang angehängt ist. Dieses Feld ist erforderlich, ist aber während der Migration von postId nicht als solches gekennzeichnet.
attachmentId

string

Erforderlich. ID des Anhangs.
submissionId

string

Erforderlich. ID der abgegebenen Aufgabe des Schülers/Studenten.

Abfrageparameter

Parameter
postId
(deprecated)

string

Optional. Eingestellt. Verwende stattdessen „itemId“.
updateMask

string (FieldMask format)

Erforderlich. Maske, die angibt, welche Felder im Anhang aktualisiert werden sollen. 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 AddOnAttachmentStudentSubmission-Objekt angegeben wird.

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

  • pointsEarned

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

Anfragetext

Der Anfragetext enthält eine Instanz von AddOnAttachmentStudentSubmission.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.addons.teacher

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.