このドキュメントでは、Google Picker と Google Picker API について説明します。また、アプリに最適なアプローチを判断するのに役立ちます。
Google Picker は、Google ドライブに保存されている情報に対して洗練された [ファイルを開く] ダイアログを提供します。ユーザーは、アプリを離れることなく、ドライブ アカウントから写真、動画、ドキュメントを選択またはアップロードできます。
Google Picker API は、アプリに Google Picker を実装するために使用される技術インターフェースです。Google Picker API を使用すると、認証とファイル ブラウジングの複雑さを処理する使い慣れたインターフェースを作成できます。ユーザーが選択を行うと、特定のファイル メタデータ（ID や URL など）がアプリに返されます。
主なユースケース
Google Picker は汎用性が高く、さまざまなアプリケーション ワークフローに合わせて調整できます。
- ファイルのアップロードの代替: ユーザーは Google Picker を介してファイルをドライブに直接アップロードできます。
- コラボレーション ツール: ユーザーは、特定の Google ドキュメントまたは Google スプレッドシートをプロジェクト管理タスクまたは共有カレンダーの予定にリンクできます。
- アセットの添付: Google Picker を使用すると、ユーザーはドライブから経費レポートやサポート チケットに補足資料を添付できます。
ウェブアプリとデスクトップ アプリ、モバイルアプリの比較
コア機能は一貫していますが、Google Picker API の実装はアプリの実行場所によって異なります。次の比較表に、ウェブアプリとデスクトップ アプリ、モバイルアプリに実装する場合の技術的および機能的な違いを示します。
| 機能 | ウェブアプリ | デスクトップ アプリとモバイルアプリ |
|---|---|---|
| 主なテクノロジー | クライアントサイドの JavaScript ライブラリ。 | OAuth 2.0 URL パラメータと HTTP リダイレクト。 |
| レンダリング | アプリの既存の UI レイアウトに統合されます。 | ユーザーのデフォルトのシステム ブラウザの新しいタブで開きます。埋め込みウェブビュー内に表示することはできなくなりました。 |
| 認証フロー | setOAuthToken を介して渡される特定のアクセス トークンが必要です。 |
OAuth リクエストに trigger_onepick=true を追加するとトリガーされます。 |
| レスポンス メソッド | 直接 JavaScript コールバック。 | リダイレクト URI またはカスタム URL スキーム。 |
| スコープ | 柔軟性があります。drive.file、drive.readonly などを使用できます。 |
厳密です。drive.file のみ許可され、他のスコープと組み合わせることはできません。 |
| 構成 | JavaScript で PickerBuilder フロー インターフェースを使用します。 |
認証 URL でクエリ文字列パラメータを使用します。 |
drive.file スコープを使用するには、Google Picker にアクセスする際にユーザーがログインしている必要があります。
主な戦略上の違いは次のとおりです。
- ウェブアプリは、高いインタラクティビティと詳細なカスタマイズ（ファイル タイプ別の特定のビューや、特定のドライブ フォルダへのビューの制限など）を目的として設計されています。
- デスクトップ アプリとモバイルアプリは、セキュリティとシンプルさを重視して設計されており、システム ブラウザを使用して、認証とファイル選択を 1 つの統合フローで処理します。