Method: courses.courseWorkMaterials.addOnAttachments.patch

Aktualisiert einen Add-on-Anhang.

Das Add-on muss der ursprüngliche Ersteller des Anhangs gewesen 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}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Kennung des Kurses.
itemId

string

Die ID des Beitrags, unter dem der Anhang angehängt ist.
attachmentId

string

Erforderlich. Kennung des Anhangs.

Abfrageparameter

Parameter
postId

string

Erforderlich. Die ID des Beitrags, unter dem der Anhang angehängt ist.
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 AddOnAttachment-Objekt angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten ist und nicht im AddOnAttachment-Objekt festgelegt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

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

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

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

Anfragetext

Der Anfragetext enthält eine Instanz von AddOnAttachment.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.