Você pode criar links dinâmicos curtos com a API REST do Firebase Dynamic Links. Esta API aceita um link dinâmico longo ou um objeto contendo parâmetros de link dinâmico e retorna um URL como o exemplo a seguir:
https://example.page.link/WXYZ
Links dinâmicos curtos criados com a API e o SDK do cliente (Android/Apple) não aparecem no console do Firebase. Esses links dinâmicos destinam-se ao compartilhamento entre usuários. Para casos de uso de marketing, continue criando seus links diretamente na página Dynamic Links do Firebase console.
Antes de você começar
- Obtenha sua chave de API. Você precisará de uma chave de API para autenticar suas solicitações na API. Para encontrar sua chave de API:
- Abra a página Configurações do console do Firebase. Se você for solicitado a escolher um projeto, selecione seu projeto do Firebase no menu.
- Anote o valor do campo Chave da API da Web .
- No console do Firebase, abra a seção Dynamic Links .
Se você ainda não aceitou os termos de serviço e definiu um domínio para seus Dynamic Links, faça-o quando solicitado.
Se você já possui um domínio Dynamic Links, anote-o. Você precisa fornecer um domínio Dynamic Links ao criar Dynamic Links programaticamente.
Criando um link dinâmico curto
Crie um link curto a partir de um link longo
Você pode usar a API Firebase Dynamic Links para encurtar um link dinâmico longo. Para fazer isso, faça uma solicitação HTTP POST para o endpoint shortLinks , especificando o link dinâmico longo no parâmetro longDynamicLink . Por exemplo:
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"
}
Consulte Construir manualmente um URL para saber como criar links dinâmicos longos.
Crie um link curto a partir dos parâmetros
Você também pode criar um link dinâmico curto especificando diretamente os parâmetros do link dinâmico. Para fazer isso, faça uma solicitação HTTP POST para o endpoint shortLinks , especificando os parâmetros Dynamic Link no parâmetro dynamicLinkInfo . Por exemplo:
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 obter uma especificação completa do objeto dynamicLinkInfo , consulte a referência da API .
Defina a duração de um link dinâmico curto
Você também pode definir o parâmetro suffix para especificar como o componente de caminho do link dinâmico curto é gerado.
Por padrão, ou se você definir o parâmetro como "UNGUESSABLE" , o componente do caminho será uma sequência de 17 caracteres, como no exemplo a seguir:
https://example.page.link/UVWXYZuvwxyz12345
Essas strings são criadas pela codificação base62 de números de 96 bits gerados aleatoriamente. Use esta configuração para evitar que seus URLs de links dinâmicos sejam adivinhados e rastreados, o que pode expor informações confidenciais a destinatários não intencionais.
Se você definir o parâmetro como "SHORT" , o componente do caminho será uma string com o comprimento necessário para ser exclusivo, com comprimento mínimo de 4 caracteres.
https://example.page.link/WXYZ
Use este método se informações confidenciais não seriam expostas se um URL curto de link dinâmico fosse adivinhado.
O exemplo a seguir mostra como você pode definir o 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"
}
}
Certifique-se de que o link direto seja válido
No mínimo, o valor do link direto fornecido deve começar com os esquemas http:// ou https://. Ele também deve corresponder a qualquer lista de permissões de padrões de URL inserida no console. Caso contrário, a API de criação falhará com o código de erro HTTP 400.
Próximos passos
Agora que você criou Dynamic Links, você precisa configurar seu aplicativo para receber Dynamic Links e enviar os usuários ao lugar certo em seu aplicativo depois que um usuário os abrir.
Para receber links dinâmicos em seu aplicativo, consulte a documentação para iOS , Android , C++ e Unity .
As solicitações são limitadas a 5 solicitações/endereço IP/segundo e 200.000 solicitações/dia. Se for excedido, a resposta retornará o código de erro HTTP 429. Para solicitar mais cota, preencha este formulário .