UI統合を構成する

みるくあいらんどっ! > 和訳 > google関係 > Drive API > api > v3


  • この記事は、Google Drive™ APIに関する記事を和訳したものです。
  • 原文: Configure your UI integration
  • 元記事のライセンスは CC-BYで、この和訳記事のライセンスは CC-BYです。
  • 自己責任でご利用ください。
  • 和訳した時期は 2019年6月ころです。

ユーザがファイルを作成あるいは開いたとき、Google Driverにてあなたのアプリを表示するには、Drive UIの統合を構成する必要があります。 この統合は、G Suite Marketplaceにあなたのアプリをリストするためにも必要とされます。

  1. Google API Consoleにサインインします。
  2. 一番上で、アプリのプロジェクトを選択します。
  3. “APIs & Services” ダッシュボードの下部にて、Google Drive APIをクリックします。
  4. 左側で、Drive UI Integrationをクリックします。 それから、あなたのアプリについての詳細を追加します。

あなたのアプリについての詳細を追加する

あなたの Application Nameおよび Short Descriptionは、Google Drive UIの "Manage apps" ダイアログにてユーザに表示されます。 あなたのアプリケーションをより詳細に説明するために、Long Descriptionを追加することもできます。

接続されている Driveアプリのユーザのリストにて、および、関連するファイルタイプの "Open with" コンテキストメニューにて表示するために、Application icon をアップロードします。 透明な背景を持つ、1つ以上のサイズに適切にスケールされた PNG形式のアイコンを追加します。 あなたのアプリケーションアイコンが Driveに表示されるまでに、最大 24時間かかる可能性があります。

あなたのアプリの Drive統合についての詳細を追加する

あなたのアプリをGoogle Driveを統合する方法をセットアップします、それは、あなたのアプリにて Google Driveからファイルを開く方法、および、あなたのアプリが開くことができるファイルタイプを含んでいます。

あなたのアプリで Driveファイルを開く場所を定義する

あなたの Open URLは、ユーザが、あなたのアプリで Google Driveからファイルを開くときに使用されます。 完全修飾ドメイン名を入力したことを確認してください; localhostは動作しません。 G Suite Marketplaceにあなたのアプリをリストするには、この URLの所有権を確認する必要があります。

Google Driveからあなたのアプリに情報を渡すために、あなたの Open URL内に、次のテンプレート変数を含むことができます。 もし、あなたの Open URL内に使用されたテンプレート変数がないならば、すべてのテンプレート変数の JSONエンコード文字列を含んだ stateクエリパラメータが追加されます。

詳細については、ファイルを開くを参照してください。

テンプレート変数 説明
{ids} 開かれているファイル IDの、コンマ区切りのリスト。
{exportIds} エクスポートしているファイル IDの、コンマ区切りのリスト。
{userId} ユーザを一意に識別するプロファイル ID。
{action} 実行中されているアクション。 openあるいは createのいずれかです。

あなたのアプリが開くことができるファイルを定義する

あなたのアプリが開くことができるファイルを定義するには、MIME typesおよび file extensionsを追加します。 標準、canonical types、あるいは Google MIMEタイプのみを含み、それらが、タイプミスおよびスペルミスがないことを確認してください。 もしあなたのアプリがショートカットファイルのみを開くならば、あなたは MIMEタイプを空白のままにすることができます。

  • Default: あなたのアプリが独自に開くよう構築されているファイル。 例えば、画像を重ね、編集するためのネイティブ形式。
  • Secondary: あなたのアプリが開くことができるファイル、しかし、あなたのアプリに固有のものではありません。 例えば、画像編集アプリのための pngおよび jpg画像。

もし、ユーザがファイルを開くことができる Driveアプリを複数インストールしているならば、ユーザが他のアプリを選択するまで、最後にインストールされたアプリが使用されます。

ファイルの作成およびインポートをコントロールする

ユーザがあなたのアプリで新しい Driveファイルを作成することができるかどうかをコントロールするには、Allow users to create new documents using this applicationを有効にします。 もし有効にされているならば、ユーザが Drive内の Newメニューからあなたのアプリケーションを選択したときに、ユーザがリダイレクトされる New URLを提供しなければなりません。

あなたは、Driveファイルをインポートし、あなたのアプリによってサポートされている形式にそれらを変換することを選択することができます。 詳しくは、あなたのアプリにて Google Docsを開き、変換するを参照してください。

次のステップ

Drive APIを有効にし、あなたのアプリの Drive UI統合を構成した後、あなたのアプリをインストールします。