Method: courses.courseWork.list

Zwraca listę zadań z kursu, które może wyświetlić osoba przesyłająca prośbę.

Uczniowie mogą tylko wyświetlać PUBLISHED zadania z zajęć. Nauczyciele i administratorzy domeny mogą wyświetlać wszystkie zadania.

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

  • PERMISSION_DENIED jeśli użytkownik nie ma dostępu do kursu lub w przypadku błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • NOT_FOUND, jeśli wybrany kurs 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 kursu. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
courseWorkStates[]

enum (CourseWorkState)

Ograniczenie dotyczące stanu zadania, które ma zostać zwrócone. Zwracane są tylko pasujące elementy courseWork. Jeśli nie podano tego argumentu, zwracane są elementy o stanie pracy PUBLISHED.
orderBy

string

Opcjonalne sortowanie wyników. Lista pól oddzielonych przecinkami z opcjonalnym słowem kluczowym kierunku sortowania. Obsługiwane pola to updateTime i dueDate. Obsługiwane słowa kluczowe dotyczące kierunku to asc i desc. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość updateTime desc. Przykłady: dueDate asc,updateTime desc, updateTime,dueDate desc
pageSize

integer

Maksymalna liczba elementów do zwrócenia. Wartość 0 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, wskazująca, że należy zwrócić kolejną stronę wyników.

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

enum (PreviewVersion)

Opcjonalnie: Wersja wstępna interfejsu API. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu w wersji podglądowej, musisz ustawić tę opcję.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na pytanie o zadania

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

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

object (CourseWork)

elementy pracy zaliczeniowej, które pasują do żądania.
nextPageToken

string

Token identyfikujący następną stronę wyników do zwrócenia. Jeśli jest puste, nie ma dostępnych dalszych wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 dotyczącym autoryzacji.