Puoi utilizzare questa API REST per generare brevi collegamenti dinamici. Consulta la guida per sviluppatori per iniziare.
Richiesta HTTP
POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key Content-Type: application/json request_body
Richiedi corpo
Il corpo della richiesta è simile a uno dei seguenti, a seconda che si desideri specificare i parametri del collegamento dinamico come collegamento dinamico lungo o come oggetto JSON.
Per specificare i parametri del collegamento dinamico come collegamento dinamico lungo:
{
"longDynamicLink": string,
"suffix": {
"option": "SHORT" or "UNGUESSABLE"
}
}
Per specificare i parametri di collegamento dinamico come oggetto JSON:
{
"dynamicLinkInfo": {
"domainUriPrefix": string,
"link": string,
"androidInfo": {
"androidPackageName": string,
"androidFallbackLink": string,
"androidMinPackageVersionCode": string
},
"iosInfo": {
"iosBundleId": string,
"iosFallbackLink": string,
"iosCustomScheme": string,
"iosIpadFallbackLink": string,
"iosIpadBundleId": string,
"iosAppStoreId": string
},
"navigationInfo": {
"enableForcedRedirect": boolean,
},
"analyticsInfo": {
"googlePlayAnalytics": {
"utmSource": string,
"utmMedium": string,
"utmCampaign": string,
"utmTerm": string,
"utmContent": string
},
"itunesConnectAnalytics": {
"at": string,
"ct": string,
"mt": string,
"pt": string
}
},
"socialMetaTagInfo": {
"socialTitle": string,
"socialDescription": string,
"socialImageLink": string
}
},
"suffix": {
"option": "SHORT" or "UNGUESSABLE"
}
}
Parametri
Tutti i parametri sono facoltativi se non diversamente specificato.
Parametri generali | |
---|---|
dominioUriPrefix | Obbligatorio se non hai impostato un valore per il parametro longDynamicLink . Il dominio Dynamic Links del tuo progetto Firebase. Puoi trovare questo valore nella sezione Collegamenti dinamici della console Firebase . |
collegamento | Obbligatorio se non hai impostato un valore per il parametro longDynamicLink .Il collegamento che verrà aperto dall'app. Specifica un URL che la tua app può gestire, in genere il contenuto o il payload dell'app, che avvia la logica specifica dell'app (ad esempio accreditare all'utente un coupon o visualizzare una schermata di benvenuto). Questo collegamento deve essere un URL ben formattato, essere codificato correttamente nell'URL, utilizzare HTTP o HTTPS e non può essere un altro collegamento dinamico. |
suffisso | Specifica come creare il componente del percorso di un breve collegamento dinamico. Per impostazione predefinita, Firebase Dynamic Links genera suffissi di stringa di 17 caratteri. Imposta il parametro su Ometti questo parametro o imposta il parametro su |
Parametri Android | |
---|---|
androidPackageName | Il nome del pacchetto dell'app Android da utilizzare per aprire il collegamento. L'app deve essere connessa al tuo progetto dalla pagina Panoramica della console Firebase. Necessario affinché Dynamic Link apra un'app Android. |
androidFallbackLink | Il collegamento da aprire quando l'app non è installata. Specifica questa opzione per eseguire operazioni diverse dall'installazione dell'app dal Play Store quando l'app non è installata, ad esempio aprire la versione Web mobile dei contenuti o visualizzare una pagina promozionale per la tua app. |
androidMinPackageVersionCode | Il versionCode della versione minima della tua app che può aprire il collegamento. Se l'app installata è una versione precedente, l'utente viene indirizzato al Play Store per aggiornare l'app. |
parametri iOS | |
---|---|
iosBundleId | L'ID bundle dell'app iOS da utilizzare per aprire il collegamento. L'app deve essere connessa al tuo progetto dalla pagina Panoramica della console Firebase. Necessario affinché Dynamic Link apra un'app iOS. |
iosFallbackLink | Il collegamento da aprire quando l'app non è installata. Specifica questa opzione per eseguire operazioni diverse dall'installazione dell'app dall'App Store quando l'app non è installata, ad esempio aprire la versione Web mobile dei contenuti o visualizzare una pagina promozionale per la tua app. |
iosCustomScheme | Lo schema URL personalizzato della tua app, se definito come qualcosa di diverso dall'ID bundle della tua app |
iosIpadFallbackLink | Il collegamento da aprire sugli iPad quando l'app non è installata. Specificalo per fare qualcosa di diverso dall'installare la tua app dall'App Store quando l'app non è installata, ad esempio aprire la versione web del contenuto o visualizzare una pagina promozionale per la tua app. |
iosIpadBundleId | L'ID bundle dell'app iOS da utilizzare sugli iPad per aprire il collegamento. L'app deve essere connessa al tuo progetto dalla pagina Panoramica della console Firebase. |
iosAppStoreId | L'ID App Store della tua app, utilizzato per indirizzare gli utenti all'App Store quando l'app non è installata |
Parametri di navigazione | |
---|---|
abilitareReindirizzamentoForzato | Se impostato su "1", salta la pagina di anteprima dell'app quando viene aperto il collegamento dinamico e reindirizza invece all'app o allo store. La pagina di anteprima dell'app (abilitata per impostazione predefinita) può inviare in modo più affidabile gli utenti alla destinazione più appropriata quando aprono i collegamenti dinamici nelle app; tuttavia, se prevedi che un collegamento dinamico venga aperto solo nelle app che possono aprire i collegamenti dinamici in modo affidabile senza questa pagina, puoi disabilitarlo con questo parametro. Questo parametro influenzerà il comportamento del Dynamic Link solo su iOS. |
Parametri dei metatag sociali | |
---|---|
socialTitolo | Il titolo da utilizzare quando il collegamento dinamico viene condiviso in un post social. |
socialDescrizione | La descrizione da utilizzare quando il collegamento dinamico viene condiviso in un post social. |
socialImageLink | L'URL di un'immagine correlata a questo collegamento. |
Parametri di analisi | |
---|---|
utmSource utmMedio utmCampaign utmTerm utmContent | Parametri di analisi di Google Play. |
A ct mt punto | Parametri di analisi di iTunes Connect. |
Corpo della risposta
La risposta a una richiesta è un oggetto JSON come il seguente:
{
"shortLink": string,
"previewLink": string
}
Campi di risposta | |
---|---|
shortLink | Il breve collegamento dinamico generato. |
anteprimaLink | Un collegamento a un diagramma di flusso del comportamento del collegamento dinamico. |