Method: accounts.signInWithCustomToken

Consente a un utente di accedere o registrarsi scambiando un token di autenticazione personalizzato. Dopo l'accesso o la registrazione, all'utente vengono emessi un nuovo token ID e un token di aggiornamento di Identity Platform.

Per identificare il progetto Google Cloud, nella richiesta è obbligatoria una chiave API.

Richiesta HTTP

POST https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "token": string,
  "instanceId": string,
  "returnSecureToken": boolean,
  "delegatedProjectNumber": string,
  "tenantId": string
}
Campi
token

string

Obbligatorio. Il token di autenticazione personalizzato rivendicato dallo sviluppatore. Il token deve essere un token web JSON (JWT) che includa le attestazioni elencate nel riferimento API nella sezione "Attestazioni token personalizzate".
instanceId
(deprecated)

string
returnSecureToken

boolean

Deve sempre essere true.
delegatedProjectNumber
(deprecated)

string (int64 format)
tenantId

string

L'ID del tenant Identity Platform a cui l'utente sta accedendo. Se presente, l'ID deve corrispondere a tenantId nel token.

Corpo della risposta

Messaggio di risposta per accounts.signInWithCustomToken.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "kind": string,
  "idToken": string,
  "refreshToken": string,
  "expiresIn": string,
  "isNewUser": boolean
}
Campi
kind
(deprecated)

string
idToken

string

Un token ID Identity Platform per l'utente autenticato.
refreshToken

string

Un token di aggiornamento di Identity Platform per l'utente autenticato.
expiresIn

string (int64 format)

Il numero di secondi che rimangono prima della scadenza del token ID.
isNewUser

boolean

Indica se l'utente autenticato è stato creato da questa richiesta.

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.