OAuth 2.0 を実装すると、OAuth ベースの App Flip を設定できるようになります。Android ユーザーは、認証システムのアカウントを Google アカウントに簡単にリンクできます。以降のセクションでは、Cloud-to-cloud 統合用に App Flip を設計して実装する方法について説明します。
Design guidelines
This section describes the design requirements and recommendations for the App Flip account linking consent screen. After Google calls your app, your app displays the consent screen to the user.
Requirements
- You must have a Google authorization statement such as "Once linked, Google will have permission to control your devices."
- You must communicate that the user's account is being linked to Google, not to a specific Google product, such as Google Home or Google Assistant.
- You must state a clear call-to-action on your consent screen and use the wording "Agree and link" for linking action. This is because users need to understand what data they're required to share with Google to link their accounts.
- You must provide a way for users to go back or cancel, if they choose not to link. Use the wording "Cancel" for the cancel action.
- You must implement this workflow: After clicking "Agree and link", you must show linking success and redirect the user back to the Google Home app automatically. The user should now see the linked device on the Google Home app with your action. After clicking "Cancel" you should redirect the user back to the Google Home app.
Recommendations
We recommend that you do the following:
Display Google's Privacy Policy. Include a link to Google's Privacy Policy on the consent screen.
Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.
Ability to unlink. Offer a mechanism for users to unlink, such as a URL to their account settings on your platform. Alternatively, you can include a link to Google Account where users can manage their linked account.
Ability to change user account. Suggest a method for users to switch their account(s). This is especially beneficial if users tend to have multiple accounts.
- If a user must close the consent screen to switch accounts, send a recoverable error to Google so the user can sign in to the desired account with OAuth linking and the implicit flow.
Include your logo. Display your company logo on the consent screen. Use your style guidelines to place your logo. If you wish to also display Google's logo, see Logos and trademarks.
OAuth ベースの App Flip を設定する
以降のセクションでは、OAuth ベースのアプリ切り替えの前提条件と、Google Home Developer Console でアプリ切り替えプロジェクトを構成する方法について説明します。
Cloud-to-Cloud 統合を作成し、OAuth 2.0 サーバーを設定する
App Flip を構成する前に、次の操作を行う必要があります。
- OAuth 2.0 サーバーを設定する。OAuth サーバーの設定について詳しくは、OAuth 2.0 サーバーを導入するをご覧ください。
- クラウド間インテグレーションを作成する。統合を作成するには、Cloud 間統合を作成するの手順に沿って操作します。
デベロッパー コンソールでアプリ切り替えを設定する
次のセクションでは、デベロッパー コンソールでアプリ切り替えを構成する方法を説明します。
- [OAuth Client information] のすべてのフィールドを入力します（App Flip がサポートされていない場合は、通常の OAuth がフォールバックとして使用されます）。
- [Use your app for account linking (optional)] で、[Enable for iOS]（iOS で有効にする）をオンにします。
- [Universal Link]（ユニバーサル リンク）フィールドに入力します。ユニバーサル リンクについて詳しくは、コンテンツへのアプリとウェブサイトのリンクを許可するをご覧ください。
- クライアントを設定したい場合は、スコープを追加し、[Configure your client (optional)]（クライアントを構成する（省略可））で [Add scope]（スコープを追加）をクリックします。
- [保存] をクリックします。
次のセクションに進んで、iOS アプリまたは Android アプリに App Flip を実装します。
ネイティブ アプリに App Flip を実装する
App Flip を実装するには、Google からのディープリンクを許可するようにアプリのユーザー認可コードを変更する必要があります。
デバイスで App Flip をテストする
Cloud 間インテグレーションを作成し、コンソールとアプリでアプリ切り替えを設定したので、モバイル デバイスでアプリ切り替えをテストできます。Google Home アプリを使用してアプリ切り替えをテストできます。
Google Home アプリから App Flip をテストする手順は次のとおりです。
- デベロッパー コンソールに移動し、プロジェクトを選択します。
- [Cloud-to-cloud > Test] に移動します。
- Home アプリからアカウントのリンクフローをトリガーします。
- Google Home app (GHA) を開きます。
- [+] ボタンをクリックします。
- [デバイスのセットアップ] をクリックします。
- [セットアップ済みデバイスのリンク] をクリックします。
- プロバイダのリストから、Cloud 間インテグレーションを選択します。リストの先頭に「[test]」が付きます。リストから [test] 統合を選択すると、アプリが開きます。
- アプリが起動したことを確認し、承認フローのテストを開始します。