Twórz dynamiczne linki za pomocą REST API

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

https://example.page.link/WXYZ

Krótkie linki dynamiczne utworzone za pomocą interfejsu API i klienckiego pakietu SDK (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

  1. Zdobądź klucz API. Do uwierzytelnienia żądań w interfejsie API potrzebny będzie klucz API. Aby znaleźć klucz API:
    1. Otwórz stronę Ustawienia konsoli Firebase. Jeśli pojawi się prośba o wybranie projektu, wybierz z menu swój projekt Firebase.
    2. Zanotuj wartość pola Klucz internetowego interfejsu API .
  2. W konsoli Firebase otwórz sekcję Linki dynamiczne .
  3. Jeśli nie zaakceptowałeś jeszcze warunków korzystania z usługi i ustawiłeś domenę dla swoich Linków dynamicznych, zrób to, gdy zostaniesz o to poproszony.

    Jeśli masz już domenę Dynamic Links, zanotuj to. Musisz podać domenę Dynamic Links podczas automatycznego tworzenia Linków 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ługi link dynamiczny 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ż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 można znaleźć w dokumentacji API .

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

Możesz 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 17-znakowym ciągiem, tak jak w poniższym przykładzie:

https://example.page.link/UVWXYZuvwxyz12345

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

Jeśli ustawisz parametr na "SHORT" , składnik ścieżki będzie ciągiem, który jest tak długi, jak jest to konieczne, 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 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"
   }
}

Podana wartość precyzyjnego linku musi zaczynać się co najmniej od schematu http:// lub https://. Musi też odpowiadać dowolnej białej liście wzorców adresów URL wpisanej w konsoli. W przeciwnym razie tworzenie interfejsu API zakończy się niepowodzeniem z kodem błędu HTTP 400.

Następne kroki

Teraz, po utworzeniu linków dynamicznych, musisz skonfigurować swoją aplikację tak, aby odbierała linki dynamiczne i wysyłała użytkowników we właściwe miejsce w aplikacji po ich otwarciu.

Aby otrzymywać Dynamic Links 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 zwiększenie limitu, wypełnij ten formularz .