Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

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

Hierfür muss das Add-on der ursprüngliche Ersteller des Anhangs sein und für den Anhang muss ein positiver maxPoints-Wert festgelegt sein.

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 des Announcement, CourseWork oder CourseWorkMaterial, unter dem der Anhang angehängt ist. Dieses Feld ist erforderlich, ist aber bei der Migration von postId nicht entsprechend gekennzeichnet.

attachmentId

string

Erforderlich. ID des Anhangs.

submissionId

string

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

Abfrageparameter

Parameter
postId
(deprecated)

string

Optional. Verworfen, verwenden Sie 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 werden. Wenn ein Feld leere Werte unterstützt, können Sie es löschen, indem Sie es in der Aktualisierungsmaske und nicht im AddOnAttachmentStudentSubmission-Objekt angeben.

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

  • pointsEarned

Dies ist eine durch Kommas getrennte Liste vollständig 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.