Method: courses.students.create

Adiciona um usuário como estudante de um curso.

Os administradores do domínio têm permissão para adicionar diretamente usuários no domínio como estudantes aos cursos do domínio. Os estudantes podem se adicionar a 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 alunos no curso ou devido a 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 aluno será criado. Esse identificador pode ser 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 aluno será criado. Esse código será necessário se userId corresponder ao usuário solicitante. Ele poderá ser omitido se o usuário solicitante tiver permissões administrativas para criar alunos 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 de 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.