本頁面由 Cloud Translation API 翻譯而成。

使用 REST API 建立 Dynamic Links

，瞭解如何調查及移除這項存取權。

您可以使用 Firebase Dynamic Links REST API 建立簡短的 Dynamic Links。這個 API 接受長 Dynamic Link 或包含 Dynamic Link 參數的物件，以及會傳回網址，如以下範例所示：

https://example.page.link/WXYZ

使用 API 和用戶端 (Android/Apple) SDK 建立的簡短 Dynamic Links 未顯示 Firebase 控制台中。這類 Dynamic Links 的用途是讓使用者之間相互共用。針對行銷用途，請繼續透過 Dynamic Links 頁 Firebase 控制台。

事前準備

取得 API 金鑰。您需要 API 金鑰才能驗證要求至 API如要查看 API 金鑰，請按照下列步驟操作：
1. 開啟設定頁面 Firebase控制台中就能保留這項資訊如果系統提示您選擇專案從選單中選取 Firebase 專案。
2. 請記下「Web API Key」(網路 API 金鑰) 欄位的值。
在 Firebase 控制台中開啟「Dynamic Links」部分。
如果尚未接受服務條款並設定網域請依提示操作。Dynamic Links

如果您已經擁有 Dynamic Links 網域，請記下該網域。您需要執行的操作透過程式建立 Dynamic Links 時，請提供 Dynamic Links 網域。

正在製作 Shorts 短片 Dynamic Link

使用長連結建立短連結

您可以使用 Firebase Dynamic Links API 縮短 Dynamic Link。方法如下對 shortLinks 端點發出 HTTP POST 要求，並指定 longDynamicLink 參數中的長 Dynamic Link。例如：

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

如要瞭解手動建立網址的方式，請參閱手動建立網址。即可建立長型 Dynamic Links

根據參數建立短連結

您也可以透過指定 Dynamic Link 參數來建立簡短的 Dynamic Link 方法是向 shortLinks 發出 HTTP POST 要求。指定 dynamicLinkInfo 參數中的 Dynamic Link 參數。例如：

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 參考資料。

設定 Dynamic Link 的簡短長度

您也可以設定 suffix 參數，指定並產生簡短的 Dynamic Link。

根據預設，或將參數設為 "UNGUESSABLE"，則路徑元件會是 17 個字元的字串，如以下範例所示：

https://example.page.link/UVWXYZuvwxyz12345

這類字串是由 Base62 編碼，隨機產生的 96 位元數字來建立。使用這項設定可避免系統猜到及檢索您的 Dynamic Links 網址。可能會讓非預期收件者看到機密資訊。

如果您將參數設為 "SHORT"，路徑元件就會是符合必要項目即可，長度至少為 4 個字元。

https://example.page.link/WXYZ

如果簡短 Dynamic Link 不會曝露敏感資訊，請使用這個方法已猜到網址。

以下範例說明如何設定 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:// 配置開頭。也必須與控制台中輸入的所有網址模式許可清單相符。否則建立 API 就會失敗，並傳回 HTTP 錯誤代碼 400。

後續步驟

建立 Dynamic Links 後，您需要設定應用程式才能接收 Dynamic Links，並在使用者開啟應用程式後，將使用者帶往應用程式中的正確位置。

如要在應用程式中接收 Dynamic Links，請參閱 iOS、Android、 C++ 和 Unity。

要求上限為每秒 5 個要求/IP 位址，以及每天 200,000 個要求。否則回應會傳回 HTTP 錯誤代碼 429。如要請款如要提高配額，請填寫這份表單。