Method: courses.teachers.list

Gibt eine Liste der Lehrkräfte dieses Kurses zurück, auf die der Antragsteller zugreifen darf.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • NOT_FOUND, wenn der Kurs nicht vorhanden ist.
  • PERMISSION_DENIED für Zugriffsfehler.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

Abfrageparameter

Parameter
pageSize

integer

Maximale Anzahl der Artikel, die zurückgegeben werden sollen. Wenn kein Wert angegeben ist, ist der Standardwert 30 oder 0.

Der Server gibt möglicherweise weniger Ergebnisse als die angegebene Anzahl zurück.

pageToken

string

nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde. Dieser gibt an, dass die nachfolgende Ergebnisseite 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

Antwort beim Auflisten von Lehrkräften.

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

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

object (Teacher)

Lehrkräfte, die der Listenanfrage entsprechen.

nextPageToken

string

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.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.