Method: courses.courseWork.list

Zwraca listę zadań, które osoba zgłaszająca prośbę może wyświetlić.

Uczestnicy mogą wyświetlać tylko te zadania (PUBLISHED). Nauczyciele i administratorzy domeny mogą wyświetlać wszystkie zadania na zajęciach.

Ta metoda zwraca te kody błędów:

  • PERMISSION_DENIED, jeśli użytkownik wysyłający prośbę nie ma dostępu do żądanego szkolenia lub w przypadku błędów dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli żądane szkolenie nie istnieje.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

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

Parametry zapytania

Parametry
courseWorkStates[]

enum (CourseWorkState)

Ograniczenie dotyczące statusu zadania do zwrócenia. Zwracane są tylko pasujące zadania (courseWork). Jeśli nie określono inaczej, zwracane są elementy ze stanem „Praca” PUBLISHED.

orderBy

string

Opcjonalne sortowanie wyników. Rozdzielona przecinkami lista pól z opcjonalnym słowem kluczowym dotyczącym kierunku sortowania. Obsługiwane pola to updateTime i dueDate. Obsługiwane słowa kluczowe związane z kierunkiem to asc i desc. Jeśli nie określono tego ustawienia, domyślne zachowanie to updateTime desc. Przykłady: dueDate asc,updateTime desc, updateTime,dueDate desc

pageSize

integer

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

Serwer może zwrócić mniej wyników niż określona liczba.

pageToken

string

Wartość nextPageToken zwrócona z poprzedniego wywołania list, co oznacza, że powinna zostać zwrócona kolejna strona wyników.

Żądanie list musi być identyczne z żądaniem, które spowodowało wygenerowanie tego tokena.

previewVersion

enum (PreviewVersion)

Opcjonalnie: Wersja testowa interfejsu API. Jest ono wymagane, aby można było korzystać z nowych funkcji interfejsu API udostępnianych deweloperom w programie testowania wersji przedpremierowej.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź podczas wyświetlania listy zadań.

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

Zapis JSON
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
Pola
courseWork[]

object (CourseWork)

Elementy robocze zajęć pasujące do żądania.

nextPageToken

string

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • 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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.