Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
Method: courses.get
Gibt einen Kurs zurück.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs zuzugreifen, oder Zugriffsfehler aufgetreten sind.
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 Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.
|
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 Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-08-15 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-08-15 (UTC)."],[[["This method returns a course based on its ID, which can be either Classroom-assigned or an alias."],["Users need to have appropriate authorization scopes, either `classroom.courses` or `classroom.courses.readonly`, to access the course data."],["Possible error codes include `PERMISSION_DENIED` if the user lacks access or `NOT_FOUND` if the course ID is invalid."],["The request body should be empty, and a successful response will contain a [Course](/classroom/reference/rest/v1/courses#Course) object."],["This endpoint uses a `GET` request with the course ID as a path parameter, following gRPC Transcoding syntax."]]],[]]