Twórz łącza dynamiczne za pomocą interfejsu API REST

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 łącza dynamicznego i zwraca adres URL podobny do poniższego przykładu:

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 Linki 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

  1. Zdobądź klucz API. Do uwierzytelnienia żądań w interfejsie API będziesz potrzebować klucza API. Aby znaleźć klucz API:
    1. Otwórz stronę Ustawienia w konsoli Firebase. Jeśli pojawi się monit o wybranie projektu, wybierz projekt Firebase z menu.
    2. Zanotuj wartość pola Klucz interfejsu API sieci Web .
  2. W konsoli Firebase otwórz sekcję Linki dynamiczne .
  3. Jeżeli nie zaakceptowałeś jeszcze 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ę Dynamic Links, zwróć na to uwagę. Podczas programowego tworzenia łączy dynamicznych musisz podać domenę łączy dynamicznych.

Możesz użyć interfejsu 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 linki dynamiczne.

Można także utworzyć krótkie łącze dynamiczne, określając bezpośrednio parametry łącza dynamicznego. W tym celu należy wysłać żą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 można znaleźć w dokumentacji API .

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

Można także 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-znakowym, tak jak w poniższym przykładzie:

https://example.page.link/UVWXYZuvwxyz12345

Takie ciągi są tworzone poprzez kodowanie base62, losowo generowane liczby 96-bitowe. Użyj tego ustawienia, aby zapobiec odgadywaniu i indeksowaniu adresów URL linków dynamicznych, co może potencjalnie ujawnić poufne informacje niezamierzonym odbiorcom.

Jeśli ustawisz parametr na "SHORT" , komponent ścieżki będzie ciągiem znaków o długości tylko tyle, ile potrzeba, aby był unikalny, o minimalnej długości 4 znaków.

https://example.page.link/WXYZ

Użyj tej metody, jeśli poufne informacje nie zostaną 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"
   }
}

Podana wartość głębokiego linku musi zaczynać się od schematów http:// lub https://. Musi także pasować do dowolnej białej listy wzorców adresów URL wprowadzonej w konsoli. W przeciwnym razie interfejs API tworzenia nie powiedzie się i wyświetli kod błędu HTTP 400.

Następne kroki

Po utworzeniu linków dynamicznych musisz skonfigurować aplikację tak, aby otrzymywała linki dynamiczne i odsyłała użytkowników do odpowiedniego miejsca w aplikacji, gdy użytkownik je otworzy.

Aby otrzymać linki dynamiczne w swojej aplikacji, zapoznaj się z dokumentacją 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 większy limit, wypełnij ten formularz .