Membuat Dynamic Links dengan REST API

Anda dapat membuat Dynamic Link pendek dengan Firebase Dynamic Links REST API. API ini menerima Dynamic Link panjang atau objek yang berisi parameter Dynamic Link, dan menampilkan URL seperti contoh berikut:

https://example.page.link/WXYZ

Dynamic Link pendek yang dibuat dengan API dan SDK klien (Android/Apple) tidak ditampilkan di Firebase console. Dynamic Links seperti itu dimaksudkan untuk proses berbagi pengguna-ke-pengguna. Untuk penggunaan dalam pemasaran, terus buat link Anda secara langsung melalui halaman Dynamic Links dari Firebase console.

Sebelum memulai

  1. Dapatkan kunci API Anda. Anda akan memerlukan kunci API untuk mengautentikasi permintaan ke API. Untuk menemukan kunci API:
    1. Buka halaman Setelan di Firebase console. Jika diminta memilih project, pilih project Firebase Anda dari menu.
    2. Catat nilai pada kolom Kunci API Web.
  2. Di Firebase console, buka bagian Dynamic Links.

  3. Jika Anda belum menyetujui persyaratan layanan dan menetapkan domain untuk Dynamic Link Anda, lakukanlah saat diminta.

    Jika Anda sudah memiliki domain Dynamic Link, catatlah. Anda harus menyediakan domain Dynamic Link ketika membuat Dynamic Link secara terprogram.

Anda dapat menggunakan Firebase Dynamic Links API untuk memperpendek Dynamic Link panjang. Untuk melakukannya, buat permintaan POST HTTP ke endpoint shortLinks, dengan menentukan Dynamic Link panjang di parameter longDynamicLink. Contoh:

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

Baca Membuat URL secara manual untuk mempelajari cara membuat Dynamic Links panjang.

Anda juga dapat membuat Dynamic Link pendek dengan menentukan parameter Dynamic Link secara langsung. Untuk melakukannya, buat permintaan POST HTTP ke endpoint shortLinks, dengan menentukan parameter Dynamic Link di parameter dynamicLinkInfo. Contoh:

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

Untuk mengetahui spesifikasi lengkap objek dynamicLinkInfo, baca referensi API.

Menyetel panjang Dynamic Link pendek

Anda juga dapat menyetel parameter suffix untuk menentukan cara komponen jalur Dynamic Link pendek dihasilkan.

Secara default, atau jika Anda menyetel parameter ke "UNGUESSABLE", komponen jalur akan memiliki panjang string 17 karakter, seperti dalam contoh berikut:

https://example.page.link/UVWXYZuvwxyz12345

String tersebut dibuat dengan encoding base62 yang menghasilkan angka 96-bit secara acak. Gunakan setelan ini untuk mencegah agar URL Dynamic Links Anda tidak ditebak dan di-crawl, karena berpotensi membuka informasi sensitif kepada penerima yang tidak diinginkan.

Jika Anda menyetel parameter ke "SHORT", string komponen jalur hanya akan memiliki panjang yang diperlukan agar terlihat unik dengan panjang minimum 4 karakter.

https://example.page.link/WXYZ

Gunakan metode ini jika informasi sensitif tidak akan terungkap walaupun URL Dynamic Link ditebak.

Contoh berikut menunjukkan cara menyetel parameter 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"
   }
}

Setidaknya, nilai deep link yang diberikan harus dimulai dengan skema http:// atau https://. Nilai tersebut juga harus cocok dengan daftar putih pola URL yang dimasukkan di konsol. Selain itu, API pembuatan akan gagal dengan kode error HTTP 400.

Langkah berikutnya

Setelah membuat Dynamic Links, Anda perlu menyiapkan aplikasi untuk menerima Dynamic Links dan mengirim pengguna ke tempat yang tepat dalam aplikasi Anda setelah mereka membukanya.

Untuk menerima Dynamic Links di aplikasi Anda, baca dokumentasi untuk iOS, Android, C++, dan Unity.

Permintaan dibatasi sebanyak 5 permintaan/alamat ID/detik, dan 200.000 permintaan/hari. Jika terlampaui, respons akan menampilkan kode error HTTP 429. Untuk meminta kuota lebih banyak, isi formulir ini.