使用 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 控制台。

事前準備

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

  3. 如果尚未接受服務條款並設定網域 請依提示操作。Dynamic Links

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

您可以使用 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。如要請款 如要提高配額，請填寫這份表單。