- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- LateValues
- Wypróbuj
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 |
Identyfikator kursu. Identyfikatorem może być identyfikator przypisany przez Classroom lub |
courseWorkId |
Identyfikator pracy ucznia, której dotyczy żądanie. Możesz ustawić tę wartość na ciąg znaków |
Parametry zapytania
Parametry | |
---|---|
userId |
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:
|
states[] |
Stany żądań Jeśli to pole jest określone, zwrócone projekty uczniów muszą odpowiadać jednemu ze wskazanych stanów. |
late |
Żą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 |
pageSize |
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 |
Wartość Żądanie |
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 ( |
Pola | |
---|---|
studentSubmissions[] |
zadania ucznia, które odpowiadają prośbie; |
nextPageToken |
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. |