Picker API を使用すると、ユーザーは Google フォト ライブラリから写真や動画を安全に選択して、アプリと共有できます。
始める前に
- 概要を確認する: Picker API と Library API を比較することで、Picker API がユースケースに適切かどうかを確認します。
- アプリを構成する: API を有効にして、認証を設定します。詳細な手順については、アプリを構成するをご覧ください。
Picker API のフロー
Picker API の仕組みの概要は次のとおりです。
OAuth トークンを確認する: Picker API フローを開始する前に、ユーザーの有効な OAuth 2.0 アクセス トークンを確認します。トークンがない場合は、OAuth 2.0 認証フローを開始してトークンを取得します。
セッションを作成する: Picker API を呼び出して新しいセッションを作成し、プロセスを開始します。この呼び出しは一意の
pickerUriを返します。ユーザーを Google フォトアプリに誘導する: ユーザーに
pickerUriを提供します（クリック可能なリンクまたは QR コードとして）。この URL を使用すると、Google フォト アプリが安全に開きます。ウェブベースのアプリケーションの場合は、この URI に/autocloseを追加して、ユーザーが選択を完了した後に Google フォト ウィンドウを自動的に閉じることができます。ユーザーがメディア アイテムを選択する: Google フォト アプリ内で、ユーザーはライブラリを閲覧し、アプリと共有する写真や動画を選択できます。ユーザーの選択操作の概要をご覧ください。
セッションをポーリングする: アプリは、ステータスを確認するために定期的にセッションをポーリングする必要があります。
mediaItemsSetプロパティが true を返し、ユーザーが選択を完了したことを示すことを確認します。選択したメディア アイテムのリストを取得する:
mediaItemsSetが true を返したら、リスト メソッドを使用して、選択したメディア アイテムの詳細を取得できます。メディア アイテムを取得して使用する: 選択したメディア アイテムにアクセスできるようになりました。
baseUrlを使用してコンテンツを取得し、アプリ内で利用できます。
次のステップ
- リファレンス ドキュメントを確認する: Picker API の詳細なリファレンス ドキュメントで、使用可能なすべてのメソッドとパラメータを確認します。
- サンプルを試す: サンプルで Picker API の動作を確認し、統合のヒントを得てください。