Method: projects.tenants.accounts.update

Aggiorna le informazioni relative all'account dell'utente specificato impostando campi specifici o applicando codici di azione. Sono supportate le richieste di amministratori e utenti finali.

Richiesta HTTP

POST https://identitytoolkit.googleapis.com/v1/projects/{targetProjectId}/tenants/{tenantId}/accounts:update

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
targetProjectId

string

L'ID del progetto a cui appartiene l'account. La specifica di questo campo richiede le credenziali OAuth 2.0 di Google con le autorizzazioni appropriate. Le richieste degli utenti finali devono invece passare un token ID di Identity Platform.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata targetProjectId:

  • firebaseauth.users.update
tenantId

string

L'ID del tenant di Identity Platform a cui appartiene l'account. Le richieste degli utenti finali devono passare un token ID di Identity Platform anziché impostare questo campo.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "idToken": string,
  "localId": string,
  "displayName": string,
  "email": string,
  "password": string,
  "provider": [
    string
  ],
  "oobCode": string,
  "emailVerified": boolean,
  "upgradeToFederatedLogin": boolean,
  "captchaChallenge": string,
  "captchaResponse": string,
  "validSince": string,
  "disableUser": boolean,
  "instanceId": string,
  "delegatedProjectNumber": string,
  "photoUrl": string,
  "deleteAttribute": [
    enum (UserAttributeName)
  ],
  "returnSecureToken": boolean,
  "deleteProvider": [
    string
  ],
  "lastLoginAt": string,
  "createdAt": string,
  "phoneNumber": string,
  "customAttributes": string,
  "mfa": {
    object (MfaInfo)
  },
  "linkProviderUserInfo": {
    object (ProviderUserInfo)
  }
}
Campi
idToken

string

Un token ID Identity Platform valido. Obbligatorio quando si tenta di modificare le informazioni relative all'utente.

localId

string

L'ID dell'utente. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate. Per le richieste degli utenti finali, deve essere passato un token ID.

displayName

string

Il nuovo nome visualizzato dell'utente da aggiornare negli attributi dell'account. La lunghezza del nome visualizzato deve essere inferiore o uguale a 256 caratteri.

email

string

Il nuovo indirizzo email dell'utente da aggiornare negli attributi dell'account. La lunghezza dell'email deve essere inferiore a 256 caratteri e nel formato name@domain.tld. L'email deve inoltre corrispondere alla produzione di addr-spec RFC 822. Se la protezione dell'enumerazione email è attivata, l'email non può essere modificata dall'utente senza prima verificarla, ma può essere modificata da un amministratore.

password

string

La nuova password dell'utente da aggiornare negli attributi dell'account. La password deve contenere almeno 6 caratteri.

provider[]

string

Gli Identity Provider a cui deve essere associato l'account.

oobCode

string

Il codice out-of-band da applicare all'account dell'utente. Sono supportati i seguenti tipi di codici out-of-band: * VERIFY_EMAIL * RECOVER_EMAIL * REVERT_SECOND_FACTOR_ADDITION * VERIFY_AND_CHANGE_EMAIL

emailVerified

boolean

Indica se l'indirizzo email dell'utente è stato verificato. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate.

upgradeToFederatedLogin

boolean

Indica se l'account deve essere limitato all'utilizzo solo dell'accesso federato.

captchaChallenge
(deprecated)

string

captchaResponse

string

La risposta alla verifica reCAPTCHA. Questo è necessario quando il sistema rileva possibili attività illecite.

validSince

string (int64 format)

Specifica il timestamp minimo in secondi affinché un token ID di Identity Platform sia considerato valido.

disableUser

boolean

Se true, l'account viene contrassegnato come disattivato, il che significa che l'utente non potrà più accedere.

instanceId
(deprecated)

string

delegatedProjectNumber
(deprecated)

string (int64 format)

photoUrl

string

Il nuovo URL della foto dell'utente per la foto del profilo dell'account da aggiornare negli attributi dell'account. La lunghezza dell'URL deve essere inferiore o uguale a 2048 caratteri.

deleteAttribute[]

enum (UserAttributeName)

returnSecureToken

boolean

Se restituire o meno un ID e un token di aggiornamento. Deve sempre essere true.

deleteProvider[]

string

Gli Identity Provider da scollegare dall'account dell'utente.

lastLoginAt

string (int64 format)

Il timestamp in millisecondi dell'ultimo accesso all'account.

createdAt

string (int64 format)

Il timestamp in millisecondi della creazione dell'account.

phoneNumber

string

Il numero di telefono da aggiornare negli attributi dell'account.

customAttributes

string

Attributi personalizzati in formato JSON da memorizzare nel token ID di Identity Platform. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate.

mfa

object (MfaInfo)

Le informazioni relative all'autenticazione a più fattori da impostare nell'account dell'utente. Verranno sovrascritte eventuali informazioni precedenti relative all'autenticazione a più fattori nell'account. La specifica di questo campo richiede una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di SetAccountInfoResponse.

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.