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

Method: courses.courseWorkMaterials.list

Gibt eine Liste der Kursmaterialien zurück, die der Anforderer sehen darf.

Kursteilnehmer dürfen nur PUBLISHED Kursmaterial ansehen. Kurslehrer und Domainadministratoren können sich das gesamte Kursmaterial ansehen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf den angeforderten Kurs oder Zugriffsfehler zugreifen darf.
  • 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}/courseWorkMaterials

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
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Einschränkung des zurückzugebenden Arbeitsstatus Es wird nur übereinstimmendes Kursmaterial zurückgegeben. Wenn nichts angegeben ist, werden Elemente mit dem Arbeitsstatus PUBLISHED zurückgegeben.

orderBy

string

Optionale Sortierfolge für Ergebnisse. Eine durch Kommas getrennte Liste von Feldern mit einem optionalen Keyword für die Sortierreihenfolge. Unterstütztes Feld ist updateTime. Unterstützte Richtungs-Keywords sind asc und desc. Wenn nicht angegeben, ist updateTime desc das Standardverhalten. Beispiele: updateTime asc, updateTime

pageSize

integer

Maximale Anzahl der Artikel, die zurückgegeben werden sollen. Null oder keine Angabe gibt an, dass der Server ein Maximum zuweisen kann.

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.

materialDriveId

string

Optionale Filterung für Kursmaterial mit mindestens einem Drive-Material, dessen ID mit dem angegebenen String übereinstimmt. Wenn auch materialLink angegeben ist, muss das Arbeitsmaterial des Kurses Materialien enthalten, die mit beiden Filtern übereinstimmen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort beim Auflisten der Kursmaterialien.

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

object (CourseWorkMaterial)

Mit der Anfrage übereinstimmende Arbeitsmaterialien des Kurses.

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.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.