Method: courses.courseWork.studentSubmissions.list

Zwraca listę zadań uczniów, które osoba zgłaszająca może przeglądać, z uwzględnieniem zakresów OAuth żądania. Element - można określić jako courseWorkId, aby uwzględnić przesłane przez uczniów projekty wielu zadań w ramach kursu.

Uczniowie mogą wyświetlać tylko własne zadania. Nauczyciele biorący udział w zajęciach i administratorzy domeny mogą wyświetlać wszystkie przesłane przez uczniów zadania.

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 kursu lub zadania albo 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/{courseWorkId}/studentSubmissions

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.

courseWorkId

string

Identyfikator zadania ucznia, o którego poprosić. Można ją ustawić na literał ciągu "-", aby żądać od uczniów zadań związanych ze wszystkimi zadaniami na określonych zajęciach.

Parametry zapytania

Parametry
userId

string

Opcjonalny argument umożliwiający ograniczenie zwróconych zadań do uczniów o określonym identyfikatorze. Może to być jeden z tych identyfikatorów:

  • identyfikator numeryczny użytkownika
  • adres e-mail użytkownika,
  • literał ciągu "me", który wskazuje użytkownika wysyłającego żądanie
states[]

enum (SubmissionState)

Żądane stany przesłania. Jeśli został określony, zwrócone zadania przesłane przez uczniów pasują do jednego z podanych stanów.

late

enum (LateValues)

Żądana wartość czasu oczekiwania. Jeśli zostanie określona, zwrócone zadania przesłane przez uczniów będą ograniczone przez żądaną wartość. Jeśli wartość nie zostanie określona, elementy będą zwracane niezależnie od wartości late.

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ń przesłanych przez uczniów.

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

Zapis JSON
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Pola
studentSubmissions[]

object (StudentSubmission)

Zadania uczniów pasujące do zapytania.

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.

LateValues

Ograniczenia dotyczące późnej wartości zwróconych produktów.

Wartości w polu enum
LATE_VALUES_UNSPECIFIED Nie określono ograniczeń dotyczących spóźnionych wartości przesłanych.
LATE_ONLY Zwracanie prac uczniów z uwzględnieniem ich spóźnienia.
NOT_LATE_ONLY Zwróć zadania uczniów, w przypadku których spóźnienie ma wartość false (fałsz).