Membuat Dynamic Links dengan REST API

Anda dapat membuat Dynamic Links pendek dengan Firebase Dynamic Links 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 Links 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 di 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 Links Anda, lakukanlah saat diminta.

    Jika Anda sudah membuat domain Dynamic Links, catat domain tersebut. Anda harus menyediakan domain Dynamic Links ketika membuat Dynamic Links 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 parameter 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, yang dapat 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 pendek berhasil 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 IP/detik, dan 200.000 permintaan/hari. Jika terlampaui, respons akan menampilkan kode error HTTP 429. Untuk meminta kuota lebih banyak, isi formulir ini.