Trang này được dịch bởi Cloud Translation API.

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

Bạn có thể tạo Dynamic Links ngắn bằng Firebase Dynamic Links REST API. API này chấp nhận một 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

Video Shorts Dynamic Links đượ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 là dành cho việc chia sẻ giữa người dùng với nhau. Đối với các trường hợp sử dụng 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 có 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ở mục Dynamic Links.
Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt mộ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 miền Dynamic Links khi tạo Dynamic Links theo phương thức lập trình.

Tạo video Shorts Dynamic Link

Tạo đường liên kết rút gọn từ đường liên kết dài

Bạn có thể dùng API Liên kết động của Firebase để rút ngắn một Dynamic Link dài. Để thực hiện việc này, hãy gửi một yêu cầu HTTP POST đế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 rút gọ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 gửi một yêu cầu HTTP POST đế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 đầy đủ quy cách của đối tượng dynamicLinkInfo, hãy xem tài liệu tham khảo về API.

Đặt thời lượng của video Shorts 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á base62 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 URL Dynamic Links của bạn. Việc này có thể vô tình để lộ thông tin nhạy cảm cho những 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 khi cần thiết để có tính duy nhất, với độ dài tối thiểu là 4 ký tự.

https://example.page.link/WXYZ

Hãy sử dụng phương thức này nếu thông tin nhạy cảm sẽ không bị lộ khi người dùng đoán được một URL Dynamic Linkngắ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 hợp lệ

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

Các bước tiếp theo

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

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

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