Method: courses.students.create

Adiciona um usuário como estudante de um curso.

Os administradores de domínio podem adicionar diretamente usuários no domínio como estudantes em cursos do domínio. Os estudantes podem se inscrever em um curso usando um código de inscrição.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED se o usuário solicitante não tiver permissão para criar estudantes neste curso ou por erros de acesso.
  • NOT_FOUND se o ID do curso solicitado não existir.
  • FAILED_PRECONDITION se a conta do usuário solicitado estiver desativada, para os seguintes erros de solicitação:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS se o usuário já for estudante ou professor no curso.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
courseId

string

Identificador do curso em que o estudante será criado. Esse identificador pode ser o atribuído pelo Google Sala de Aula ou um alias.

Parâmetros de consulta

Parâmetros
enrollmentCode

string

Código de inscrição do curso em que o estudante será criado. Esse código é necessário se userId corresponder ao usuário solicitante. Ele pode ser omitido se o usuário solicitante tiver permissões administrativas para criar estudantes para qualquer usuário.

Corpo da solicitação

O corpo da solicitação contém uma instância de Student.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Student.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o guia de autorização.