Picker API を使ってみる

Picker API を使用すると、ユーザーは Google フォトのライブラリから写真や動画を選択し、アプリと共有できます。

始める前に

Picker API のフロー

Picker API の仕組みの概要は次のとおりです。

  1. OAuth トークンの確認: Picker API フローを開始する前に、ユーザーの有効な OAuth 2.0 アクセス トークンを確認します。トークンがない場合、OAuth 2.0 認可フローを開始してトークンを取得します。

  2. セッションを作成する: Picker API を呼び出して新しいセッションを作成し、プロセスを開始します。この呼び出しは、一意の pickerUri を返します。

  3. Google フォト アプリにユーザーを誘導する: pickerUri をユーザーに提供します（クリック可能なリンクまたは QR コードのいずれか）。この URL により、Google フォト アプリが安全に開きます。

  4. ユーザーがメディア アイテムを選択する: Google フォト アプリ内で、ユーザーはライブラリをブラウジングし、アプリと共有する写真や動画を選択できます。ユーザーの選択操作の概要をご覧ください。

  5. セッションをポーリングする: アプリは定期的にセッションをポーリングしてステータスを確認する必要があります。mediaItemsSet プロパティが true を返すことを確認します。これは、ユーザーが選択を完了したことを示します。

  6. 選択したメディア アイテムを一覧表示する: mediaItemsSet が true を返したら、list メソッドを使用して、選択したメディア アイテムの詳細を取得できます。

  7. メディア アイテムを取得して使用: 選択したメディア アイテムにアクセスできるようになりました。baseUrl を使用してコンテンツを取得し、アプリケーション内で使用できます。

次のステップ

  • リファレンス ドキュメントを確認する: 使用可能なすべてのメソッドとパラメータについては、Picker API リファレンス ドキュメントをご覧ください。
  • サンプルを試す: サンプルで Picker API の動作を確認し、統合のヒントを得てください。