Method: courses.courseWorkMaterials.list

Zwraca listę materiałów do zajęć, które osoba zgłaszająca może przeglądać.

Uczestnicy zajęć mogą wyświetlać tylko PUBLISHED materiału do zadania. Nauczyciele kursów i administratorzy domeny mogą wyświetlać wszystkie materiały do zadań.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli użytkownik wysyłający prośbę nie ma dostępu do żądanego kursu lub występuje błąd dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli żądany kurs nie istnieje.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Identyfikator zajęć. Może to być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Ograniczenie dotyczące stanu zadania. Zwracane są tylko pasujące materiały. Jeśli nie określono inaczej, zwracane są elementy ze stanem zadania PUBLISHED.
orderBy

string

Opcjonalna kolejność sortowania wyników. Rozdzielona przecinkami lista pól z opcjonalnym słowem kluczowym dotyczącym kierunku sortowania. Obsługiwane pole to updateTime. Obsługiwane słowa kluczowe to asc i desc. Jeśli nie podasz tu żadnej wartości, domyślną wartością będzie updateTime desc. Przykłady: updateTime asc, updateTime
pageSize

integer

Maksymalna liczba produktów do zwrócenia. Wartość zero lub nieokreślona oznacza, że serwer może przypisać wartość maksymalną.

Serwer może zwrócić mniej wyników niż określono.
pageToken

string

Wartość nextPageToken zwrócona z poprzedniego wywołania list, która wskazuje, że powinna zostać zwrócona kolejna strona z wynikami.

Żądanie list musi być w inny sposób identyczne z żądaniem, które spowodowało ten token.
materialDriveId

string

Opcjonalne filtrowanie materiałów do zadań przy użyciu co najmniej 1 materiału na Dysku, którego identyfikator pasuje do podanego ciągu. Jeśli określono również właściwość materialLink, materiały do zadania muszą zawierać materiały pasujące do obu filtrów.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na listę materiałów do pracy.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
Pola
courseWorkMaterial[]

object (CourseWorkMaterial)

Elementy materiałów pracy kursu pasujące do żądania.
nextPageToken

string

Token określający następną stronę wyników do zwrócenia. Jeśli pole jest puste, kolejne wyniki nie są dostępne.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.