Twórz dynamiczne linki za pomocą REST API

Możesz tworzyć krótkie linki dynamiczne za pomocą interfejsu API REST Firebase Dynamic Links. Ten interfejs API akceptuje długi link dynamiczny lub obiekt zawierający parametry linku dynamicznego i zwraca adres URL, jak w poniższym przykładzie:

https://example.page.link/WXYZ

Krótkie linki dynamiczne utworzone za pomocą interfejsu API i pakietu SDK klienta (Android/Apple) nie pojawiają się w konsoli Firebase. Takie łącza dynamiczne są przeznaczone do udostępniania między użytkownikami. W przypadku zastosowań marketingowych kontynuuj tworzenie linków bezpośrednio na stronie Linki dynamiczne w konsoli Firebase.

Zanim zaczniesz

Zdobądź swój klucz API. Będziesz potrzebować klucza API, aby uwierzytelnić swoje żądania w API. Aby znaleźć swój klucz API:
1. Otwórz stronę Ustawienia konsoli Firebase. Jeśli pojawi się prośba o wybranie projektu, wybierz swój projekt Firebase z menu.
2. Zanotuj wartość pola Web API Key .
W konsoli Firebase otwórz sekcję Linki dynamiczne .
Jeśli jeszcze nie zaakceptowałeś warunków korzystania z usługi i nie ustawiłeś domeny dla swoich Linków dynamicznych, zrób to po wyświetleniu monitu.
Jeśli masz już domenę z linkami dynamicznymi, zanotuj to. Podczas programowego tworzenia linków dynamicznych musisz podać domenę linków dynamicznych.

Tworzenie krótkiego łącza dynamicznego

Utwórz krótki link z długiego linku

Możesz użyć Firebase Dynamic Links API, aby skrócić długi link dynamiczny. Aby to zrobić, wyślij żądanie HTTP POST do punktu końcowego shortLinks , określając długie łącze dynamiczne w parametrze longDynamicLink . Na przykład:

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"
}

Zobacz Ręczne tworzenie adresu URL , aby dowiedzieć się, jak tworzyć długie łącza dynamiczne.

Utwórz krótki link z parametrów

Możesz także utworzyć krótkie łącze dynamiczne, określając bezpośrednio parametry łącza dynamicznego. Aby to zrobić, wyślij żądanie HTTP POST do punktu końcowego shortLinks , określając parametry łącza dynamicznego w parametrze dynamicLinkInfo . Na przykład:

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"
    }
  }
}

Pełną specyfikację obiektu dynamicLinkInfo zawiera dokumentacja interfejsu API .

Ustaw długość krótkiego łącza dynamicznego

Można również ustawić parametr suffix , aby określić sposób generowania składnika ścieżki krótkiego łącza dynamicznego.

Domyślnie lub jeśli ustawisz parametr na "UNGUESSABLE" , komponent ścieżki będzie ciągiem 17 znaków, tak jak w poniższym przykładzie:

https://example.page.link/UVWXYZuvwxyz12345

Takie ciągi są tworzone przez kodowanie base62 losowo generowanych liczb 96-bitowych. Użyj tego ustawienia, aby uniemożliwić odgadywanie i indeksowanie adresów URL linków dynamicznych, co może potencjalnie ujawnić poufne informacje niepożądanym odbiorcom.

Jeśli ustawisz parametr na "SHORT" , komponent ścieżki będzie ciągiem, który będzie miał długość minimalną 4 znaków.

https://example.page.link/WXYZ

Tej metody należy użyć, jeśli poufne informacje nie zostałyby ujawnione w przypadku odgadnięcia krótkiego adresu URL łącza dynamicznego.

Poniższy przykład pokazuje, jak ustawić parametr 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"
   }
}

Upewnij się, że precyzyjny link jest prawidłowy

Podana wartość precyzyjnego linku musi zaczynać się od schematu http:// lub https://. Musi też pasować do dowolnej białej listy wzorców adresów URL wprowadzonej w konsoli. W przeciwnym razie interfejs API tworzenia zakończy się niepowodzeniem z kodem błędu HTTP 400.

Następne kroki

Po utworzeniu linków dynamicznych musisz skonfigurować aplikację tak, aby odbierała linki dynamiczne i odsyłała użytkowników we właściwe miejsce w aplikacji po ich otwarciu przez użytkownika.

Aby otrzymywać linki dynamiczne w swojej aplikacji, zapoznaj się z dokumentacją dla systemów iOS , Android , C++ i Unity .

Żądania są ograniczone do 5 żądań/adres IP/sekundę i 200 000 żądań/dzień. Jeśli zostanie przekroczony, odpowiedź zwróci kod błędu HTTP 429. Aby poprosić o zwiększenie limitu, wypełnij ten formularz .