應用程式翻轉

實作 OAuth 2.0 後,您可以選擇設定以 OAuth 為基礎的 App Flip,讓 Android 使用者更快速地將驗證系統中的帳戶連結至 Google 帳戶。以下各節將說明如何設計及實作 Cloud-to-cloud 整合作業的 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 的先決條件,以及如何在 Google Home 開發人員控制台中設定 App Flip 專案。

建立雲端對雲端整合並設定 OAuth 2.0 伺服器

如要設定 App Flip,您必須先完成下列步驟:

在開發人員控制台中設定應用程式翻轉功能

以下說明如何在 開發人員控制台中設定 App Flip。

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

您現在可以繼續閱讀下一節,瞭解如何在 iOS 或 Android 應用程式中實作 App Flip

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

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

在裝置上測試 App Flip

您已建立雲端到雲端整合,並在控制台和應用程式中設定 App Flip,現在可以透過行動裝置測試 App Flip。您可以使用 Google Home 應用程式測試 App Flip。

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

  1. 前往 Developer Console,然後選取您的專案。
  2. 依序前往「雲端到雲端」>「測試」
  3. 透過 Google Home 應用程式觸發帳戶連結流程:
    1. 開啟 Google Home app (GHA)
    2. 按一下「+」按鈕。
    3. 按一下「設定裝置」
    4. 按一下「是否有已經設定好的裝置?」
    5. 從供應商清單中選取雲端到雲端整合服務。在清單中,這項測試會在名稱前加上「[test]」。從清單中選取 [test] 整合後,應用程式應會開啟。
    6. 確認應用程式已啟動,並開始測試授權流程。