您可以使用 Firebase Dynamic Links REST API 建立短篇 Dynamic Links。這個 API 接受長的動態連結或包含 Dynamic Link 參數的物件,並傳回網址,範例如下:
https://example.page.link/WXYZ
使用 API 和用戶端 (Android/Apple) SDK 建立的簡短動態連結不會顯示在 Firebase 控制台中。這類動態連結的用途是在使用者之間分享。針對行銷用途,請繼續透過 Firebase 控制台的「Dynamic Links」頁面,直接建立連結。
事前準備
- 取得 API 金鑰。您必須具備 API 金鑰,才能驗證傳送至 API 的要求。如要查看 API 金鑰,請按照下列步驟操作:
- 開啟 Firebase 控制台的設定頁面。如果系統提示您選擇專案,請從選單中選取您的 Firebase 專案。
- 請記下「Web API Key」(網路 API 金鑰) 欄位的值。
- 在 Firebase 控制台中開啟「Dynamic Links」部分。
-
如果您尚未接受服務條款及為 Dynamic Links 設定網域,請按照系統提示操作。
如果您已經有 Dynamic Links 網域,請加以記下。透過程式輔助方式建立 Dynamic Links 時,您必須提供 Dynamic Links 網域。
建立簡短動態連結
使用長連結建立短連結
您可以使用 Firebase Dynamic Links 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" }
如要瞭解如何建立較長的動態連結,請參閱手動建構網址。
根據參數建立短連結
您也可以直接指定 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 參考資料。
設定簡短動態連結的長度
您也可以設定 suffix
參數,指定短動態連結的路徑元件產生方式。
根據預設,或者如果您將參數設為 "UNGUESSABLE"
,路徑元件會是 17 個字元的字串,如以下範例所示:
https://example.page.link/UVWXYZuvwxyz12345
這類字串是由 Base62 編碼,隨機產生的 96 位元數字來建立。使用這項設定可防止 Google 猜測及檢索您的動態連結網址,避免將機密資訊提供給非預期的收件者。
如果您將參數設為 "SHORT"
,路徑元件就會是一個字串,只為不重複的要求,長度不得少於 4 個字元。
https://example.page.link/WXYZ
但如果猜測短動態連結網址,也不會曝露私密資訊,請使用這個方法。
以下範例說明如何設定 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,請參閱 iOS、Android、C++ 和 Unity 的說明文件。
每個要求的限制為每秒 5 個要求/IP 位址,以及每天 200,000 個要求。否則回應會傳回 HTTP 錯誤代碼 429。如想申請更多配額,請填寫這份表單。