- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
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 |
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
|
tenantId |
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 ( |
Campi | |
---|---|
idToken |
Un token ID Identity Platform valido. Obbligatorio quando si tenta di modificare le informazioni relative all'utente. |
localId |
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 |
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 |
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 |
password |
La nuova password dell'utente da aggiornare negli attributi dell'account. La password deve contenere almeno 6 caratteri. |
provider[] |
Gli Identity Provider a cui deve essere associato l'account. |
oobCode |
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 |
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 |
Indica se l'account deve essere limitato all'utilizzo solo dell'accesso federato. |
captchaChallenge |
|
captchaResponse |
La risposta alla verifica reCAPTCHA. Questo è necessario quando il sistema rileva possibili attività illecite. |
validSince |
Specifica il timestamp minimo in secondi affinché un token ID di Identity Platform sia considerato valido. |
disableUser |
Se true, l'account viene contrassegnato come disattivato, il che significa che l'utente non potrà più accedere. |
instanceId |
|
delegatedProjectNumber |
|
photoUrl |
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[] |
|
returnSecureToken |
Se restituire o meno un ID e un token di aggiornamento. Deve sempre essere true. |
deleteProvider[] |
Gli Identity Provider da scollegare dall'account dell'utente. |
lastLoginAt |
Il timestamp in millisecondi dell'ultimo accesso all'account. |
createdAt |
Il timestamp in millisecondi della creazione dell'account. |
phoneNumber |
Il numero di telefono da aggiornare negli attributi dell'account. |
customAttributes |
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 |
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. |
linkProviderUserInfo |
Il fornitore da collegare all'account dell'utente. 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.