Ambient API の UX ガイドライン

これらのガイドラインは、Google フォトアンビエント API を使用した統合に特に適用されます。これらの要件に加えて、一般的な Google Photos APIs の UX ガイドラインも確認してください。これらの原則の多くは、アンビエントエクスペリエンスにも適用されます。

デバイスに関するエクスペリエンス

接続ステータスの明確化: ユーザーは、Google フォトアカウントがデバイスに接続されているかどうかを常に確認できる必要があります。このステータスは、デバイスの設定ページや情報メニューなどからアクセスできるようにする必要があります。これにより、ユーザーはプライバシーを保護できます。
アカウントの識別: ユーザーは、どのアカウントが接続されているかを確認できる必要があります。ユーザーのメールアドレスを表示するか、設定メニュー内でアカウント名と組み合わせてアカウントのアバター（プロフィール写真またはイニシャル）を使用することで、これを行うことができます。
簡単な接続解除: ユーザーがデバイスの設定から Google フォトアカウントを直接接続解除できる簡単な方法を提供します。このプロセスは直感的で、複雑なメニューを操作する必要がないようにする必要があります。
デバイスの名前付け: デバイスの作成と管理で説明されているように、セットアッププロセスでデバイスに名前を付けるようユーザーに促します。これにより、ユーザーはメディアソースを選択する際に、Google フォトアプリの設定内でデバイスを特定できます。

明確な手順: 認証プロセス中に、明確で簡潔な画面上の手順を提供します（モバイルデバイスで QR コードをスキャンするようユーザーに指示する場合など）。
ログインの簡素化: OAuth プロセスで state パラメータを含めることで、合理化された認証フローによりユーザーの煩わしさを最小限に抑えます。これにより、ユーザーがスキャンする必要がある QR コードの数を減らすことができます。自動リダイレクトが失敗した場合や、後で設定を変更したいユーザーのために、settingsUri をフォールバック QR コードとして表示できるように準備しておきます。

帰属表示: すべての写真や動画に帰属表示が必要なわけではありませんが、ユーザーが写真が Google フォトからのものであることを理解できる方法（デバイスの設定や写真の情報オーバーレイなど）が必要です。
コンテンツの新しさ: コンテンツソースを最新の状態に保ちます。たとえば、スライドショーエクスペリエンスでは、メディアアイテムのリストと取得で説明されているように、メディアアイテムのリストの更新を定期的にポーリングし、pollInterval を尊重して、表示されるコンテンツがユーザーの現在の選択を反映していることを確認します。

初回セットアップ: ユーザーが Google フォトアカウントを接続する際は、一般的な UX ガイドラインに記載されているとおり、Google フォトのロゴとブランディングを使用できます。
アンビエント表示: ユーザーの写真や動画をメインの焦点として表示します。写真のスライドショーがアクティブな間、画面に Google フォトのブランディングやロゴが常に表示されないようにします。ブランディングは、セットアップメニューと設定メニューに限定する必要があります。