使用资源密钥访问链接共享的云端硬盘文件

您可以使用 与他人共享 Google 云端硬盘文件和文件夹 云端硬盘界面或通过 Google Drive API。如果您通过以下来源进行分享: 云端硬盘,您就可以控制用户能否编辑、评论或 而是仅打开文件

资源密钥有助于保护您的文件免遭意外访问。资源键 是传递的附加参数,以便用户能够访问 以及通过链接分享的视频之前未查看过文件的用户 必须提供资源密钥才能获得访问权限。最近查看过 或直接访问文件,则无需资源密钥即可访问该文件。

对于通过链接共享的云端硬盘文件,只有 因 type=usertype=group 而可以访问该文件的用户 permissions 资源。来自用户的请求 只能使用 type=domaintype=anyone 权限可能需要资源密钥。

如需详细了解权限,请参阅共享文件、文件夹和云端硬盘。如需查看角色和操作的完整列表, 请参阅角色和权限

从文件中读取资源密钥

Drive API 在只读实例中返回文件的资源密钥, files 资源的 resourceKey 字段。

如果文件是云端硬盘快捷方式, 快捷方式目标的资源键会在只读实例中返回, shortcutDetails.targetResourceKey 字段。

files 资源中会返回网址的字段, (例如 exportLinkswebContentLinkwebViewLink)也会包含 resourceKey。与云端硬盘界面集成的客户端还可以 使用 state 中的 resourceKeys 参数。有关详情,请参阅下载和导出 文件

设置请求的资源密钥

对 Drive API 的请求引用的任何文件的资源键 在 X-Goog-Drive-Resource-Keys HTTP 标头中设置。

向 Drive API 发出的请求可以指定一个或多个资源密钥 X-Goog-Drive-Resource-Keys HTTP 标头。

语法

使用正斜杠在标头上设置文件 ID 和资源密钥对 (/) 分隔符。标头是通过组合所有文件 ID 和资源来构建的, 使用英文逗号 (,) 分隔符进行分隔。

例如,假设要将文件 fileId1 从文件夹 fileId2 移至 文件夹“fileId3”。假设这三个文件的资源密钥为 resourceKey1resourceKey2resourceKey3。标头 使用正斜线和逗号分隔符根据这些值构建而成:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3