Method: projects.tenants.accounts

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}/tenants/{tenantId}/accounts

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
targetProjectId

string

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.

tenantId

string

L'ID del tenant di Identity Platform in cui creare un utente. Se non è impostato, l'utente verrà creato nel progetto Identity Platform predefinito.

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,
  "mfaInfo": [
    {
      object (MfaFactor)
    }
  ],
  "clientType": enum (ClientType),
  "recaptchaVersion": enum (RecaptchaVersion)
}
Campi
email

string

L'indirizzo email da assegnare all'utente creato. La lunghezza dell'email deve essere inferiore a 256 caratteri e deve essere nel formato name@domain.tld. L'email deve inoltre corrispondere alla produzione di addr-spec RFC 822. Se non viene fornito, verrà creato un utente anonimo.

password

string

La password da assegnare all'utente creato. La password deve contenere almeno 6 caratteri. Se impostato, deve essere impostato anche il campo email.

displayName

string

Il nome visualizzato dell'utente da creare.

captchaChallenge
(deprecated)

string

captchaResponse

string

Il token reCAPTCHA fornito dall'integrazione lato client di reCAPTCHA. reCAPTCHA Enterprise lo utilizza per la valutazione. Obbligatorio se reCAPTCHA Enterprise è attivato.

instanceId
(deprecated)

string

idToken

string

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 email e password. Per una richiesta di amministrazione, localId non deve essere impostato.

emailVerified

boolean

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

string

L'URL della foto del profilo dell'utente da creare.

disabled

boolean

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

string

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

string

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.

mfaInfo[]

object (MfaFactor)

I provider di autenticazione a più fattori da creare dall'utente.

clientType

enum (ClientType)

Il tipo di client: web, Android o iOS. Obbligatorio per attivare la protezione reCAPTCHA Enterprise.

recaptchaVersion

enum (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.