Method: courses.students.create

Добавляет пользователя в качестве студента курса.

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

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

  • PERMISSION_DENIED , если запрашивающему пользователю не разрешено создавать студентов в этом курсе или из-за ошибок доступа .
  • NOT_FOUND если запрошенный идентификатор курса не существует.
  • FAILED_PRECONDITION , если учетная запись запрошенного пользователя отключена, для следующих ошибок запроса :
    • Курсемберлимитдостигнутый
    • КурсНетМодифицируемый
    • UserGroupsMembershipLimitReached
    • НеактивныйКурсеВладелец
  • ALREADY_EXISTS , если пользователь уже является студентом или преподавателем курса.

HTTP-запрос

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

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

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

Параметры
courseId

string

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

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

Параметры
enrollmentCode

string

Код регистрации курса, в котором будет создан студент. Этот код необходим, если userId соответствует запрашивающему пользователю; его можно опустить, если запрашивающий пользователь имеет административные разрешения на создание студентов для любого пользователя.

Тело запроса

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

Тело ответа

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

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

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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