Method: courses.posts.addOnAttachments.list

Gibt alle Anhänge zurück, die von einem Add-on unter dem Beitrag erstellt wurden.

Das Add-on muss aktive Anhänge im Beitrag haben oder die Berechtigung haben, neue Anhänge im 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

GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Kennung des Kurses.

postId
(deprecated)

string

Optional. Die ID des Beitrags im Kurs, dessen Anhänge aufgelistet werden sollen. Verworfen, verwenden Sie stattdessen itemId.

Abfrageparameter

Parameter
itemId

string

Kennung der Announcement, CourseWork oder CourseWorkMaterial, deren Anhänge aufgelistet werden sollen. Dieses Feld ist erforderlich, wird aber während der Migration von postId nicht als solches gekennzeichnet.

pageSize

integer

Die maximale Anzahl der Anhänge, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 20 Anhänge zurückgegeben. Der Höchstwert ist 20. Werte über 20 werden auf 20 festgelegt.

pageToken

string

Ein Seitentoken, das von einem vorherigen addOnAttachments.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für addOnAttachments.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.