- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Registra un nuovo utente con email e password o un utente anonimo oppure esegue l'upgrade di un utente anonimo a utente con email e password. Per una richiesta di amministratore con una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate, crea un nuovo utente anonimo, con indirizzo email e password o numero di telefono.
Per identificare il progetto Google Cloud, nella richiesta è obbligatoria una chiave API.
Richiesta HTTP
POST https://identitytoolkit.googleapis.com/v1/projects/{targetProjectId}/accounts
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
targetProjectId |
L'ID del progetto a cui deve appartenere l'utente. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate. Se non è impostato, il progetto di destinazione viene dedotto dall'ambito associato al token di accesso con autorizzazione. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione 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, "mfaInfo": [ { object ( |
Campi | |
---|---|
email |
L'indirizzo email da assegnare all'utente creato. La lunghezza dell'email deve essere inferiore a 256 caratteri e deve essere nel formato |
password |
La password da assegnare all'utente creato. La password deve contenere almeno 6 caratteri. Se impostato, deve essere impostato anche il campo |
displayName |
Il nome visualizzato dell'utente da creare. |
captchaChallenge |
|
captchaResponse |
Il token reCAPTCHA fornito dall'integrazione lato client di reCAPTCHA. reCAPTCHA Enterprise lo utilizza per la valutazione. Obbligatorio se reCAPTCHA Enterprise è attivato. |
instanceId |
|
idToken |
Un token ID valido per un utente di Identity Platform. Se impostato, questa richiesta collegherà la credenziale di autenticazione all'utente rappresentato da questo token ID. Per una richiesta non di amministratore, devono essere impostati entrambi i campi |
emailVerified |
Indica se l'indirizzo email dell'utente è verificato. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate. |
photoUrl |
L'URL della foto del profilo dell'utente da creare. |
disabled |
Indica se l'utente verrà disattivato al momento della creazione. Gli account disattivati non sono accessibili, ad eccezione delle richieste che contengono una credenziale OAuth2 di Google con le autorizzazioni appropriate. |
localId |
L'ID dell'utente da creare. L'ID deve essere univoco all'interno del progetto in cui viene creato l'utente. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate. |
phoneNumber |
Il numero di telefono dell'utente da creare. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate. |
tenantId |
L'ID del tenant di Identity Platform in cui creare un utente. Se non è impostato, l'utente verrà creato nel progetto Identity Platform predefinito. |
mfaInfo[] |
I provider di autenticazione a più fattori da creare dall'utente. |
clientType |
Il tipo di client: web, Android o iOS. Obbligatorio per attivare la protezione reCAPTCHA Enterprise. |
recaptchaVersion |
La versione reCAPTCHA del token reCAPTCHA in captchaResponse. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di SignUpResponse
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/identitytoolkit
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la sezione Authentication Overview.