Gibt eine Liste der Ankündigungen zurück, die der Anforderer sehen darf.
Schüler und Studenten können Ankündigungen zu PUBLISHED
nur sehen. Lehrkräfte und Domainadministratoren können sich alle Ankündigungen ansehen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs zuzugreifen, oder wenn Zugriffsfehler vorliegen.INVALID_ARGUMENT
, wenn die Anfrage fehlerhaft ist.NOT_FOUND
, wenn der angeforderte Kurs nicht vorhanden ist.
HTTP-Anfrage
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
courseId |
ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene Kennung oder eine |
Abfrageparameter
Parameter | |
---|---|
announcementStates[] |
Beschränkung für die |
orderBy |
Optionale Sortierreihenfolge für Ergebnisse. Eine durch Kommas getrennte Liste von Feldern mit einem optionalen Schlüsselwort für die Sortierrichtung. Unterstütztes Feld ist |
pageSize |
Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server einen Höchstwert zuweisen kann. Der Server gibt möglicherweise weniger als die angegebene Anzahl von Ergebnissen zurück. |
pageToken |
Die |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort beim Auflisten von Kursarbeiten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"announcements": [
{
object ( |
Felder | |
---|---|
announcements[] |
Ankündigungselemente, die der Anfrage entsprechen. |
nextPageToken |
Token, das die nächste Ergebnisseite identifiziert, die zurückgegeben werden soll. Wenn das Feld leer ist, sind keine weiteren Ergebnisse verfügbar. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.