Method: courses.announcements.addOnAttachments.create

Add-on-Anhang unter einem Beitrag erstellen

Das Add-on muss dazu berechtigt sein, neue Anhänge für den Beitrag zu erstellen.

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 der Ankündigung, von „courseWork“ oder „courseWorkMaterial“, unter der der Anhang erstellt werden soll. Dieses Feld ist erforderlich, ist aber während der Migration von postId nicht als solches gekennzeichnet.

Abfrageparameter

Parameter
postId
(deprecated)

string

Optional. Eingestellt. Verwende stattdessen „itemId“.
addOnToken

string

Optional. Token, das die Anfrage autorisiert.

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

Dieses Autorisierungstoken ist für das Erstellen von Anhängen in Classroom erforderlich, aber optional für Partner-First-Anhänge. Gibt einen Fehler zurück, wenn beim Erstellen eines Partner-First-Anhangs kein Wert angegeben ist und die Entwicklerprojekte, die den Anhang erstellt haben, und das übergeordnete Streamelement 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.