返回用户信息

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

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

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

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

获取有关用户的详细信息

如需以 about实例的形式返回有关云端硬盘用户的信息，请使用 get方法。返回的值以字节为单位。

您 必须 在 get 方法中设置 fields 系统 参数，以指定要在响应中返回的字段。在大多数云端硬盘方法中，此操作仅在返回非默认字段时是必需的，但对于 about 资源，此操作是强制性的。如果您省略此参数，该方法会返回错误。如需了解详情，请参阅返回特定字段。

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"
  }
}

列出用户应用

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

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

如果您想指定要在响应中返回的字段，可以设置 fields system parameter。如果您未指定 fields 参数，服务器会返回一组默认字段。如需了解详情，请参阅返回特定字段。

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"
  ]
}

列出带有查询参数的用户应用

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

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

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

• appFilterMimeTypes：使用逗号分隔列表过滤搜索结果，列表内容为 MIME 类型。应用查询范围内的应用（可以打开列出的 MIME 类型）会包含在响应中。如果还提供了 appFilterExtensions，则会返回这两个应用列表的并集。MIME 类型的示例包括 Google 表单的 application/vnd.google-apps.form 和 Google 协作平台的 application/vnd.google-apps.site。如需查看更多 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 的get 方法。

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"
}

相关主题

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

• 如需在云端硬盘中创建文件，请参阅创建和管理文件。

• 如需在创建或更新文件时上传文件数据，请参阅上传文件 数据。

• 如需下载和导出文件，请参阅下载和导出 文件。