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

Идентификатор курса. Этот идентификатор может быть либо идентификатором, присвоенным Классом, либо 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, где значение «Поздно» верно.
NOT_LATE_ONLY Возвращает данные StudentSubmissions, где значение late — ложное.