Method: courses.courseWork.studentSubmissions.list

Zwraca listę zadań odesłanych przez uczniów, które osoba wysyłająca żądanie może wyświetlić, z uwzględnieniem zakresów OAuth żądania. Jako courseWorkId można podać łącznik (-), aby uwzględnić zadania przesłane przez uczniów w przypadku wielu projektów.

Uczniowie kursu mogą wyświetlać tylko swoje prace. Nauczyciele prowadzący kurs i administratorzy domeny mogą wyświetlać wszystkie zadania przesłane przez uczniów.

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

  • PERMISSION_DENIED, jeśli użytkownik wysyłający żądanie nie ma uprawnień dostępu do żądanych zajęć lub pracy na zajęciach, lub w przypadku błędów dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest nieprawidłowo sformatowane.
  • 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 szkolenia. Ten identyfikator może być identyfikatorem przypisanym przez Classroom lub alias.
courseWorkId

string

Identyfikator zadania ucznia, o które chcesz poprosić. Można ustawić wartość "-", aby poprosić o prace uczniów ze wszystkich zadań na określonych zajęciach.

Parametry zapytania

Parametry
userId

string

Argument opcjonalny, który ogranicza zwracane zadania uczniów do tych, które należą do ucznia o określonym identyfikatorze. Identyfikator może być jednym z tych elementów:

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

enum (SubmissionState)

Żądane stany przesłania. Jeśli podano ten argument, zwrócone projekty uczniów będą pasować do jednego z określonych stanów przesłania.
late

enum (LateValues)

Żądana wartość opóźnienia. Jeśli podano wartość, zwrócone projekty uczniów są ograniczone przez żądaną wartość. Jeśli nie podano tego argumentu, przesyłane zgłoszenia są zwracane niezależnie od wartości late.
pageSize

integer

Maksymalna liczba elementó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 wyników.

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

enum (PreviewVersion)

Opcjonalnie. Wersja przedpremierowa interfejsu API. Musisz to ustawić, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu podglądu.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź podczas wyświetlania listy przesłanych 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)

prace uczniów, które pasują do żądania.
nextPageToken

string

Token identyfikujący następną stronę wyników do zwrócenia. Jeśli jest puste, nie ma więcej 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 po autoryzacji.

LateValues

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

Wartości w polu enum
LATE_VALUES_UNSPECIFIED Nie określono żadnych ograniczeń dotyczących wartości opóźnionych przesłanych danych.
LATE_ONLY Zwraca obiekty StudentSubmission, w których pole late ma wartość true.
NOT_LATE_ONLY Zwróć obiekty StudentSubmission, w których pole late ma wartość false.