与云端硬盘界面的“打开方式”上下文菜单集成

用户选择文件并点击云端硬盘界面的“打开方式” 菜单项、云端硬盘重定向 用户访问该应用的打开网址（在配置云端硬盘界面） 集成。

如果您选中了“导入”框（配置云端硬盘界面时） 用户可以选择应用特有和 要打开的 Google Workspace 文件。配置云端硬盘界面时 集成，则特定于应用的文件在“默认 MIME 类型”中定义和 “默认文件扩展名”而 Google Workspace 文件都是在“次要 MIME 类型”中定义的，和“次要文件扩展名” 字段。

对于用户想要打开的每个文件，云端硬盘都会检查其 MIME 与定义的默认和次要 MIME 类型进行对比：

  • 对于“默认 MIME 类型”中定义的 MIME 类型字段中，文件 ID 为 传递给您的应用如需了解如何处理应用专属文件， 请参阅处理应用专属文档的打开网址。

  • 对于“次要 MIME 类型”中定义的 MIME 类型字段， 云端硬盘界面显示一个对话框，询问用户要使用哪种文件类型 将 Google Workspace 文件转换为例如，如果您选择 云端硬盘界面中的 Google 文档文件和“辅助 MIME” 类型"字段表明您的应用支持 text/plain 或 application/pdf， 云端硬盘界面询问用户是否要转换为纯文本 或 PDF。

    有关如何使用 Google Workspace 的信息 请参阅处理 Google Workspace 文档的打开网址。 如需查看 Google Workspace 文档和 MIME 类型转换格式列表， 请参阅导出 Google Workspace 的 MIME 类型 文档。

处理应用专属文档的打开网址

如配置云端硬盘界面 集成， 您的应用会收到模板变量，其中包含应用要打开的信息 文件。您的应用会收到一组默认的模板变量 放在 state 参数中。通过 特定于应用的打开网址的默认 state 信息为：

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

此输出包括以下值：

  • ID：父级文件夹的 ID。
  • RESOURCE_KEYS：映射到文件 ID 的 JSON 字典 各自的资源键
  • open：正在执行的操作。使用 Open 时，值为 open 网址。
  • USER_ID：唯一标识用户的个人资料 ID。

您的应用必须按以下步骤处理此请求：

  1. 验证 action 字段的值是否为 open，以及 ids 字段的值是否为 存在。
  2. 使用 userId 值为用户创建一个新会话。有关 有关已登录用户的信息，请参阅用户和新活动。
  3. 使用 files.get 方法进行检查 获取文件元数据，以及使用 ID 值。
  4. 如果请求中设置了 resourceKeys，请将 X-Goog-Drive-Resource-Keys 请求标头。如需详细了解 请参阅使用资源访问链接共享文件 密钥。

state 参数经过了网址编码，因此您的应用必须处理转义 字符并将其解析为 JSON。

处理 Google Workspace 文档的打开网址

如配置云端硬盘界面 集成时，您的应用会收到一组默认的 state 参数中的模板变量。默认的 state 信息 为：

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

此输出包括以下值：

  • EXPORT_ID：以英文逗号分隔的文件 ID 列表， 已导出（仅在打开内置 Google 文档时使用）。
  • RESOURCE_KEYS：映射到文件 ID 的 JSON 字典 各自的资源键
  • open：正在执行的操作。使用 Open 时，值为 open 网址。
  • 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 参数经过了网址编码，因此您的应用必须处理转义 字符并将其解析为 JSON。

用户和新活动

云端硬盘应用应将所有“打开方式”将事件视为潜在的 登录。某些用户可能有多个账号，因此 state 中的用户 ID 参数可能与当前会话不匹配。如果 state 中的用户 ID 参数与当前会话不匹配，请结束您的 并以请求的用户的身份登录。

除了从 Google 云端硬盘界面打开应用外，应用还可以 显示一个文件选择器，用于在应用中选择内容。有关 信息，请参阅 Google 选择器。