Puedes crear Dynamic Links cortos con la API de REST de Firebase Dynamic Links. Esta API acepta un Dynamic Link largo o un objeto que contiene parámetros Dynamic Link y, luego, muestra una URL como el siguiente ejemplo:
https://example.page.link/WXYZ
El Dynamic Links corto creado con la API y el SDK del cliente (Android/Apple) no aparecen en la consola de Firebase. Estos Dynamic Links están diseñados para el uso compartido entre usuarios. Para casos de uso de marketing, sigue creando tus vínculos directamente a través de la página Dynamic Linksde la consola de Firebase.
Antes de comenzar
- Obtén tu clave de API. Necesitarás una clave de API para autenticar tus solicitudes a la API. Sigue estas instrucciones para encontrarla:
- Abre la página Configuración de la consola de Firebase. Si se te pide que selecciones un proyecto, elige tu proyecto de Firebase desde el menú.
- Anota el valor del campo clave de API web.
- En Firebase console, abre la sección Dynamic Links.
-
Si aún no aceptaste las Condiciones del Servicio ni configuraste un dominio para los Dynamic Links, deberás hacerlo cuando el sistema lo solicite.
Si ya creaste un dominio de Dynamic Links, anótalo. Debes proporcionar un dominio Dynamic Links cuando crees Dynamic Links de manera programática.
Crear un objeto Dynamic Link corto
Crea un vínculo corto a partir de uno largo
Puedes usar la API de Firebase Dynamic Links para acortar un Dynamic Link largo. Para hacerlo, realiza una solicitud HTTP POST al extremo shortLinks y especifica el Dynamic Link largo en el parámetro longDynamicLink. Por ejemplo:
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 Construye una URL manualmente para obtener información sobre cómo crear Dynamic Links largos.
Crea un vínculo corto a partir de parámetros
También puedes crear un Dynamic Link corto si especificas los parámetros de Dynamic Link directamente. Para hacerlo, realiza una solicitud HTTP POST al extremo shortLinks y especifica los parámetros Dynamic Link en el parámetro dynamicLinkInfo.
Por ejemplo:
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"
}
}
}
Para obtener una especificación completa del objeto dynamicLinkInfo, consulta la referencia de la API.
Establece la longitud de un Dynamic Link corto
También puedes establecer el parámetro suffix para especificar cómo se genera el componente de la ruta de acceso del Dynamic Link corto.
Según la configuración predeterminada o si configuras el parámetro como "UNGUESSABLE", el componente de la ruta de acceso será una string de 17 caracteres, como se muestra en el siguiente ejemplo:
https://example.page.link/UVWXYZuvwxyz12345
Estas strings se crean a partir de números de 96 bits generados al azar con codificación de base62. Usa esta configuración para impedir que puedan adivinarse y rastrearse las URLs de tus Dynamic Links, lo que podría exponer la información sensible ante destinatarios no deseados.
Si configuras el parámetro como "SHORT", el componente de la ruta de acceso será una string que tendrá solo la cantidad de caracteres necesaria para ser única, con una longitud mínima de 4 caracteres.
https://example.page.link/WXYZ
Usa este método si no hay riesgo de que se exponga información sensible si se adivina la URL de un Dynamic Link corto.
El siguiente ejemplo muestra cómo establecer el parámetro 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"
}
}
Asegúrate de que el vínculo directo sea válido
Como mínimo, el valor del vínculo directo proporcionado debe empezar con los esquemas http:// o https://. También debe coincidir con alguna lista de entidades permitidas de patrones de URL ingresada en la consola. De lo contrario, la API de creación fallará con el código de error HTTP 400.
Próximos pasos
Ahora que creaste Dynamic Links, debes configurar tu app para recibir Dynamic Links y enviar a los usuarios al lugar correcto de tu app después de que los abra.
Para recibir Dynamic Links en tu app, consulta la documentación de iOS, Android, C++ y Unity.
Las solicitudes se limitan a 5 solicitudes por dirección IP por segundo, y 200,000 solicitudes por día. Si se supera este límite, la respuesta mostrará el código de error HTTP 429. Para solicitar una cuota superior, completa este formulario.