Tạo đường liên kết động bằng API REST

Bạn có thể tạo Dynamic Links ngắn bằng API REST của Đường liên kết động Firebase. API này chấp nhận Dynamic Link dài hoặc một đối tượng chứa các tham số Dynamic Link và trả về một URL như ví dụ sau:

https://example.page.link/WXYZ

Dynamic Links ngắn được tạo bằng API và SDK ứng dụng (Android/Apple) không xuất hiện trong bảng điều khiển Firebase. Dynamic Links như vậy dành cho việc chia sẻ giữa người dùng với người dùng. Đối với các trường hợp sử dụng cho mục đích tiếp thị, hãy tiếp tục tạo đường liên kết trực tiếp thông qua trang Dynamic Links của bảng điều khiển Firebase.

Trước khi bắt đầu

Lấy khoá API. Bạn sẽ cần một khoá API để xác thực các yêu cầu của mình đối với API. Cách tìm khoá API:
1. Mở trang Cài đặt của bảng điều khiển Firebase. Nếu bạn được nhắc chọn một dự án, hãy chọn dự án Firebase của bạn trong trình đơn.
2. Ghi lại giá trị của trường Khoá API web.
Trong bảng điều khiển Firebase, hãy mở phần Dynamic Links.
Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt miền cho Dynamic Links, hãy làm như vậy khi được nhắc.

Nếu bạn đã có miền Dynamic Links, hãy ghi lại miền đó. Bạn cần cung cấp một miền Dynamic Links khi tạo Dynamic Links theo phương thức lập trình.

Tạo Dynamic Link ngắn

Tạo đường liên kết ngắn từ đường liên kết dài

Bạn có thể sử dụng API Liên kết động của Firebase để rút ngắn Dynamic Link dài. Để thực hiện việc này, hãy tạo một yêu cầu POST qua HTTP đến điểm cuối shortLinks, chỉ định Dynamic Link dài trong tham số longDynamicLink. Ví dụ:

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

Hãy xem phần Tạo URL theo cách thủ công để tìm hiểu cách tạo Dynamic Links dài.

Tạo đường liên kết ngắn từ các thông số

Bạn cũng có thể tạo một Dynamic Link ngắn bằng cách chỉ định trực tiếp các tham số Dynamic Link. Để thực hiện việc này, hãy tạo một yêu cầu POST qua HTTP đến điểm cuối shortLinks, chỉ định các tham số Dynamic Link trong tham số dynamicLinkInfo. Ví dụ:

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

Để biết thông số kỹ thuật đầy đủ của đối tượng dynamicLinkInfo, hãy xem tài liệu tham khảo API.

Đặt thời lượng của video ngắn Dynamic Link

Bạn cũng có thể đặt tham số suffix để chỉ định cách tạo thành phần đường dẫn của Dynamic Link ngắn.

Theo mặc định hoặc nếu bạn đặt tham số thành "UNGUESSABLE", thành phần đường dẫn sẽ là một chuỗi gồm 17 ký tự, chẳng hạn như trong ví dụ sau:

https://example.page.link/UVWXYZuvwxyz12345

Các chuỗi như vậy được tạo bằng cách mã hoá cơ sở 62 cho các số 96 bit được tạo ngẫu nhiên. Sử dụng chế độ cài đặt này để ngăn chặn việc đoán và thu thập thông tin về URL Dynamic Links. Việc này có thể khiến thông tin nhạy cảm bị tiết lộ cho người nhận không mong muốn.

Nếu bạn đặt tham số thành "SHORT", thành phần đường dẫn sẽ là một chuỗi chỉ dài vừa đủ để duy nhất, với độ dài tối thiểu là 4 ký tự.

https://example.page.link/WXYZ

Sử dụng phương thức này nếu thông tin nhạy cảm sẽ không bị lộ nếu người dùng đoán được URL Dynamic Link ngắn.

Ví dụ sau đây cho thấy cách bạn có thể đặt tham số 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"
   }
}

Đảm bảo đường liên kết sâu là hợp lệ

Ít nhất, giá trị đường liên kết sâu được cung cấp phải bắt đầu bằng giao thức http:// hoặc https://. Mẫu URL này cũng phải khớp với mọi danh sách cho phép mẫu URL đã nhập trong bảng điều khiển. Nếu không, API tạo sẽ không thành công và báo lỗi HTTP 400.

Các bước tiếp theo

Giờ đây, khi đã tạo Dynamic Links, bạn cần thiết lập ứng dụng để nhận Dynamic Links và đưa người dùng đến đúng vị trí trong ứng dụng sau khi người dùng mở ứng dụng.

Để nhận Dynamic Links trong ứng dụng, hãy xem tài liệu về iOS, Android, C++ và Unity.

Số yêu cầu được giới hạn ở mức 5 yêu cầu/địa chỉ IP/giây và 200.000 yêu cầu/ngày. Nếu vượt quá, phản hồi sẽ trả về mã lỗi HTTP 429. Để yêu cầu tăng hạn mức, hãy điền vào biểu mẫu này.