返回用户信息

Google 云端硬盘提供了两个选项来收集云端硬盘用户的相关信息：

  • 使用 about 资源，您可以检索有关用户、用户的云端硬盘设置及其系统功能的信息。

  • 使用 apps 资源，您可以检索用户已安装应用的列表，其中包含每个应用支持的 MIME 类型、文件扩展名和其他详细信息。

本指南介绍了如何在云端硬盘中检索用户信息。

提取用户相关信息

如需将云端硬盘用户的信息作为 about 的实例返回，请使用 about.get 方法。about.get 方法需要在方法调用中使用 fields 查询参数。返回的值以字节为单位。如需了解详情，请参阅返回文件的特定字段。

显示示例

以下代码示例展示了如何在请求中提供多个 fields 作为查询参数。响应会返回请求的字段值。

请求

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

答案

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

响应包括以下值：

  • DISPLAY_NAME：纯文本形式的用户姓名。
  • PHOTO_LINK：用户个人资料照片的网址。
  • PERMISSION_ID：用户在 Permission 资源中的 ID。
  • EMAIL_ADDRESS：用户的电子邮件地址

提取有关用户应用的信息

Google 云端硬盘应用列在 Google Workspace Marketplace 中，用于让云端硬盘更方便，例如 Google 文档应用或 Google 文档中用于对文档签名的插件。如需了解详情，请参阅使用 Google 云端硬盘应用。

如需将用户所有已安装应用的列表作为 apps 的实例返回，请使用不带任何参数的 apps.list 方法。

显示示例

以下代码示例展示了如何在请求中返回用户所有已安装应用的列表。响应会返回请求的字段值。

请求

GET https://www.googleapis.com/drive/v3/apps

答案

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

响应包括以下值：

  • ID：应用 ID。
  • PRODUCT_ID：此应用的商品详情 ID。

使用查询参数列出用户应用

要查找特定应用，请使用一个或多个可选查询参数：

  • appFilterExtensions：使用以英文逗号分隔的文件扩展名列表过滤搜索结果。响应中包含应用查询范围内可以打开所列文件扩展名的应用。如果还提供了 appFilterMimeTypes，则会返回两个所生成的应用列表的并集。扩展程序示例包括 docx for Microsoft Word 和 pptx for Microsoft PowerPoint。如需查看文件扩展名的更多示例，请参阅导出 Google Workspace 文档的 MIME 类型。

    以下代码示例展示了如何以查询参数的形式提供多个文件扩展名：GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx。

  • appFilterMimeTypes：使用以英文逗号分隔的 MIME 类型列表过滤搜索结果。响应中包含应用查询范围内可以打开所列 MIME 类型的应用。如果同时还提供了 appFilterExtensions，则会返回两个生成的应用列表的并集。MIME 类型示例包括 application/vnd.google-apps.form（适用于 Google 表单）和 application/vnd.google-apps.site（适用于 Google 协作平台）。如需查看 MIME 类型的更多示例，请参阅 Google Workspace 和 Google 云端硬盘支持的 MIME 类型。

    以下代码示例展示了如何以查询参数的形式提供多种 MIME 类型：GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site。

  • languageCode：使用 BCP 47 定义的语言或语言区域代码（包含一些采用 Unicode LDML 格式的扩展名）过滤搜索结果。语言代码示例包括英语（美国）的 en-us 和法语（加拿大）的 fr-ca。

    以下代码示例展示了如何以查询参数的形式提供多种语言代码：GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca。

按 ID 获取用户应用

如需将详细的应用信息下载为 apps 的实例，请使用带有应用 ID 的 apps.get 方法。

显示示例

以下代码示例展示了如何在请求中提供 appId 作为查询参数。响应会返回请求的字段值。

请求

GET https://www.googleapis.com/drive/v3/apps/APP_ID

答案

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

响应包括以下值：

  • ID：应用 ID。
  • PRODUCT_ID：此应用的商品详情 ID。

您可以尝试以下后续步骤：