Gibt eine Liste der Kursarbeiten zurück, die der Antragsteller ansehen darf.
Kursteilnehmer können nur PUBLISHED
Kursarbeiten aufrufen. Lehrkräfte und Domainadministratoren können alle Kursarbeiten aufrufen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht auf den angeforderten Kurs zugreifen darf, oder bei Zugriffsfehlern.INVALID_ARGUMENT
, wenn die Anfrage fehlerhaft ist.NOT_FOUND
, wenn der angeforderte Kurs nicht existiert.
HTTP-Anfrage
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
course |
Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine |
Abfrageparameter
Parameter | |
---|---|
course |
Einschränkung des zurückzugebenden Arbeitsstatus. Es wird nur der übereinstimmende Kurs zurückgegeben. Wenn nichts angegeben wird, werden Elemente mit dem Arbeitsstatus |
order |
Optionale Sortierreihenfolge für Ergebnisse. Eine durch Kommas getrennte Liste von Feldern mit einem optionalen Keyword für die Sortierrichtung. Unterstützte Felder sind |
page |
Die maximale Anzahl der Elemente, die zurückgegeben werden sollen. „0“ 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. |
page |
Die |
preview |
Optional. Die Vorabversion der API. Diese Einstellung muss festgelegt sein, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort beim Auflisten von Kursarbeiten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"courseWork": [
{
object ( |
Felder | |
---|---|
course |
Kurselemente, die der Anfrage entsprechen. |
next |
Token, das die nächste Ergebnisseite identifiziert, die zurückgegeben werden soll. Ist das Feld leer, sind keine weiteren Ergebnisse verfügbar. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.