Method: courses.courseWork.studentSubmissions.list

Zwraca listę prac uczniów, które można wyświetlić, uwzględniając zakresy protokołu OAuth żądania. - może być określone jako courseWorkId, aby uwzględnić przesłane przez uczniów treści dotyczące wielu elementów pracy z zajęć.

Uczniowie mogą wyświetlać tylko swoje prace. Nauczyciele i administratorzy domen mogą wyświetlać wszystkie przesłane przez uczniów treści.

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

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

string

Identyfikator pracy ucznia, której dotyczy żądanie. Możesz ustawić tę wartość na ciąg znaków "-", aby poprosić ucznia o wykonanie wszystkich zadań z określonego kursu.

Parametry zapytania

Parametry
userId

string

Opcjonalny argument, który umożliwia ograniczenie zwróconych zadań ucznia do tych należących do ucznia o określonym identyfikatorze. Identyfikator może być jednym z tych elementów:

  • identyfikator liczbowy użytkownika.
  • adres e-mail użytkownika.
  • ciąg znaków "me" wskazujący użytkownika, który wysłał żądanie;
states[]

enum (SubmissionState)

Stany żądań Jeśli to pole jest określone, zwrócone projekty uczniów muszą odpowiadać jednemu ze wskazanych stanów.
late

enum (LateValues)

Żądana wartość opóźnienia. Jeśli jest to określone, zwrócone projekty uczniów są ograniczone przez żądaną wartość. Jeśli nie podasz tej wartości, zgłoszenia są zwracane niezależnie od wartości parametru late.
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ź podczas wyświetlania listy prac 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 ucznia, które odpowiadają prośbie;
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.

LateValues

Ograniczenia dotyczące wartości zwróconych towarów po terminie.

Wartości w polu enum
LATE_VALUES_UNSPECIFIED Nie określono żadnych ograniczeń dotyczących wartości opóźnionych przesyłania.
LATE_ONLY Zwraca StudentSubmissions, gdy wartość late jest równa Prawda.
NOT_LATE_ONLY Zwraca StudentSubmissions, gdy wartość late jest równa false.