Verwenden Ihre Nutzer Classroom mit Google Meet? Weitere Informationen finden Sie unter Apps Script – Kurzanleitung.

Method: courses.teachers.list

Gibt eine Liste der Lehrkräfte für diesen Kurs zurück, die der Anforderer sehen darf.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • NOT_FOUND, wenn der Kurs nicht existiert.
  • 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

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

Suchparameter

Parameter
pageSize

integer

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

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

string

nextPageToken-Wert aus einem vorherigen list-Aufruf, der angibt, dass die nachfolgende Ergebnisseite zurückgegeben werden soll.

Die Anfrage list muss ansonsten mit der Anfrage identisch sein, 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 beim Auflisten von Lehrkräften

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

object (Teacher)

Lehrkräfte, die mit der Anfrage einer Liste übereinstimmen.
nextPageToken

string

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 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 in der OAuth 2.0-Übersicht.