Method: courses.courseWorkMaterials.list

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

Schüler/Studenten können sich nur PUBLISHED Arbeitsmaterialien des Kurses ansehen. Kurslehrkräfte und Domainadministratoren können sich alle Arbeitsmaterialien des Kurses ansehen.

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

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

Abfrageparameter

Parameter
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Die Einschränkung des zurückzugebenden Arbeitsstatus. Es werden nur Arbeitsmaterialien des Kurses zurückgegeben, die mit der Übereinstimmung übereinstimmen. Wenn keine Vorgabe erfolgt, 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. Das unterstützte Feld ist updateTime. Unterstützte Richtungs-Keywords sind asc und desc. Wenn keine Angabe erfolgt, ist updateTime desc das Standardverhalten. Beispiele: updateTime asc, updateTime
pageSize

integer

Maximale Anzahl der Artikel, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server ein Maximum zuweisen kann.

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

string

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

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

string

Optionales Filtern von Kursmaterialien mit mindestens einem Drive-Material, dessen ID mit dem angegebenen String übereinstimmt. Wenn auch materialLink angegeben ist, muss das Arbeitsmaterial des Kursmaterials die Materialien enthalten, die mit beiden Filtern übereinstimmen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort beim Auflisten der Kursmaterialien.

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

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

object (CourseWorkMaterial)

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.