Crea collegamenti dinamici con l'API REST

Puoi creare brevi collegamenti dinamici con l'API REST Firebase Dynamic Links. Questa API accetta un collegamento dinamico lungo o un oggetto contenente parametri di collegamento dinamico e restituisce un URL come nell'esempio seguente:

https://example.page.link/WXYZ

I collegamenti dinamici brevi creati con l'API e l'SDK del client (Android/Apple) non vengono visualizzati nella console Firebase. Tali collegamenti dinamici sono destinati alla condivisione da utente a utente. Per i casi d'uso di marketing, continua a creare i tuoi collegamenti direttamente tramite la pagina Collegamenti dinamici della console Firebase.

Prima di iniziare

  1. Ottieni la tua chiave API. Avrai bisogno di una chiave API per autenticare le tue richieste all'API. Per trovare la chiave API:
    1. Apri la pagina Impostazioni della console Firebase. Se ti viene richiesto di scegliere un progetto, seleziona il tuo progetto Firebase dal menu.
    2. Prendi nota del valore del campo Chiave API Web .
  2. Nella console Firebase, apri la sezione Collegamenti dinamici .
  3. Se non hai già accettato i termini di servizio e impostato un dominio per i tuoi collegamenti dinamici, fallo quando richiesto.

    Se possiedi già un dominio Dynamic Links, prendine nota. È necessario fornire un dominio Dynamic Links quando crei Dynamic Links a livello di codice.

Puoi utilizzare l'API Firebase Dynamic Links per abbreviare un collegamento dinamico lungo. Per fare ciò, effettua una richiesta HTTP POST all'endpoint shortLinks , specificando il collegamento dinamico lungo nel parametro longDynamicLink . Per esempio:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

Consulta Costruire manualmente un URL per scoprire come creare collegamenti dinamici lunghi.

È inoltre possibile creare un breve collegamento dinamico specificando direttamente i parametri del collegamento dinamico. Per fare ciò, effettua una richiesta HTTP POST all'endpoint shortLinks , specificando i parametri Dynamic Link nel parametro dynamicLinkInfo . Per esempio:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

Per una specifica completa dell'oggetto dynamicLinkInfo , vedere il riferimento API .

Imposta la lunghezza di un breve collegamento dinamico

È inoltre possibile impostare il parametro suffix per specificare come viene generato il componente del percorso del collegamento dinamico breve.

Per impostazione predefinita, o se imposti il ​​parametro su "UNGUESSABLE" , il componente del percorso sarà una stringa di 17 caratteri, come nell'esempio seguente:

https://example.page.link/UVWXYZuvwxyz12345

Tali stringhe vengono create mediante codifica base62 di numeri a 96 bit generati casualmente. Utilizza questa impostazione per impedire che gli URL dei collegamenti dinamici vengano indovinati e sottoposti a scansione, il che potrebbe potenzialmente esporre informazioni sensibili a destinatari non desiderati.

Se imposti il ​​parametro su "SHORT" , il componente del percorso sarà una stringa lunga solo quanto necessario per essere univoca, con una lunghezza minima di 4 caratteri.

https://example.page.link/WXYZ

Utilizzare questo metodo se le informazioni sensibili non verrebbero esposte se si indovinasse un breve URL di collegamento dinamico.

L'esempio seguente mostra come impostare il parametro suffix :

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

Come minimo, il valore del collegamento diretto fornito deve iniziare con gli schemi http:// o https://. Deve inoltre corrispondere a qualsiasi whitelist di pattern URL immessa nella console. Altrimenti, l'API di creazione fallirà con il codice di errore HTTP 400.

Prossimi passi

Ora che hai creato i collegamenti dinamici, devi configurare la tua app per ricevere i collegamenti dinamici e indirizzare gli utenti alla posizione corretta nell'app dopo che un utente li ha aperti.

Per ricevere collegamenti dinamici nella tua app, consulta la documentazione per iOS , Android , C++ e Unity .

Le richieste sono limitate a 5 richieste/indirizzo IP/secondo e 200.000 richieste/giorno. Se superato, la risposta restituirà il codice di errore HTTP 429. Per richiedere una quota maggiore, compila questo modulo .