Creazione di Dynamic Links con l'API REST

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

https://example.page.link/WXYZ

Gli Short Dynamic Links creati con l'API e l'SDK client (Android/Apple) non vengono visualizzati nella console Firebase. Questi Dynamic Links sono destinati alla condivisione tra utenti. Per i casi d'uso di marketing, continua a creare i link direttamente tramite la pagina Dynamic Links della console Firebase.

Prima di iniziare

  1. Ottieni la chiave API. Per autenticare le richieste all'API, è necessaria una chiave API. Per trovare la chiave API:
    1. Apri la pagina Impostazioni della console Firebase. Se ti viene chiesto 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 Dynamic Links.

  3. Se non hai ancora accettato i Termini di servizio e impostato un dominio per Dynamic Links, fallo quando richiesto.

    Se hai già un dominio Dynamic Links, prendine nota. Devi fornire un dominio Dynamic Links quando crei Dynamic Links in modo programmatico.

Puoi utilizzare l'API Firebase Dynamic Links per abbreviare un Dynamic Link lungo. Per farlo, invia una richiesta POST HTTP all'endpoint shortLinks, specificando il valore Dynamic Link lungo nel parametro longDynamicLink. Ad 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 Crea manualmente un URL per scoprire come creare Dynamic Links lunghi.

Puoi anche creare un Dynamic Link breve specificando i parametri Dynamic Link direttamente. Per farlo, invia una richiesta POST HTTP all'endpoint shortLinks, specificando i parametri Dynamic Link nel parametro dynamicLinkInfo. Ad 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, consulta il Riferimento API.

Imposta la durata di uno Short Dynamic Link

Puoi anche impostare il parametro suffix per specificare come viene generato il componente del percorso dello Dynamic Link 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

Queste stringhe vengono create mediante la codifica base62 di numeri a 96 bit generati in modo casuale. Utilizza questa impostazione per impedire che gli URL di Dynamic Links vengano indovinati e sottoposti a scansione, il che potrebbe esporre informazioni sensibili a destinatari non previsti.

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

https://example.page.link/WXYZ

Utilizza questo metodo se le informazioni sensibili non verrebbero esposte se un URL Dynamic Link breve venisse indovinato.

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 deep link fornito deve iniziare con gli schemi http:// o https://. Deve inoltre corrispondere a qualsiasi lista consentita di pattern URL inserita nella console. In caso contrario, l'API di creazione non andrà a buon fine con il codice di errore HTTP 400.

Passaggi successivi

Ora che hai creato Dynamic Links, devi configurare la tua app in modo che riceva Dynamic Links e indirizzi gli utenti alla sezione corretta della tua app dopo che li hanno aperti.

Per ricevere Dynamic Links 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.