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 long 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. Pobierz klucz interfejsu API. Aby uwierzytelniać żądania wysyłane do interfejsu API, musisz mieć klucz 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 i nie ustawiłeś domeny dla 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 utworzyć długi 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, podają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ść filmu Short Dynamic Link

Możesz też ustawić parametr suffix, aby określić sposób generowania elementu ścieżki w krótkim 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 przeszukiwaniu adresów URL Dynamic Links, co może prowadzić do ujawnienia 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ż pasować do wzorca adresu URL na białej liście podanej 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.