- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- LateValues
- Wypróbuj
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 |
Identyfikator zajęć. Może to być identyfikator przypisany do Classroom lub |
courseWorkId |
Identyfikator zadania ucznia, o którego poprosić. Można ją ustawić na literał ciągu |
Parametry zapytania
Parametry | |
---|---|
userId |
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:
|
states[] |
Żą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 |
Żą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 |
pageSize |
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 |
Wartość Żądanie |
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 ( |
Pola | |
---|---|
studentSubmissions[] |
Zadania uczniów pasujące do zapytania. |
nextPageToken |
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). |