Gibt die Liste der Themen zurück, die der Anforderer aufrufen darf.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht auf den angeforderten Kurs zugreifen darf oder Zugriffsfehler aufgetreten sind.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}/topics
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
courseId |
ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine |
Abfrageparameter
Parameter | |
---|---|
pageSize |
Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server ein Maximum 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 Themen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"topic": [
{
object ( |
Felder | |
---|---|
topic[] |
Themenelemente, die der Anfrage entsprechen. |
nextPageToken |
Token, das die nächste Ergebnisseite angibt, die zurückgegeben werden soll. Wenn das Feld leer ist, sind keine weiteren Ergebnisse verfügbar. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/classroom.topics.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.