Method: courses.get

Gibt einen Kurs zurück.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keinen Zugriff auf den angeforderten Kurs hat oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn kein Kurs mit der angeforderten ID vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
id

string

ID des Kurses, der zurückgegeben werden soll. Diese ID kann entweder die von Classroom zugewiesene ID oder ein alias sein.

Suchparameter

Parameter
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Course.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.