Method: courses.announcements.addOnAttachments.create

Erstellt einen Add-on-Anhang unter einem Beitrag.

Das Add-on muss die Berechtigung haben, neue Anhänge zum Beitrag hinzuzufügen.

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

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

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 erstellt werden soll. Dieses Feld ist erforderlich, wird aber während der Migration von „postId“ nicht als solches gekennzeichnet.

Abfrageparameter

Parameter
postId
(deprecated)

string

Optional. Verworfen, verwenden Sie stattdessen itemId.
addOnToken

string

Optional. Token, das die Anfrage autorisiert.

Das Token wird als Abfrageparameter übergeben, wenn der Nutzer von Classroom zur URL des Add-ons weitergeleitet wird.

Dieses Autorisierungstoken ist für das Erstellen von Anhängen in Classroom erforderlich, aber optional für das Erstellen von Anhängen, die zuerst von einem Partner erstellt wurden. Es wird ein Fehler zurückgegeben, wenn der Parameter nicht für das Erstellen von Anhängen durch Partner angegeben ist und die Entwicklerprojekte, in denen das Anhangselement und das übergeordnete Streamelement erstellt wurden, nicht übereinstimmen.

Anfragetext

Der Anfragetext enthält eine Instanz von AddOnAttachment.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte 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.