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ć prace uczniów przesłane do wielu zadań.

Uczestnicy zajęć mogą wyświetlać tylko własne zadania. Nauczyciele kursów i administratorzy domeny mogą wyświetlać wszystkie zadania przesłane przez uczniów.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli użytkownik proszący o dostęp nie ma dostępu do żądanych zajęć lub zadań albo z powodu błędów dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • 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 zajęć. Może to być identyfikator przypisany przez Classroom lub alias.
courseWorkId

string

Identyfikator zadania ucznia, którego dotyczy prośba. Wartość tę można ustawić na literał "-" w celu żądania zadań uczniów w przypadku wszystkich zadań w określonym kursie.

Parametry zapytania

Parametry
userId

string

Opcjonalny argument pozwalający ograniczyć zwrócone zadania uczniów do tych, które należą do ucznia o określonym identyfikatorze. Może on mieć jeden z tych identyfikatorów:

  • identyfikator numeryczny użytkownika
  • adres e-mail użytkownika.
  • literał ciągu znaków "me" wskazujący użytkownika wysyłającego żądanie
states[]

enum (SubmissionState)

Stany, w których wysłano żądanie. Jeśli jest określony, zwrócone zadania przesłane przez uczniów pasują do jednego ze wskazanych stanów zadań.
late

enum (LateValues)

Żądana wartość opóźnienia. Jeśli jest określony, zwracane zadania uczniów są ograniczone przez żądaną wartość. Jeśli wartość nie jest określona, zwracane są zadania niezależnie od wartości late.
pageSize

integer

Maksymalna liczba produktó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 z wynikami.

Żądanie list musi być w inny sposób identyczne z żądaniem, które spowodowało ten token.
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja testowa interfejsu API. Ten parametr należy skonfigurować, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnianych deweloperom w ramach Programu testowania aktualizacji.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na listę 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 żądania.
nextPageToken

string

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

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 spóźnionej wartości zwróconych produktów.

Wartości w polu enum
LATE_VALUES_UNSPECIFIED Nie określono ograniczenia w zakresie późnych wartości przesyłania.
LATE_ONLY Zwróć Zadania uczniów, gdy jest to spóźnione.
NOT_LATE_ONLY Zwróć Zadania uczniów, gdzie opóźnienie zawiera wartość fałsz.