Tworzenie linków dynamicznych za pomocą interfejsu API REST

Krótkie linki Dynamic Links możesz tworzyć za pomocą interfejsu Firebase Dynamic Links REST API. Ten interfejs API akceptuje długi identyfikator Dynamic Link lub obiekt zawierający parametry Dynamic Link i zwraca adres URL podobny do tego w przykładzie poniżej:

https://example.page.link/WXYZ

Filmy Short Dynamic Links utworzone za pomocą interfejsu API i pakietu SDK klienta (Android/Apple) nie są widoczne 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 Dynamic Linksstronie konsoli Firebase.

Zanim zaczniesz

  1. Uzyskaj klucz interfejsu API. Aby uwierzytelniać żądania do interfejsu API, musisz mieć klucz interfejsu API. Aby znaleźć klucz interfejsu API:
    1. Otwórz stronę Ustawienia konsoli Firebase. Jeśli pojawi się prośba o wybranie projektu, wybierz z menu projekt Firebase.
    2. Zanotuj wartość pola Klucz interfejsu API dla aplikacji internetowych.
  2. W konsoli Firebase otwórz sekcję Dynamic Links.

  3. Jeśli nie masz jeszcze zaakceptowanych warunków korzystania z usługi i ustawionej domeny dla Dynamic Links, zrób to, gdy pojawi się odpowiedni komunikat.

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

Za pomocą interfejsu Firebase Dynamic Links API możesz skrócić długi adres URL Dynamic Link. Aby to zrobić, wyślij żądanie HTTP POST do punktu końcowego shortLinks, podając długi Dynamic Link w parametrze 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 adres URL, przeczytaj artykuł Ręczne tworzenie adresu URL.Dynamic Links

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.

Ustawianie długości filmu Short Dynamic Link

Możesz też ustawić parametr suffix, aby określić, jak ma być generowany komponent ścieżki krótkiego adresu URL Dynamic Link.

Domyślnie lub jeśli ustawisz parametr na "UNGUESSABLE", komponent ścieżki będzie ciągiem 17-znakowym, jak w tym przykładzie:

https://example.page.link/UVWXYZuvwxyz12345

Takie ciągi znaków są tworzone przez zakodowanie w systemie base62 losowo wygenerowanych 96-bitowych liczb. Użyj tego ustawienia, aby zapobiec odgadywaniu i indeksowaniu adresów URL Dynamic Links, co może potencjalnie ujawnić informacje poufne nieodpowiednim odbiorcom.

Jeśli ustawisz wartość parametru na "SHORT", komponent ścieżki będzie ciągiem znaków, który będzie miał tylko tyle znaków, ile potrzeba, aby był unikalny, ale nie mniej niż 4 znaki.

https://example.page.link/WXYZ

Użyj tej metody, jeśli w przypadku odgadnięcia krótkiego adresu URL Dynamic Linknie zostaną ujawnione informacje poufne.

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

Wartość precyzyjnego linku musi zaczynać się od schematu http:// lub https://. Musi też pasować do dowolnego wzorca adresu URL na białej liście podanego w konsoli. W przeciwnym razie interfejs API do tworzenia zwróci błąd 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 ich otwarciu.

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 000 żądań dziennie. Jeśli limit zostanie przekroczony, odpowiedź zwróci kod błędu HTTP 429. Aby poprosić o zwiększenie limitu, wypełnij ten formularz.