Tworzenie linków dynamicznych za pomocą interfejsu API REST

Krótkie Dynamic Links możesz tworzyć za pomocą interfejsu API REST Linków dynamicznych Firebase. To API przyjmuje parametr Dynamic Link lub obiekt zawierający parametry Dynamic Link, a zwraca adres URL podobny do tego:

https://example.page.link/WXYZ

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

Zanim zaczniesz

  1. Uzyskaj klucz interfejsu API. Aby uwierzytelniać żądania wysyłane do interfejsu API, potrzebujesz klucza interfejsu API. Aby znaleźć klucz interfejsu API:
    1. Otwórz stronę Ustawienia w konsoli Firebase. Jeśli pojawi się prośba o wybranie projektu, wybierz go w menu.
    2. Zapisz sobie wartość pola Klucz interfejsu API dla aplikacji internetowej.
  2. W konsoli Firebase otwórz sekcję Dynamic Links.

  3. Jeśli nie zaakceptowałeś jeszcze warunków korzystania z usługi ani nie masz skonfigurowanej domeny w Dynamic Links, zrób to, gdy pojawi się taka prośba.

    Jeśli masz już domenę Dynamic Links, zanotuj ją. Podczas tworzenia za pomocą kodu Dynamic Links musisz podać domenę Dynamic Links.

Aby skrócić długi Dynamic Link, możesz użyć interfejsu Firebase Dynamic Links API. Aby to zrobić, wyślij żądanie HTTP POST do punktu końcowego shortLinks, podając parametr Dynamic Link z wartością longDynamicLink. 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"
}

Aby dowiedzieć się, jak tworzyć długie Dynamic Links, przeczytaj artykuł Ręczne tworzenie adresu URL.

Możesz też utworzyć krótki Dynamic Link, podając bezpośrednio parametry Dynamic Link. Aby to zrobić, wyślij żądanie HTTP POST do punktu końcowego shortLinks, określając parametry Dynamic Link w parametrze dynamicLinkInfo. 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 znajdziesz w dokumentacji interfejsu API.

Ustaw długość krótkiego klipu Dynamic Link

Możesz też ustawić parametr suffix, aby określić sposób generowania elementu ścieżki w krótkim linku Dynamic Link.

Domyślnie lub jeśli parametr ma wartość "UNGUESSABLE", element ścieżki będzie ciągiem znaków o długości 17 znaków, np.:

https://example.page.link/UVWXYZuvwxyz12345

Takie ciągi znaków są tworzone przez kodowanie w systemie bazy 62 losowych 96-bitowych liczb. Ustawienie to zapobiega odgadywaniu i indeksowaniu adresów URL Dynamic Links, co może spowodować ujawnienie informacji poufnych nieupoważnionym odbiorcom.

Jeśli ustawisz parametr na "SHORT", element ścieżki będzie ciągiem znaków o tak długiej długości, aby był unikalny, z minimalną długością 4 znaków.

https://example.page.link/WXYZ

Użyj tej metody, jeśli nie chcesz ujawnić informacji poufnych, gdy ktoś odgadnie krótki adres URL Dynamic Link.

Przykład ustawienia parametru 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"
   }
}

Wartość precyzyjnego linku musi się co najmniej zaczynać od schematu http:// lub https://. Musi też być zgodny z wszelkimi wzorcami adresów URL podanymi na białej liście w konsoli. W przeciwnym razie interfejs API do tworzenia nie powiedzie się i zwróci kod błędu HTTP 400.

Dalsze kroki

Po utworzeniu Dynamic Links musisz skonfigurować aplikację tak, aby odbierała Dynamic Links i kierowała użytkowników do odpowiedniego miejsca w aplikacji po otwarciu tych danych.

Aby otrzymywać Dynamic Links w aplikacji, zapoznaj się z dokumentacją dotyczącą iOS, Androida, C++ i Unity.

Liczba żądań jest ograniczona do 5 żądań na adres IP na sekundę i 200 tys. żądań na dzień. Jeśli zostanie przekroczony, odpowiedź zwróci kod błędu HTTP 429. Aby poprosić o większy przydział, wypełnij ten formularz.