Method: courses.courseWork.list

Gibt eine Liste der Kursarbeiten zurück, die der Anforderer ansehen darf.

Schüler/Studenten können nur PUBLISHED Kursarbeiten ansehen. Lehrkräfte und Domainadministratoren können sich alle Kursarbeiten ansehen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs zuzugreifen, oder wenn Zugriffsfehler vorliegen.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs nicht vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

Abfrageparameter

Parameter
courseWorkStates[]

enum (CourseWorkState)

Einschränkung des Arbeitsstatus, der zurückgegeben werden soll. Es wird nur „courseWork“ zurückgegeben, das übereinstimmt. Wenn kein Wert angegeben ist, werden Elemente mit dem Arbeitsstatus PUBLISHED zurückgegeben.
orderBy

string

Optionale Sortierreihenfolge für Ergebnisse. Eine durch Kommas getrennte Liste von Feldern mit einem optionalen Schlüsselwort für die Sortierrichtung. Unterstützte Felder sind updateTime und dueDate. Unterstützte Richtungs-Keywords sind asc und desc. Wenn nicht angegeben, ist updateTime desc das Standardverhalten. Beispiele: dueDate asc,updateTime desc, updateTime,dueDate desc
pageSize

integer

Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server einen Höchstwert zuweisen kann.

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

string

nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde. Dieser Wert gibt an, dass die nachfolgende Ergebnisseite zurückgegeben werden soll.

Die list-Anfrage muss ansonsten mit der Anfrage identisch sein, die zu diesem Token geführt hat.
previewVersion

enum (PreviewVersion)

Optional. Die Vorschauversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorschauprogramm zur Verfügung stehen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort beim Auflisten von Kursarbeiten.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

object (CourseWork)

Kursaufgaben, die der Anfrage 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.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.