Buka konsol

Membuat Dynamic Links dengan REST API

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

https://example.page.link/WXYZ

Dynamic Link pendek yang dibuat dengan SDK API dan klien (Android/iOS) tidak ditampilkan di Firebase console. Dynamic Link 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. Kunci API diperlukan 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 memiliki domain Dynamic Links, catatlah. Anda harus menyediakan domain Dynamic Links ketika membuat Dynamic Link secara terprogram.

Membuat Dynamic Link pendek

Anda dapat menggunakan API Firebase Dynamic Links untuk memperpendek Dynamic Link panjang. Caranya, buat permintaan HTTP POST ke endpoint shortLinks, yang menentukan Dynamic Link panjang dalam parameter longDynamicLink: Misalnya:

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 Link panjang.

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

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 lokasi Dynamic Link pendek dihasilkan.

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

https://example.page.link/UVWXYZuvwxyz12345

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

Jika Anda menyetel parameter ke "SHORT", string komponen lokasi 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 ingin dibuka ketika URL Dynamic Link sudah 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 Link, Anda perlu menyiapkan aplikasi untuk menerima Dynamic Link dan mengirim pengguna ke tempat yang tepat dalam aplikasi Anda setelah mereka membukanya.

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

Permintaan dibatasi hingga 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.