Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

Method: courses.announcements.list

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Gibt eine Liste von Ankündigungen zurück, die der Anforderer ansehen darf.

Schüler und Studenten können nur PUBLISHED-Ankündigungen ansehen. 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 auf den angeforderten Kurs oder auf Zugriffsfehler zugreifen darf.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs nicht vorhanden ist.

HTTP-Request

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

ID des Kurses. Diese Kennung kann die von Classroom zugewiesene Kennung oder ein alias sein.

Abfrageparameter

Parameter
announcementStates[]

enum (AnnouncementState)

Einschränkung für die Anzahl der zurückgegebenen state. Wenn dieses Argument nicht angegeben ist, ist der Standardwert PUBLISHED.
orderBy

string

Optionale Sortierreihenfolge für Ergebnisse. Eine durch Kommas getrennte Liste von Feldern mit einem optionalen Keyword für die Sortierrichtung. Unterstütztes Feld ist updateTime. Unterstützte Richtungs-Keywords sind asc und desc. Wenn keine Angabe erfolgt, wird das Standardverhalten als updateTime desc verwendet. Beispiele: updateTime asc, updateTime
pageSize

integer

Maximale Anzahl der Elemente, die zurückgegeben werden sollen Wenn der Wert null oder nicht angegeben ist, kann der Server einen Maximalwert zuweisen.

Der Server gibt möglicherweise weniger als die angegebene Anzahl von Ergebnissen zurück.
pageToken

string

nextPageToken-Wert aus einem vorherigen list-Aufruf. Gibt an, dass die nachfolgende Seite mit Ergebnissen zurückgegeben werden soll.

Die list-Anfrage muss ansonsten mit der Anfrage übereinstimmen, die zu diesem Token geführt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort, wenn ein Kurseintrag aufgeführt wird

JSON-Darstellung 
{
  "announcements": [
    {
      object (Announcement)
    }
  ],
  "nextPageToken": string
}
Felder
announcements[]

object (Announcement)

Ankündigungselemente, die der Anfrage entsprechen
nextPageToken

string

Token, mit dem die nächste Ergebnisseite zurückgegeben wird. Wenn leer, 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 in der Übersicht zu OAuth 2.0.