Catch up on highlights from Firebase at Google I/O 2023. Learn more

使用 REST API 創建動態鏈接

您可以使用 Firebase 動態鏈接 REST API 創建短動態鏈接。此 API 接受長動態鏈接或包含動態鏈接參數的對象，並返回如下例所示的 URL：

https://example.page.link/WXYZ

使用 API 和客戶端 (Android/Apple) SDK 創建的短動態鏈接不會顯示在 Firebase 控制台中。此類動態鏈接用於用戶之間的共享。對於營銷用例，繼續直接通過 Firebase 控制台的動態鏈接頁面創建您的鏈接。

在你開始之前

  1. 獲取您的 API 密鑰。您將需要一個 API 密鑰來驗證您對 API 的請求。要找到您的 API 密鑰：
    1. 打開 Firebase 控制台的設置頁面。如果系統提示您選擇一個項目，請從菜單中選擇您的 Firebase 項目。
    2. 記下Web API 密鑰字段的值。
  2. 在 Firebase 控制台中，打開動態鏈接部分。

  3. 如果您尚未接受服務條款並為您的動態鏈接設置域，請在出現提示時執行此操作。

    如果您已有動態鏈接域，請記下它。以編程方式創建動態鏈接時，您需要提供動態鏈接域。

您可以使用 Firebase 動態鏈接 API 來縮短較長的動態鏈接。為此，向shortLinks端點發出 HTTP POST 請求，在longDynamicLink參數中指定長動態鏈接。例如：

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

請參閱手動構建 URL以了解如何創建長動態鏈接。

您還可以通過直接指定動態鏈接參數來創建短動態鏈接。為此，向shortLinks端點發出 HTTP POST 請求，在dynamicLinkInfo參數中指定動態鏈接參數。例如：

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

有關dynamicLinkInfo對象的完整規範，請參閱API 參考。

設置短動態鏈接的長度

您還可以設置suffix參數來指定如何生成短動態鏈接的路徑組件。

默認情況下，或者如果您將參數設置為"UNGUESSABLE" ，路徑組件將是一個 17 個字符的字符串，例如以下示例：

https://example.page.link/UVWXYZuvwxyz12345

這些字符串是通過 base62 編碼隨機生成的 96 位數字創建的。使用此設置可防止您的動態鏈接 URL 被猜測和抓取，這可能會將敏感信息暴露給非預期的收件人。

如果將參數設置為"SHORT" ，則路徑組件將是一個字符串，只要需要是唯一的，最小長度為 4 個字符。

https://example.page.link/WXYZ

如果猜測短的動態鏈接 URL 不會暴露敏感信息，請使用此方法。

以下示例顯示瞭如何設置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"
   }
}

至少，提供的深層鏈接值必須以 http:// 或 https:// 方案開頭。它還必須匹配在控制台中輸入的任何 URL 模式白名單。否則，創建 API 將失敗並顯示 HTTP 錯誤代碼 400。

下一步

現在您已經創建了動態鏈接，您需要設置您的應用程序以接收動態鏈接並在用戶打開它們後將用戶發送到您應用程序中的正確位置。

要在您的應用程序中接收動態鏈接，請參閱iOS 、 Android 、 C++和Unity的文檔。

請求限制為 5 個請求/IP 地址/秒，以及 200,000 個請求/天。如果超出，則響應將返回 HTTP 錯誤代碼 429。要請求更多配額，請填寫此表單。