完成 OAuth 2.0 實作後,您可以選擇設定驗證式 App Flip,讓使用者可以在驗證系統中更快速地將其帳戶連結至其 Google 帳戶。以下各節將說明如何為 smart home 動作設計及實作 App Flip。
設計指南
本節說明 AppFlip 帳戶連結同意畫面的設計規定和建議。Google 呼叫您的應用程式後,應用程式會向使用者顯示同意畫面。
需求條件
- 您必須擁有 Google 授權聲明,例如「連結完成後,Google 將有權控制您的裝置」。
- 您必須告知使用者的帳戶是連結至 Google,而「不是」連結至特定 Google 產品,例如 Google Home 或 Google 助理。
- 您必須在同意畫面中提供明確的行動號召,並使用「同意並連結」一詞來進行連結動作。這是因為使用者必須瞭解必須和 Google 分享哪些資料才能連結帳戶。
- 當使用者選擇不連結時,您必須提供返回或取消連結的方法。使用「取消」一詞執行取消動作。
- 您必須執行以下工作流程:點選「同意並連結」後,您必須顯示連結成功,並將使用者自動重新導向至 Google Home 應用程式。現在,使用者可以透過動作在 Google Home 應用程式中看到已連結的裝置。點選「取消」後,您應該將使用者重新導向回 Google Home 應用程式。
建議
建議您採取下列做法:
顯示《Google 隱私權政策》。在同意畫面中加入《Google 隱私權政策》連結。
要分享的資料。以簡明扼要的用語告知使用者 Google 需要哪些資料以及要求的原因。
可取消連結功能。提供讓使用者取消連結的機制,例如在您平台的帳戶設定網址。您也可以加入 Google 帳戶連結,方便使用者管理已連結的帳戶。
可變更使用者帳戶。建議使用者切換帳戶的方法。如果使用者常擁有多個帳戶,這種做法尤其實用。
- 如果使用者必須關閉同意畫面才能切換帳戶,請傳送可復原的錯誤給 Google,讓使用者透過 OAuth 連結和隱含流程登入所需帳戶。
加入您的標誌。在同意畫面中顯示貴公司的標誌。 參考樣式規範來放置標誌。如果您也想顯示 Google 的標誌,請參閱「標誌和商標」一文。

設定以 OAuth 為基礎的 App Flip
下列各節說明以 OAuth 為基礎的 App Flip 使用條件,以及如何在動作主控台中設定 App Flip 專案。
建立智慧住宅動作並設定 OAuth 2.0 伺服器
設定 App Flip 之前,請先完成下列步驟:
- 設定 OAuth 2.0 伺服器。如要進一步瞭解如何設定 OAuth 伺服器,請參閱「實作 OAuth 2.0 伺服器」。
- 建立動作。如要建立動作,請按照建立動作專案中的指示操作。
在 Actions 主控台設定 App Flip
以下章節說明如何在動作控制台中設定 App Flip。
- 填寫「OAuth Client information」(OAuth 用戶端資訊) 下方的所有欄位。(如果系統不支援 App Flip,則會使用一般 OAuth 做為備用選項)。
- 在「使用您的應用程式進行帳戶連結(選用)」下方,勾選「為 iOS 啟用」。
- 填寫「通用連結」欄位。如要進一步瞭解通用連結,請參閱「允許應用程式和網站連結至您的內容」一文。
- 如果您想選擇性設定用戶端,請新增範圍,然後在「設定用戶端 (選用)」下方點選「新增範圍」。
- 點按「儲存」。
現在您可以繼續進行下一節,在 iOS 或 Android 應用程式中實作 App Flip。
在原生應用程式中導入 App Flip
如要導入 App Flip,您必須修改應用程式中的使用者授權碼,以便接受 Google 提供的深層連結。
在裝置上測試 App Flip
您已在主控台和應用程式中建立動作並設定 App Flip,現在可以在行動裝置上測試 App Flip。您可以使用 Google Assistant app 或 Google Home app (GHA) 測試 App Flip。
如要從 Google Assistant app 測試 App Flip,請按照下列步驟操作:
- 前往 Actions 主控台,然後選取您的專案。
- 按一下頂端導覽列的「測試」。
- 從 Google Assistant 應用程式觸發帳戶連結流程:
- 開啟 Google Assistant app。
- 按一下「設定」。
- 在「Assistant」分頁中,按一下「居家控制系統」。
- 按一下「新增(+)」。
- 從供應商清單中選取動作。並在清單中為該字串加上「[test]」前置字元。從清單中選取 [test] 動作後,系統應該就會開啟應用程式。
- 確認應用程式已發布,並開始測試授權流程。
如要從 Google Home 應用程式測試 App Flip,請按照下列步驟操作:
- 前往 Actions 主控台,然後選取您的專案。
- 按一下頂端導覽列的「測試」。
- 從 Home 應用程式觸發帳戶連結流程:
- 開啟 Google Home app (GHA)。
- 按一下「+」+按鈕。
- 按一下「設定裝置」。
- 按一下「是否有已經設定好的裝置嗎?」。
- 從供應商清單中選取您的smart home動作。並在清單中為該字串加上「[test]」前置字元。從清單中選取 [test] 動作後,系統應該就會開啟應用程式。
- 確認應用程式已發布,並開始測試授權流程。