ユーザーがファイルを作成または開いたときに 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 を有効にします。
ドライブの UI の統合を設定する
- Google API Console で、メニュー アイコン > 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
パラメータです。
- この URL には完全修飾ドメイン名を含める必要があります。
(省略可)デフォルトの 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 を入力します。この URL は "New"ボタン アプリケーションにリダイレクトします。
(省略可)Google Workspace でサポートされているファイルをアプリで開けるようにするには、 [インポート] チェックボックスをオンにします。
(省略可)共有ドライブ上のファイルをアプリで管理する必要がある場合は、 共有ドライブのサポート] チェックボックスをオンにします。Google Cloud で 詳細は、共有ドライブの実装 サポートをご覧ください。
[送信] をクリックします。
drive.install
スコープをリクエストする
アプリが [アプリで開く]または「New」メニューで
https://www.googleapis.com/auth/drive.install
スコープの統合をリクエストする
説明します。このスコープをリクエストすると、ユーザーは
次のようなダイアログが表示されます。
![Google ドライブ UI のインストール ダイアログ](https://developers-dot-devsite-v2-prod.appspot.com/static/drive/images/install-scope.png?authuser=6&hl=ja)
ドライブアプリでリクエストできるスコープについて詳しくは、 リクエスト方法については、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 の [アプリで開く] と統合するコンテキスト メニュー。