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 il seguente esempio:

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 il tuo Dynamic Links, fallo quando ti viene 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 HTTP POST all'endpoint shortLinks, specificando il valore Dynamic Link 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 la sezione Creare manualmente un URL per scoprire come creare Dynamic Links lunghi.

Puoi anche creare uno Short Dynamic Link specificando direttamente i parametri Dynamic Link. Per farlo, invia una richiesta HTTP POST 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.

Impostare la durata di uno Short Dynamic Link

Puoi anche impostare il parametro suffix per specificare come viene generato il componente del percorso dell'Dynamic Link.

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 i tuoi URL Dynamic Links vengano indovinati e sottoposti a scansione, il che può potenzialmente esporre informazioni sensibili a destinatari non intenzionali.

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

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 link diretto fornito deve iniziare con gli schemi http:// o https://. Deve inoltre corrispondere a qualsiasi whitelist di pattern URL inserita nella console. In caso contrario, l'API di creazione genererà un errore con codice di errore HTTP 400.

Passaggi successivi

Ora che hai creato Dynamic Links, devi configurare l'app per ricevere Dynamic Links e indirizzare gli utenti al posto giusto nell'app dopo che l'hanno aperta.

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 viene superato, la risposta restituirà il codice di errore HTTP 429. Per richiedere più quota, compila questo modulo.