ドライブの UI の [アプリで開く] コンテキスト メニューと統合する

ユーザーがファイルを選択して、ドライブ UI の [アプリで開く] メニュー項目、ドライブのリダイレクト ドライブの UI を構成する 統合をご覧ください。

[インポート]をオンにしてドライブ UI の構成時にボックスが 統合により、ユーザーはアプリ固有のリソースと認証情報の組み合わせを 開くことができます。ドライブの UI を構成する場合 アプリ固有のファイルは「デフォルト MIME タイプ」および デフォルトのファイル拡張子であるのに対し、Google Workspace は ファイルが「セカンダリ MIME タイプ」で[予備のファイル拡張子]を 表示されます。

ユーザーが開くファイルごとに、ドライブが MIME を確認 次のような形式になります。

  • [デフォルトの MIME タイプ] で定義されている MIME タイプの場合ファイル ID は、 渡します。アプリ固有のファイルを扱う方法については アプリ固有のドキュメントのオープン URL を処理するをご覧ください。

  • [セカンダリ MIME タイプ] で定義された MIME タイプの場合場合、 ドライブの UI に、ファイルの種類を尋ねるダイアログが表示されている Google Workspace ファイルを Google Cloud に 変換する必要がありますたとえば ドライブ UI の Google ドキュメント ファイルと「セカンダリ MIME」 タイプ」フィールドが、アプリが text/plain または application/pdf をサポートしていると示された場合、 書式なしテキストに変換するかどうかをユーザーに尋ねるドライブの UI できます。

    Google Workspace の Google Workspace ドキュメントの Open URL を処理するをご覧ください。 Google Workspace のドキュメントと MIME タイプの変換形式のリストについては、 Google Workspace の MIME タイプをエクスポートする ドキュメントをご覧ください

アプリ固有のドキュメントのオープン URL を処理する

ドライブの UI を構成する 統合、 アプリが開くための情報を含むテンプレート変数を受け取る 表示されます。アプリがデフォルトのテンプレート変数セットを受け取る state パラメータ内で指定します。「 アプリ固有の Open URL に対するデフォルトの state 情報は次のとおりです。

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

この出力には次の値が含まれます。

  • ID: 親フォルダの ID。
  • RESOURCE_KEYS: マッピング先のファイル ID の JSON 辞書 固有のリソースキーを使用します。
  • open: 実行されるアクション。Open API を使用している場合、値は open です。 URL を入力します。
  • USER_ID: ユーザーを一意に識別するプロファイル ID。

アプリは次の手順に沿ってこのリクエストに対処する必要があります。

  1. action フィールドの値が open であり、ids フィールドの値が できます。
  2. userId 値を使用して、ユーザーの新しいセッションを作成します。詳細情報 詳しくは、ユーザーとログインに関する確認します
  3. files.get メソッドを使用して、 ファイル メタデータの取得、ファイル コンテンツのダウンロードを ID 値。
  4. リクエストに resourceKeys が設定されている場合は、 X-Goog-Drive-Resource-Keys リクエスト ヘッダー。このモジュールの リソースキーについては、リソースを使用してリンク共有ファイルにアクセスする あります

state パラメータは URL エンコードされているため、アプリでエスケープを処理する必要があります。 JSON として解析します。

Google Workspace ドキュメントの Open URL を処理する

ドライブの UI を構成する 統合の場合、アプリはデフォルトの state パラメータ内のテンプレート変数。デフォルトの state 情報 Google Workspace Open URL の場合は次のようになります。

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

この出力には次の値が含まれます。

  • EXPORT_ID: ファイル ID のカンマ区切りのリスト エクスポート済み(組み込みの Google ドキュメントを開く場合にのみ使用)
  • RESOURCE_KEYS: マッピング先のファイル ID の JSON 辞書 固有のリソースキーを使用します。
  • open: 実行されるアクション。Open API を使用している場合、値は open です。 URL を入力します。
  • USER_ID: ユーザーを識別するプロファイル ID。

