Method: courses.courseWorkMaterials.list

Gibt eine Liste der Kursmaterialien zurück, die der Antragsteller sich ansehen darf.

Kursteilnehmer können sich nur PUBLISHED Kursmaterialien ansehen. Lehrkräfte und Domainadministratoren können alle Kursmaterialien 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}/courseWorkMaterials

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

Abfrageparameter

Parameter
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Einschränkung des zurückzugebenden Arbeitsstatus. Es werden nur übereinstimmende Kursmaterialien zurückgegeben. Wenn nichts angegeben wird, 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 Keyword für die Sortierrichtung. Unterstütztes Feld: updateTime Unterstützte Richtungs-Keywords sind asc und desc. Wenn keine Angabe erfolgt, ist updateTime desc das Standardverhalten. Beispiele: updateTime asc, updateTime
pageSize

integer

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.
pageToken

string

nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde und angibt, dass die nächste Ergebnisseite zurückgegeben werden soll.

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

string

Optionaler Filter für Kursmaterialien mit mindestens einem Drive-Material, dessen ID mit dem angegebenen String übereinstimmt. Wenn auch materialLink angegeben ist, müssen die Kursmaterialien Materialien enthalten, die beiden Filtern entsprechen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort beim Auflisten von Kursmaterialien.

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

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

object (CourseWorkMaterial)

Kursmaterialien, die der Anfrage entsprechen.
nextPageToken

string

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.