ドライブの UI 統合を構成する

ユーザーがファイルを作成または開いたときに Google ドライブにアプリを表示するには、 まず、ドライブのユーザー インターフェース（UI）の統合を設定する必要があります。 アプリケーションを Google Workspace Marketplace:

Drive API を有効にする

Google API を使用するには、事前に Google Cloud できます。1 つの Google Cloud で 1 つ以上の API を有効にできます。 できます。

Google ドライブの UI との統合を開始するには、 Drive APIこれにより、API と UI 統合にアクセスできるようになります。 説明します。

  • Google Cloud コンソールで、Google Drive API を有効にします。

    API の有効化

ドライブの UI の統合を設定する

  1. Google API Console で、メニュー アイコン に移動します。 > API と[サービス] > [有効な API とサービスをご覧ください。

    [有効な API とサービス

  2. API とサービス ダッシュボードで [Google Drive API] をクリックします。「 Google Drive API の構成ページが表示されます。
  3. [ドライブの UI の統合] タブを選択します。
  4. （省略可）[アプリケーション名] フィールドに名前を入力します。アプリケーション ドライブの [アプリの管理] タブでユーザーに表示される名前 設定。
  5. （省略可）[簡単な説明] に、簡単な説明を 1 行で入力します。 表示されます。簡単な説明は、Google Chat の ドライブの設定。
  6. （省略可）[詳しい説明] フィールドに詳細な説明を入力します。

  7. アプリケーション アイコンを 1 つ以上アップロードして、ユーザーの [アプリで開く] をアクセスできます。 アイコンは、背景が透明な PNG 形式にする必要があります。アイコンは 最長 24 時間でドライブに表示されます。

  8. ドライブ UI の [アプリで開く]メニュー [アイテム] 内のアプリへの URL を [URL を開く] フィールド。この URL は [アプリケーションで開く] で使用されます。アクセスできます。

    • この URL には完全修飾ドメイン名を含める必要があります。localhost は次のことをしない: 説明します。
    • この URL は、アプリケーションの対象ユーザーからアクセスできる必要があります。 公開用など、アプリケーションの複数のバージョンがあり、 1 つは限定リリースであり 固有の URL を使用する必要がありますその後、別のアプリを作成できます。 構成を示しています。
    • 必要なこと この URL の所有権を確認してください Google Workspace Marketplace にアプリを掲載する必要があります。
    • デフォルトでは、state クエリ パラメータがこの URL に追加され、 ドライブ UI からアプリにエクスポートできます。詳細については、 state パラメータの内容については、state パラメータです。
    で確認できます。

  9. （省略可）デフォルトの MIME タイプとファイル拡張子を [デフォルト MIME タイプ] フィールドと [デフォルトのファイル拡張子] フィールドデフォルト MIME タイプとファイル拡張子は、アプリが独自に構築するファイルを表します。 表示されます。たとえば、アプリでレイヤリング / 暗号化用の組み込みフォーマットが開く場合があります。 画像の編集などに使用できます。標準のメディアのみを含める 種類 入力ミスやスペルミスがないことも 確認しますアプリが開くだけの場合 使用する場合は、MIME タイプは空白のままで構いません。

  10. （省略可）[セカンダリ [MIME タイプ] と [サブファイル拡張子] の項目。セカンダリ MIME タイプ ファイル拡張子は、アプリが開くことのできるファイルを表しますが、 追加できますたとえば、画像編集用のアプリで、 PNG と JPG 画像標準のメディアのみを含める 種類 入力ミスやスペルミスがないことも 確認しますアプリが開くだけの場合 使用する場合は、MIME タイプは空白のままで構いません。

  11. ドライブの UI の [New] ] ボタンを使用して、ユーザーに [Creating files] チェックボックスをオンにします。[New URL] とオプションの [ドキュメント名] 欄が表示されます。

    • この URL には完全修飾ドメイン名を含める必要があります。localhost は次のことをしない: 説明します。
    • このアセットの所有権を確認してください。 URL Google Workspace Marketplace にアプリを掲載する必要があります。
    • デフォルトでは、state クエリ パラメータがこの URL に追加され、 ドライブ UI からアプリにエクスポートできます。詳細については、 state パラメータの内容については、state パラメータです。

  12. [新しい URL] フィールドに URL を入力します。この URL は "New"ボタン アプリケーションにリダイレクトします。

  13. （省略可）Google Workspace でサポートされているファイルをアプリで開けるようにするには、 [インポート] チェックボックスをオンにします。

  14. （省略可）共有ドライブ上のファイルをアプリで管理する必要がある場合は、 共有ドライブのサポート] チェックボックスをオンにします。Google Cloud で 詳細は、共有ドライブの実装 サポートをご覧ください。

  15. [送信] をクリックします。

drive.install スコープをリクエストする

アプリが [アプリで開く]または「New」メニューで https://www.googleapis.com/auth/drive.install スコープの統合をリクエストする 説明します。このスコープをリクエストすると、ユーザーは 次のようなダイアログが表示されます。

Google ドライブ UI のインストール ダイアログ
図 1. ドライブ UI のスコープを使用する場合のインストール ダイアログ

ドライブアプリでリクエストできるスコープについて詳しくは、 リクエスト方法については、API 固有の認可と認証をご覧ください。 をご覧ください。

state パラメータ

デフォルトでは、state パラメータは [Open URL] と [New URL] の両方に追加されます。 を使用して、ドライブの UI からアプリにデータを渡します。このパラメータ JSON でエンコードされた文字列で、テンプレート変数と 追加します。含まれる変数は、使用する URL のタイプ（ URL または新しい URL）:

テンプレート変数 説明 URL アプリケーション
{ids} 開かれているファイル ID のカンマ区切りのリスト。 URL を開く
{exportIds} エクスポートするファイル ID のカンマ区切りのリスト（専用 。 URL を開く
{resourceKeys} それぞれのリソースにマッピングされたファイル ID の JSON 辞書 できます。 URL を開く
{folderId} 親フォルダの ID。 新しい URL
{folderResourceKey} 親フォルダのリソースキー。 新しい URL
{userId} ユーザーを識別するプロフィール ID。 オープン URL と新しい URL
{action} 実行中のアクション。値は open（オープン URL または create を使用する場合） 注意する必要があります オープン URL と新しい URL

state パラメータは URL エンコードされているため、アプリでエスケープを処理する必要があります。 JSON として解析します。アプリは create の値を ファイル作成リクエストを検証する state パラメータ。

新しい URL の JSON 状態情報の例

新しい URL の state 情報は次のとおりです。

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

オープン URL の JSON 状態情報の例

オープン URL の state 情報は次のとおりです。

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

ID とリソースキーは、ファイルのメタデータの取得とファイルのダウンロードに使用されます。 説明します。ファイル ID とアクセス トークンを取得したら、アプリは 権限、ファイルのメタデータの取得、ファイルの内容のダウンロードを files.get メソッド内。

インストール済みのアプリは、アプリから起動するアクションを作成、管理し、開くことができる必要があります。 できます。詳細については、Google Kubernetes Engine ドライブの UI の「新機能」ボタンまたは ドライブ UI の [アプリで開く] と統合するコンテキスト メニュー。