Google Picker の概要

このドキュメントでは、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 の Fluent インターフェースを使用します。 認証 URL でクエリ文字列パラメータを使用します。

drive.file スコープを使用するには、Google Picker にアクセスする際にユーザーがログインしている必要があります。

主な戦略の違いは次のとおりです。

  • ウェブアプリは、高いインタラクティビティと詳細なカスタマイズ（ファイル タイプ別の特定のビューや、特定のドライブ フォルダへのビューの制限など）を目的として設計されています。
  • デスクトップ アプリとモバイルアプリは、セキュリティとシンプルさを重視して設計されており、システム ブラウザを使用して、認証とファイル選択を単一の統合フローで処理します。