Method: courses.courseWork.list

Возвращает список курсовой работы, которую запрашивающему разрешено просматривать.

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

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

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

HTTP-запрос

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

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

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

Параметры
courseId

string

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

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

Параметры
courseWorkStates[]

enum ( CourseWorkState )

Ограничение на рабочий статус для возврата. Возвращается только соответствующий курс CourseWork. Если не указано, возвращаются элементы с рабочим статусом PUBLISHED .

orderBy

string

Необязательный порядок сортировки результатов. Список полей, разделенных запятыми, с необязательным ключевым словом направления сортировки. Поддерживаемые поля: updateTime и dueDate . Поддерживаемые ключевые слова направления: asc и desc . Если не указано, updateTime desc является поведением по умолчанию. Примеры: dueDate asc,updateTime desc , updateTime,dueDate desc

pageSize

integer

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

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

pageToken

string

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

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

previewVersion

enum ( PreviewVersion )

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

Тело запроса

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

Тело ответа

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

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

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

object ( CourseWork )

Элементы курсовой работы, соответствующие запросу.

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

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