Registra um novo usuário com e-mail e senha ou um usuário anônimo ou faz upgrade de um usuário anônimo para um usuário com e-mail e senha. Para uma solicitação de administrador com uma credencial do Google OAuth 2.0 com as permissões adequadas, cria um novo usuário anônimo, de e-mail e senha ou de número de telefone.
Uma chave de API é necessária na solicitação para identificar o projeto do Google Cloud.
Solicitação HTTP
POST https://identitytoolkit.googleapis.com/v1/accounts:signUp
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "email": string, "password": string, "displayName": string, "captchaChallenge": string, "captchaResponse": string, "instanceId": string, "idToken": string, "emailVerified": boolean, "photoUrl": string, "disabled": boolean, "localId": string, "phoneNumber": string, "tenantId": string, "targetProjectId": string, "mfaInfo": [ { object ( |
Campos | |
---|---|
email |
O e-mail a ser atribuído ao usuário criado. O e-mail precisa ter menos de 256 caracteres e estar no formato |
password |
A senha a ser atribuída ao usuário criado. A senha precisa ter pelo menos seis caracteres. Se definido, o campo |
displayName |
O nome de exibição do usuário a ser criado. |
captchaChallenge |
|
captchaResponse |
O token reCAPTCHA fornecido pela integração do reCAPTCHA no lado do cliente. O reCAPTCHA Enterprise o usa para avaliação. Obrigatório quando o reCAPTCHA Enterprise está ativado. |
instanceId |
|
idToken |
Um token de ID válido para um usuário do Identity Platform. Se definido, essa solicitação vai vincular a credencial de autenticação ao usuário representado por esse token de ID. Para uma solicitação que não seja de administrador, os campos |
emailVerified |
Indica se o e-mail do usuário foi verificado. A especificação desse campo exige uma credencial do Google OAuth 2.0 com as permissões adequadas. |
photoUrl |
O URL da foto do perfil do usuário a ser criado. |
disabled |
Indica se o usuário será desativado após a criação. As contas desativadas ficam inacessíveis, exceto para solicitações com uma credencial do Google OAuth2 com as permissões adequadas. |
localId |
O ID do usuário a ser criado. O ID precisa ser exclusivo no projeto em que o usuário está sendo criado. A especificação desse campo exige uma credencial do Google OAuth 2.0 com as permissões adequadas. |
phoneNumber |
O número de telefone do usuário a ser criado. A especificação desse campo exige uma credencial do Google OAuth 2.0 com as permissões adequadas. |
tenantId |
O ID do locatário do Identity Platform para criar um usuário. Se não for definido, o usuário será criado no projeto padrão do Identity Platform. |
targetProjectId |
O ID do projeto ao qual o usuário precisa pertencer. A especificação desse campo exige uma credencial do Google OAuth 2.0 com as permissões adequadas. Se não for definido, o projeto de destino será inferido do escopo associado ao token de acesso Bearer. |
mfaInfo[] |
Os provedores de autenticação multifator que o usuário vai criar. |
clientType |
O tipo de cliente: Web, Android ou iOS. Obrigatório ao ativar a proteção do reCAPTCHA Enterprise. |
recaptchaVersion |
A versão do reCAPTCHA do token reCAPTCHA no captchaResponse. |
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de SignUpResponse
.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/identitytoolkit
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte Authentication Overview.