Method: courses.courseWork.studentSubmissions.list

Возвращает список материалов учащихся, которые запрашивающему разрешено просматривать, с учетом областей OAuth запроса. - может быть указан как courseWorkId , чтобы включить материалы, отправленные студентами, для нескольких элементов курсовой работы.

Студенты курса могут просматривать только свои работы. Преподаватели курса и администраторы домена могут просматривать все работы учащихся.

Этот метод возвращает следующие коды ошибок:

  • PERMISSION_DENIED , если запрашивающему пользователю не разрешен доступ к запрошенному курсу или курсовой работе, или в случае ошибок доступа .
  • INVALID_ARGUMENT , если запрос имеет неверный формат.
  • NOT_FOUND , если запрошенный курс не существует.

HTTP-запрос

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
course Id

string

Идентификатор курса. Этот идентификатор может быть либо идентификатором, присвоенным Классом, либо alias .

course Work Id

string

Идентификатор студенческой работы, которую нужно запросить. Можно установить строковый литерал "-" , чтобы запросить работу студента по всем курсам в указанном курсе.

Параметры запроса

Параметры
user Id

string

Необязательный аргумент, позволяющий ограничить возвращаемые работы учащегося теми, которые принадлежат учащемуся с указанным идентификатором. Идентификатор может быть одним из следующих:

  • числовой идентификатор пользователя
  • адрес электронной почты пользователя
  • строковый литерал "me" , указывающий запрашивающего пользователя
states[]

enum ( SubmissionState )

Запрошенные состояния представления. Если указано, возвращенные работы учащихся соответствуют одному из указанных состояний отправки.

late

enum ( LateValues )

Запрошенное значение задержки. Если указано, возвращаемые работы учащихся ограничиваются запрошенным значением. Если не указано, материалы возвращаются независимо от late значения.

page Size

integer

Максимальное количество товаров для возврата. Ноль или не указано означает, что сервер может назначить максимум.

Сервер может вернуть меньшее количество результатов, чем указано.

page Token

string

Значение nextPageToken , возвращенное из предыдущего вызова list , указывает, что должна быть возвращена следующая страница результатов.

В остальном запрос list должен быть идентичен тому, который привел к получению этого токена.

preview Version

enum ( PreviewVersion )

Необязательный. Предварительная версия API. Это необходимо настроить, чтобы получить доступ к новым возможностям API, доступным разработчикам в программе предварительной версии.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ при перечислении работ учащихся.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Поля
student Submissions[]

object ( StudentSubmission )

Студенческая работа, соответствующая запросу.

next Page Token

string

Токен, идентифицирующий следующую страницу результатов, которую нужно вернуть. Если пусто, дальнейшие результаты недоступны.

Области авторизации

Требуется одна из следующих областей 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

Дополнительную информацию см. в руководстве по авторизации .

Поздние значения

Ограничения на просроченную стоимость возвращаемых товаров.

Перечисления
LATE_VALUES_UNSPECIFIED Никаких ограничений на поздние значения подачи не указано.
LATE_ONLY Возвращает данные StudentSubmissions, где значение «Поздно» верно.
NOT_LATE_ONLY Возвращает данные StudentSubmissions, где значение late — ложное.