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 .

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

Параметры
courseId

string

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

courseWorkId

string

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

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

Параметры
userId

string

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

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

enum ( SubmissionState )

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

late

enum ( LateValues )

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

pageSize

integer

Максимальное количество возвращаемых элементов. Ноль или неуказанное значение означает, что сервер может установить максимальное количество.

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

pageToken

string

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

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

previewVersion

enum ( PreviewVersion )

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

Текст запроса

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

Ответный текст

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

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

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

object ( StudentSubmission )

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

nextPageToken

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 там, где late — это истина.
NOT_LATE_ONLY Возвращает объект StudentSubmissions, если значение late равно false.