使用資源金鑰存取連結共用的雲端硬碟檔案

您可以透過 雲端硬碟 UI 或透過 Google Drive API。從以下位置分享: Google 雲端硬碟可以設定使用者能否編輯、加註,或 則只能開啟檔案

資源金鑰有助於防止他人擅自存取檔案。資源金鑰 是系統傳遞的額外參數,可讓使用者存取特定檔案 已經透過連結分享過從未檢視過檔案的使用者 必須提供資源金鑰才能存取。最近看過 檔案,或具備直接存取權,則無需資源金鑰即可存取檔案。

透過連結共用的雲端硬碟檔案只有: 因 type=usertype=group 而能存取檔案的使用者 permissions 資源。使用者的要求 只能使用 type=domain 存取這些透過連結共用的檔案,或是 type=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」資料夾移至「fileId2」的要求 資料夾:fileId3。假設這三個檔案的資源金鑰是 resourceKey1resourceKey2resourceKey3。標題 使用正斜線和逗號分隔這些值建構如下值:

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