- Żą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ć 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 |
Identyfikator zajęć. Może to być identyfikator przypisany przez Classroom lub |
courseWorkId |
Identyfikator zadania ucznia, którego dotyczy prośba. Wartość tę można ustawić na literał |
Parametry zapytania
Parametry | |
---|---|
userId |
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:
|
states[] |
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 |
Żą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 |
pageSize |
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 |
Wartość Żądanie |
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 ( |
Pola | |
---|---|
studentSubmissions[] |
Zadania uczniów pasujące do żądania. |
nextPageToken |
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. |