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 云端硬盘应用。
如需以 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
,则返回生成的两个应用列表的并集。扩展程序示例包括适用于 Microsoft Word 的docx
和适用于 Microsoft PowerPoint 的pptx
。如需查看文件扩展名的更多示例,请参阅导出 Google Workspace 文档的 MIME 类型。以下代码示例展示了如何以查询参数的形式提供多个文件扩展名:
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 的 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。
相关主题
您可以尝试以下后续步骤: