Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

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

Das Add-on muss 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. Kennung des Kurses.
itemId

string

Kennung der Announcement, CourseWork oder CourseWorkMaterial, unter der der Anhang angehängt ist. Dieses Feld ist erforderlich, wird aber während der Migration von „postId“ nicht als solches gekennzeichnet.
attachmentId

string

Erforderlich. Kennung des Anhangs.
submissionId

string

Erforderlich. Kennung der 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, kann es gelöscht werden, indem es in der Aktualisierungsmaske und nicht im AddOnAttachmentStudentSubmission-Objekt angegeben wird.

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.