このページは Cloud Translation API によって翻訳されました。

ドライブの 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 の統合を設定する

Google API Console で、メニューアイコンに移動します。 > API と[サービス] > [有効な API とサービスをご覧ください。
[有効な API とサービス
API とサービスダッシュボードで [Google Drive API] をクリックします。「 Google Drive API の構成ページが表示されます。
[ドライブの UI の統合] タブを選択します。
（省略可）[アプリケーション名] フィールドに名前を入力します。アプリケーションドライブの [アプリの管理] タブでユーザーに表示される名前設定。
（省略可）[簡単な説明] に、簡単な説明を 1 行で入力します。表示されます。簡単な説明は、Google Chat のドライブの設定。
（省略可）[詳しい説明] フィールドに詳細な説明を入力します。
アプリケーションアイコンを 1 つ以上アップロードして、ユーザーの [アプリで開く] をアクセスできます。アイコンは、背景が透明な PNG 形式にする必要があります。アイコンは最長 24 時間でドライブに表示されます。

注: ドキュメントアイコンは非推奨となりました。アプリケーションアイコンが表示されます。ショートカットファイルやサードパーティのショートカットファイルにアクセスできます標準的なアイコンのセットを使用
ドライブ UI の [アプリで開く]メニュー [アイテム] 内のアプリへの URL を [URL を開く] フィールド。この URL は [アプリケーションで開く] で使用されます。アクセスできます。
- この URL には完全修飾ドメイン名を含める必要があります。localhost は次のことをしない: 説明します。
- この URL は、アプリケーションの対象ユーザーからアクセスできる必要があります。公開用など、アプリケーションの複数のバージョンがあり、 1 つは限定リリースであり固有の URL を使用する必要がありますその後、別のアプリを作成できます。構成を示しています。
- 必要なことこの URL の所有権を確認してください Google Workspace Marketplace にアプリを掲載する必要があります。
- デフォルトでは、state クエリパラメータがこの URL に追加され、ドライブ UI からアプリにエクスポートできます。詳細については、 state パラメータの内容については、state パラメータです。
で確認できます。
警告: OAuth 2.0 同意画面を自動的に表示するオプションは、非推奨です。このチェックボックスはオンにしないでください。アプリケーションは、すべての認証プロセスと
（省略可）デフォルトの MIME タイプとファイル拡張子を [デフォルト MIME タイプ] フィールドと [デフォルトのファイル拡張子] フィールドデフォルト MIME タイプとファイル拡張子は、アプリが独自に構築するファイルを表します。表示されます。たとえば、アプリでレイヤリング / 暗号化用の組み込みフォーマットが開く場合があります。画像の編集などに使用できます。標準のメディアのみを含める種類入力ミスやスペルミスがないことも確認しますアプリが開くだけの場合使用する場合は、MIME タイプは空白のままで構いません。
（省略可）[セカンダリ [MIME タイプ] と [サブファイル拡張子] の項目。セカンダリ MIME タイプファイル拡張子は、アプリが開くことのできるファイルを表しますが、追加できますたとえば、画像編集用のアプリで、 PNG と JPG 画像標準のメディアのみを含める種類入力ミスやスペルミスがないことも確認しますアプリが開くだけの場合使用する場合は、MIME タイプは空白のままで構いません。

注: ユーザーが複数のドライブアプリをインストールし、ユーザーが別のアプリを選択するまで、最後にインストールされたアプリが使われます。アプリ。
ドライブの UI の [New] ] ボタンを使用して、ユーザーに [Creating files] チェックボックスをオンにします。[New URL] とオプションの [ドキュメント名] 欄が表示されます。
- この URL には完全修飾ドメイン名を含める必要があります。localhost は次のことをしない: 説明します。
- このアセットの所有権を確認してください。 URL Google Workspace Marketplace にアプリを掲載する必要があります。
- デフォルトでは、state クエリパラメータがこの URL に追加され、ドライブ UI からアプリにエクスポートできます。詳細については、 state パラメータの内容については、state パラメータです。
[新しい URL] フィールドに URL を入力します。この URL は "New"ボタンアプリケーションにリダイレクトします。

注: [ドキュメント名] フィールドは空白のままにします。このフィールドは使用されなくなりました。
（省略可）Google Workspace でサポートされているファイルをアプリで開けるようにするには、 [インポート] チェックボックスをオンにします。
（省略可）共有ドライブ上のファイルをアプリで管理する必要がある場合は、 共有ドライブのサポート] チェックボックスをオンにします。Google Cloud で詳細は、共有ドライブの実装サポートをご覧ください。
[送信] をクリックします。

`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 メソッド内。