應用程式翻轉

完成 OAuth 2.0 實作後,您可以選擇設定驗證式 App Flip,讓使用者可以在驗證系統中更快速地將其帳戶連結至其 Google 帳戶。以下各節將說明如何為 smart home 動作設計及實作 App Flip

設計指南

本節說明 AppFlip 帳戶連結同意畫面的設計規定和建議。Google 呼叫您的應用程式後,應用程式會向使用者顯示同意畫面。

需求條件

  1. 您必須擁有 Google 授權聲明,例如「連結完成後,Google 將有權控制您的裝置」。
  2. 您必須告知使用者的帳戶是連結至 Google,而「不是」連結至特定 Google 產品,例如 Google Home 或 Google 助理。
  3. 您必須在同意畫面中提供明確的行動號召,並使用「同意並連結」一詞來進行連結動作。這是因為使用者必須瞭解必須和 Google 分享哪些資料才能連結帳戶。
  4. 當使用者選擇不連結時,您必須提供返回或取消連結的方法。使用「取消」一詞執行取消動作。
  5. 您必須執行以下工作流程:點選「同意並連結」後,您必須顯示連結成功,並將使用者自動重新導向至 Google Home 應用程式。現在,使用者可以透過動作在 Google Home 應用程式中看到已連結的裝置。點選「取消」後,您應該將使用者重新導向回 Google Home 應用程式。

建議

建議您採取下列做法:

  1. 顯示《Google 隱私權政策》。在同意畫面中加入《Google 隱私權政策》連結。

  2. 要分享的資料。以簡明扼要的用語告知使用者 Google 需要哪些資料以及要求的原因。

  3. 可取消連結功能。提供讓使用者取消連結的機制,例如在您平台的帳戶設定網址。您也可以加入 Google 帳戶連結,方便使用者管理已連結的帳戶。

  4. 可變更使用者帳戶。建議使用者切換帳戶的方法。如果使用者常擁有多個帳戶,這種做法尤其實用。

    • 如果使用者必須關閉同意畫面才能切換帳戶,請傳送可復原的錯誤給 Google,讓使用者透過 OAuth 連結隱含流程登入所需帳戶。
  5. 加入您的標誌。在同意畫面中顯示貴公司的標誌。 參考樣式規範來放置標誌。如果您也想顯示 Google 的標誌,請參閱「標誌和商標」一文。

下圖範例為同意畫面範例,說明您在設計使用者同意畫面時,應遵循的個別規定和建議事項。
圖 1:帳戶連結同意畫面設計規範。

設定以 OAuth 為基礎的 App Flip

下列各節說明以 OAuth 為基礎的 App Flip 使用條件,以及如何在動作主控台中設定 App Flip 專案。

建立智慧住宅動作並設定 OAuth 2.0 伺服器

設定 App Flip 之前,請先完成下列步驟:

在 Actions 主控台設定 App Flip

以下章節說明如何在動作控制台中設定 App Flip

  1. 填寫「OAuth Client information」(OAuth 用戶端資訊) 下方的所有欄位。(如果系統不支援 App Flip,則會使用一般 OAuth 做為備用選項)。
  2. 在「使用您的應用程式進行帳戶連結(選用)」下方,勾選「為 iOS 啟用」
  3. 填寫「通用連結」欄位。如要進一步瞭解通用連結,請參閱「允許應用程式和網站連結至您的內容」一文。
  4. 如果您想選擇性設定用戶端,請新增範圍,然後在「設定用戶端 (選用)」下方點選「新增範圍」
  5. 點按「儲存」

現在您可以繼續進行下一節,在 iOS 或 Android 應用程式中實作 App Flip

在原生應用程式中導入 App Flip

如要導入 App Flip,您必須修改應用程式中的使用者授權碼,以便接受 Google 提供的深層連結。

在裝置上測試 App Flip

您已在主控台和應用程式中建立動作並設定 App Flip,現在可以在行動裝置上測試 App Flip。您可以使用 Google Assistant appGoogle Home app (GHA) 測試 App Flip

如要從 Google Assistant app 測試 App Flip,請按照下列步驟操作:

  1. 前往 Actions 主控台,然後選取您的專案。
  2. 按一下頂端導覽列的「測試」
  3. Google Assistant 應用程式觸發帳戶連結流程:
    1. 開啟 Google Assistant app
    2. 按一下「設定」
    3. 在「Assistant」分頁中,按一下「居家控制系統」
    4. 按一下「新增(+)」
    5. 從供應商清單中選取動作。並在清單中為該字串加上「[test]」前置字元。從清單中選取 [test] 動作後,系統應該就會開啟應用程式。
    6. 確認應用程式已發布,並開始測試授權流程。

如要從 Google Home 應用程式測試 App Flip,請按照下列步驟操作:

  1. 前往 Actions 主控台,然後選取您的專案。
  2. 按一下頂端導覽列的「測試」
  3. Home 應用程式觸發帳戶連結流程:
    1. 開啟 Google Home app (GHA)
    2. 按一下「+」+按鈕。
    3. 按一下「設定裝置」
    4. 按一下「是否有已經設定好的裝置嗎?」
    5. 從供應商清單中選取您的smart home動作。並在清單中為該字串加上「[test]」前置字元。從清單中選取 [test] 動作後,系統應該就會開啟應用程式。
    6. 確認應用程式已發布,並開始測試授權流程。