Method: courses.create

Создаёт курс.

Пользователь, указанный в ownerId является владельцем созданного курса и добавлен в качестве преподавателя. Пользователь, не являющийся администратором и не имеющий запроса на создание курса, может создать курс, указав в качестве владельца только себя. Администраторы домена могут создавать курсы, принадлежащие любому пользователю в их домене.

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

  • PERMISSION_DENIED если пользователю, запрашивающему доступ, не разрешено создавать курсы, или если возникают ошибки доступа .
  • NOT_FOUND , если основной преподаватель не является действительным пользователем.
  • FAILED_PRECONDITION , если учетная запись владельца курса отключена или при возникновении следующих ошибок запроса :
    • Пользователь не может владеть курсом
    • Достигнут лимит членства в группах пользователей
    • CourseTitleCannotContainUrl
  • Если в id был указан псевдоним, он уже существует, и ALREADY_EXISTS .

HTTP-запрос

POST https://classroom.googleapis.com/v1/courses

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

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

Параметры
previewVersion

enum ( PreviewVersion )

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

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

В теле запроса содержится экземпляр класса Course .

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

В случае успеха тело ответа будет содержать вновь созданный экземпляр объекта Course .

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/classroom.courses

Для получения более подробной информации см. руководство по авторизации .