Method: courses.announcements.addOnAttachments.create

Erstellt einen Add-on-Anhang unter einem Beitrag.

Das Add-on benötigt die Berechtigung zum Erstellen neuer Anhänge zum Beitrag.

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. ID des Kurses.

itemId

string

ID des Announcement, CourseWork oder CourseWorkMaterial, unter dem der Anhang erstellt werden soll. Dieses Feld ist erforderlich, ist aber bei der Migration von postId nicht entsprechend 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 die Erstellung von Anhängen in Classroom erforderlich, aber optional für die Erstellung des ersten Partners. Gibt einen Fehler zurück, wenn kein Partner-erster Anhang angegeben ist und die Entwicklerprojekte, die den Anhang und das übergeordnete Streamelement erstellt haben, 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.