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 link dinamico lungo o un oggetto contenente i parametri del link dinamico e restituisce un URL come il seguente esempio:Dynamic LinkDynamic Link

https://example.page.link/WXYZ

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

Prima di iniziare

  1. Visualizza la chiave API. Avrai bisogno di una chiave API per autenticare le richieste all'API. Per trovare la chiave API:
    1. Apri la pagina Impostazioni della Firebase console. 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 i tuoi Dynamic Links, fallo quando ti viene richiesto.

    Se hai già un dominio Dynamic Links, prendine nota. Devi fornire un Dynamic Links dominio quando crei Dynamic Links a livello di programmazione.

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

Puoi anche creare un link dinamico breve specificando direttamente i parametri del link dinamico.Puoi anche creare un breve Dynamic Link specificando direttamente i parametri Dynamic Link . Per farlo, invia una richiesta POST HTTP all'shortLinks endpoint, specificando i Dynamic Link parametri nel dynamicLinkInfo parametro. 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 lunghezza di un breve Dynamic Link

Puoi anche impostare il parametro suffix per specificare come viene generato il componente del percorso del link dinamico breve Dynamic Link.

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

https://example.page.link/UVWXYZuvwxyz12345

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

Se imposti il parametro su "SHORT", il componente del percorso sarà una stringa che è 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 breve Dynamic Link venisse indovinato.

Il seguente esempio 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 tutti i pattern URL della whitelist inseriti nella console. In caso contrario, l'API di creazione non andrà a buon fine e verrà restituito il 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 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 viene superato questo limite, la risposta restituirà il codice di errore HTTP 429. Per richiedere una quota maggiore, compila questo modulo.