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 API REST của đường liên kết động của Firebase. 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

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. Những Dynamic Links như vậy là để chia sẻ giữa người dùng với nhau. Đối với các trường hợp sử dụng cho hoạt động tiếp thị, hãy tiếp tục tạo đường liên kết trực tiếp thông qua Dynamic Links trang 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ó một khoá API để xác thực yêu cầu của mình cho 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, chọn dự án Firebase của bạn từ trình đơn.
2. Ghi lại giá trị của trường Web API Key.
Trong bảng điều khiển Firebase, hãy mở phần Dynamic Links.
Trường hợp bạn chưa chấp nhận điều khoản dịch vụ và đặt miền cho Dynamic Links của bạn, hãy thực hiện việc này khi được nhắc.

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

Tạo một Dynamic Link ngắn

Tạo đường liên kết ngắn từ mộ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. Để làm như vậy, thực hiện 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 tham số

Bạn cũng có thể tạo một Dynamic Link ngắn bằng cách chỉ định các tham số Dynamic Link trực tiếp. Để thực hiện việc này, hãy gửi yêu cầu POST qua HTTP đến shortLinks điểm cuối, 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ố đầy đủ về đối tượng dynamicLinkInfo, hãy xem Tài liệu tham khảo API.

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

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

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ự, như trong ví dụ sau:

https://example.page.link/UVWXYZuvwxyz12345

Các chuỗi như vậy được tạo bằng các số 96 bit được tạo ngẫu nhiên bằng phương thức mã hoá base62. Sử dụng chế độ cài đặt này để ngăn Google đoán và thu thập dữ liệu các URL Dynamic Links của bạn, vì đường liên kết này có thể tiết 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ỉ khi cần là 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 pháp này nếu thông tin nhạy cảm không được tiết lộ nếu một Dynamic Link ngắn Đã đoán được URL.

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 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 danh sách cho phép của mẫu URL được nhập vào bảng điều khiển. Nếu không, API tạo sẽ không thành công với mã lỗi HTTP 400.

Các bước tiếp theo

Giờ đây khi đã tạo xong 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 của bạn sau khi người dùng mở chúng.

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

Giới hạn ở 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 hạn mức khác, hãy điền vào biểu mẫu này.