Method: getProjects

Recupera la configurazione pubblica di Identity Toolkit di un progetto. (Legacy) Questo metodo supporta anche le chiamate autenticate da uno sviluppatore per recuperare la configurazione non pubblica.

Richiesta HTTP

GET https://identitytoolkit.googleapis.com/v1/projects

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
delegatedProjectNumber

string (int64 format)

Numero del progetto della richiesta di progetto delegata. Questo campo deve essere utilizzato solo nell'ambito della migrazione a Firebase versione 1.

projectNumber

string (int64 format)

Numero del progetto della configurazione da recuperare. Questo campo è deprecato e non deve essere utilizzato dalle nuove integrazioni.

androidPackageName

string

Nome del pacchetto Android da confrontare con il nome del pacchetto Android reale. Se questo campo viene fornito e non viene fornito sha1_cert_hash, l'azione restituirà un errore se non corrisponde al nome del pacchetto Android reale.

iosBundleId

string

L'ID bundle iOS da confrontare con l'ID bundle iOS reale. Se viene fornito questo campo, l'azione restituirà un errore se non corrisponde all'ID bundle iOS reale.

clientId

string

L'ID client OAuth dell'RP. Se impostato, verrà eseguito un controllo per verificare che il client OAuth sia valido per il progetto recuperato e la richiesta rifiutata con un errore del client se non è valido.

sha1Cert

string

Hash del certificato dell'applicazione Android SHA-1. Se impostato, verrà eseguito un controllo per verificare che l'hash del certificato sia valido per il progetto e il nome del pacchetto Android recuperati.

firebaseAppId

string

L'ID app Firebase per le applicazioni che utilizzano Firebase. Puoi trovarlo nella Console Firebase del tuo progetto. Se impostato, verrà eseguito un controllo per verificare che l'ID app sia valido per il progetto recuperato. In caso contrario, la richiesta verrà rifiutata con un errore del client.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per v1.getProjects.

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

Rappresentazione JSON
{
  "projectId": string,
  "apiKey": string,
  "allowPasswordUser": boolean,
  "idpConfig": [
    {
      object (IdpConfig)
    }
  ],
  "authorizedDomains": [
    string
  ],
  "enableAnonymousUser": boolean,
  "dynamicLinksDomain": string,
  "useEmailSending": boolean,
  "resetPasswordTemplate": {
    object (EmailTemplate)
  },
  "verifyEmailTemplate": {
    object (EmailTemplate)
  },
  "changeEmailTemplate": {
    object (EmailTemplate)
  },
  "legacyResetPasswordTemplate": {
    object (EmailTemplate)
  },
  "revertSecondFactorAdditionTemplate": {
    object (EmailTemplate)
  }
}
Campi
projectId

string

L'ID progetto della configurazione recuperata.

apiKey

string

Chiave API Google Cloud. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

allowPasswordUser

boolean

Indica se consentire la registrazione dell'account con password. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

idpConfig[]

object (IdpConfig)

Configurazione del provider OAuth2. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

authorizedDomains[]

string

Domini autorizzati per il reindirizzamento dei widget.

enableAnonymousUser

boolean

Indica se l'utente anonimo è attivo. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

useEmailSending

boolean

Se utilizzare l'invio di email. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

resetPasswordTemplate

object (EmailTemplate)

Modello email per la reimpostazione della password. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

verifyEmailTemplate

object (EmailTemplate)

Modello email per l'email di verifica. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

changeEmailTemplate

object (EmailTemplate)

Modello di email per l'email di modifica. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

legacyResetPasswordTemplate

object (EmailTemplate)

Modello email di reimpostazione della password per l'app Firebase V1 precedente. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

revertSecondFactorAdditionTemplate

object (EmailTemplate)

Modello email per annullare le aggiunte del secondo fattore. Questo campo viene restituito solo per le chiamate autenticate da uno sviluppatore.

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.

IdpConfig

Configurazione di un provider di identità.

Rappresentazione JSON
{
  "provider": enum (Provider),
  "enabled": boolean,
  "experimentPercent": integer,
  "clientId": string,
  "secret": string,
  "whitelistedAudiences": [
    string
  ]
}
Campi
provider

enum (Provider)

enabled

boolean

True se consente all'utente di accedere con il provider.

experimentPercent

integer

Percentuale di utenti a cui verrà richiesto/reindirizzato l'accesso federato per questo IdP

clientId

string

ID client OAuth2.

secret

string

Client secret OAuth2.

whitelistedAudiences[]

string

ID client inseriti nella lista consentita per il controllo del segmento di pubblico.

Provider

Nome del provider di identità.

Enum
PROVIDER_UNSPECIFIED
MSLIVE Microsoft Live come provider di identità.
GOOGLE Google come provider di identità.
FACEBOOK Facebook come provider di identità.
PAYPAL PayPal come provider di identità.
TWITTER Twitter come provider di identità.
YAHOO Yahoo come provider di identità.
AOL AOL come provider di identità.
GITHUB GitHub come provider di identità.
GOOGLE_PLAY_GAMES Google Play Giochi come provider di identità.
LINKEDIN LinkedIn come provider di identità.
IOS_GAME_CENTER Game Center di iOS come provider di identità.

EmailTemplate

Modello email

Rappresentazione JSON
{
  "disabled": boolean,
  "from": string,
  "body": string,
  "subject": string,
  "fromDisplayName": string,
  "format": enum (EmailBodyFormat),
  "replyTo": string,
  "fromLocalPart": string,
  "locale": string,
  "customized": boolean
}
Campi
disabled

boolean

Indica se il modello è disattivato. Se il valore è true, verrà utilizzato un modello predefinito.

from

string

Indirizzo del mittente dell'email

body

string

Corpo dell'email

subject

string

Oggetto dell'email

fromDisplayName

string

Dal nome visualizzato

format

enum (EmailBodyFormat)

Formato del corpo dell'email

replyTo

string

Indirizzo per risposte

fromLocalPart

string

Parte locale dell'indirizzo mittente

locale

string

Il valore è nel formato del codice lingua III (ad es. "zh-CN", "es"). Sono accettati entrambi i separatori "-" e "_".

customized

boolean

Indica se il corpo o l'oggetto dell'email è personalizzato.

EmailBodyFormat

Formato del corpo dell'email

Enum
EMAIL_BODY_FORMAT_UNSPECIFIED Valore predefinito. Non utilizzare.
PLAINTEXT Il corpo dell'email è in formato di testo normale.
HTML Il corpo dell'email è in formato HTML.