Method: invitations.create

Cria um convite. Só é possível ter uma única convocação para um usuário e curso por vez. Exclua e recrie um convite para fazer mudanças.

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

  • PERMISSION_DENIED se o usuário solicitante não tiver permissão para criar convites para este curso ou por erros de acesso.
  • NOT_FOUND se o curso ou o usuário não existir.
  • FAILED_PRECONDITION:
    • se a conta do usuário solicitado estiver desativada.
    • se o usuário já tiver essa função ou uma função com permissões maiores.
    • para os seguintes erros de solicitação:
      • IneligibleOwner
  • ALREADY_EXISTS se já houver um convite para o usuário e o curso especificados.

Solicitação HTTP

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

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

Corpo da solicitação

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

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

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