アプリは次の手順に沿ってこのリクエストに対処する必要があります。

  1. open の両方を検出して、これがファイルを開くリクエストであることを確認します。 値を state フィールドの値と、exportIds フィールドが存在することを意味しています。

  2. files.get メソッドを使用して、 権限の設定、ファイルのメタデータの取得、 EXPORT_ID 値。

  3. 次のコマンドを使用して、ファイルの内容を変換します: files.export メソッドを使用します。次の Google Workspace ドキュメントを MIME タイプを指定します。

  4. リクエストに resourceKey が設定されている場合は、 X-Goog-Drive-Resource-Keys リクエスト ヘッダー。このモジュールの リソースキーについては、リソースを使用してリンク共有ファイルにアクセスする あります

    Java

    drive/snippets/drive_v3/src/main/java/ExportPdf.java
    import com.google.api.client.googleapis.json.GoogleJsonResponseException;
    import com.google.api.client.http.HttpRequestInitializer;
    import com.google.api.client.http.javanet.NetHttpTransport;
    import com.google.api.client.json.gson.GsonFactory;
    import com.google.api.services.drive.Drive;
    import com.google.api.services.drive.DriveScopes;
    import com.google.auth.http.HttpCredentialsAdapter;
    import com.google.auth.oauth2.GoogleCredentials;
    import java.io.ByteArrayOutputStream;
    import java.io.IOException;
    import java.io.OutputStream;
    import java.util.Arrays;
    
    /* Class to demonstrate use-case of drive's export pdf. */
    public class ExportPdf {
    
      /**
       * Download a Document file in PDF format.
       *
       * @param realFileId file ID of any workspace document format file.
       * @return byte array stream if successful, {@code null} otherwise.
       * @throws IOException if service account credentials file not found.
       */
      public static ByteArrayOutputStream exportPdf(String realFileId) throws IOException {
        // Load pre-authorized user credentials from the environment.
        // TODO(developer) - See https://developers.google.com/identity for
        // guides on implementing OAuth2 for your application.
        GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
            .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
        HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
            credentials);
    
        // Build a new authorized API client service.
        Drive service = new Drive.Builder(new NetHttpTransport(),
            GsonFactory.getDefaultInstance(),
            requestInitializer)
            .setApplicationName("Drive samples")
            .build();
    
        OutputStream outputStream = new ByteArrayOutputStream();
        try {
          service.files().export(realFileId, "application/pdf")
              .executeMediaAndDownloadTo(outputStream);
    
          return (ByteArrayOutputStream) outputStream;
        } catch (GoogleJsonResponseException e) {
          // TODO(developer) - handle error appropriately
          System.err.println("Unable to export file: " + e.getDetails());
          throw e;
        }
      }
    }

    Python

    drive/snippets/drive-v3/file_snippet/export_pdf.py
    import io
    
    import google.auth
    from googleapiclient.discovery import build
    from googleapiclient.errors import HttpError
    from googleapiclient.http import MediaIoBaseDownload
    
    
    def export_pdf(real_file_id):
      """Download a Document file in PDF format.
      Args:
          real_file_id : file ID of any workspace document format file
      Returns : IO object with location
    
      Load pre-authorized user credentials from the environment.
      TODO(developer) - See https://developers.google.com/identity
      for guides on implementing OAuth2 for the application.
      """
      creds, _ = google.auth.default()
    
      try:
        # create drive api client
        service = build("drive", "v3", credentials=creds)
    
        file_id = real_file_id
    
        # pylint: disable=maybe-no-member
        request = service.files().export_media(
            fileId=file_id, mimeType="application/pdf"
        )
        file = io.BytesIO()
        downloader = MediaIoBaseDownload(file, request)
        done = False
        while done is False:
          status, done = downloader.next_chunk()
          print(f"Download {int(status.progress() * 100)}.")
    
      except HttpError as error:
        print(f"An error occurred: {error}")
        file = None
    
      return file.getvalue()
    
    
    if __name__ == "__main__":
      export_pdf(real_file_id="1zbp8wAyuImX91Jt9mI-CAX_1TqkBLDEDcr2WeXBbKUY")

    Node.js

    drive/snippets/drive_v3/file_snippets/export_pdf.js
    /**
     * Download a Document file in PDF format
     * @param{string} fileId file ID
     * @return{obj} file status
     * */
    async function exportPdf(fileId) {
      const {GoogleAuth} = require('google-auth-library');
      const {google} = require('googleapis');
    
      // Get credentials and build service
      // TODO (developer) - Use appropriate auth mechanism for your app
      const auth = new GoogleAuth({
        scopes: 'https://www.googleapis.com/auth/drive',
      });
      const service = google.drive({version: 'v3', auth});
    
      try {
        const result = await service.files.export({
          fileId: fileId,
          mimeType: 'application/pdf',
        });
        console.log(result.status);
        return result;
      } catch (err) {
        // TODO(developer) - Handle error
        throw err;
      }
    }

    PHP

    drive/snippets/drive_v3/src/DriveExportPdf.php
    use Google\Client;
    use Google\Service\Drive;
    function exportPdf()
    {
        try {
            $client = new Client();
            $client->useApplicationDefaultCredentials();
            $client->addScope(Drive::DRIVE);
            $driveService = new Drive($client);
            $realFileId = readline("Enter File Id: ");
            $fileId = '1ZdR3L3qP4Bkq8noWLJHSr_iBau0DNT4Kli4SxNc2YEo';
            $fileId = $realFileId;
            $response = $driveService->files->export($fileId, 'application/pdf', array(
                'alt' => 'media'));
            $content = $response->getBody()->getContents();
            return $content;
    
        }  catch(Exception $e) {
             echo "Error Message: ".$e;
        }
    
    }

変換されたファイルを読み取り専用として表示するか、ユーザーに以下の操作を促すダイアログを表示する 新しいファイル形式で保存します。

state パラメータは URL エンコードされているため、アプリでエスケープを処理する必要があります。 JSON として解析します。

ユーザーと新しいイベント

ドライブのアプリは、すべての「アプリで開く」をイベントとして できます。複数のアカウントを持っているユーザーもいるため、state のユーザー ID は パラメータが現在のセッションと一致しない場合があります。state のユーザー ID が、 パラメータが現在のセッションと一致しない場合、現在のセッションを終了してください リクエストされたユーザーとしてログインします。

Google ドライブの UI からアプリケーションを開くだけでなく、 アプリ内のコンテンツを選択するためのファイル選択ツールを表示する詳細情報 Google Picker をご覧ください。