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

您可以使用 Drive UI 或 Google Drive API，與他人共用 Google 雲端硬碟檔案和資料夾。透過雲端硬碟共用檔案時，您可以指定共用對象可否編輯檔案、對檔案加註，或只能開啟檔案。

資源金鑰有助於防止非預期的人士存取檔案。資源金鑰是傳遞的額外參數，可讓使用者存取透過連結共用的特定檔案。如果使用者未曾檢視該檔案，就必須提供資源金鑰才能存取。如果使用者最近曾查看檔案，或是可以直接存取檔案，就不需要資源金鑰。

如果雲端硬碟檔案是透過連結共用，只有可存取該檔案的使用者才能透過 type=user 或 type=group permissions 資源找到檔案。如果使用者只具備 type=domain 或 type=anyone 權限，只能透過連結存取這些檔案，可能需要資源金鑰才能存取。

如要進一步瞭解權限，請參閱共用檔案、資料夾和雲端硬碟。如需角色完整清單和各角色允許執行的作業，請參閱「角色與權限」。

從檔案讀取資源金鑰

在 files 資源的唯讀 resourceKey 欄位中，雲端硬碟 API 會傳回檔案的資源金鑰。

如果檔案是雲端硬碟捷徑，系統會在唯讀的 shortcutDetails.targetResourceKey 欄位中傳回捷徑目標的資源金鑰。

files 資源中會傳回網址的欄位 (例如 exportLinks、webContentLink 和 webViewLink) 也包含 resourceKey。整合雲端硬碟 UI 的用戶端也可以在 state 參數中使用 resourceKeys。詳情請參閱「下載及匯出檔案」。

在要求中設定資源鍵

要求參照的任何檔案，其資源金鑰都會在 X-Goog-Drive-Resource-Keys HTTP 標頭中設定。

向 Drive API 發出的要求可透過 X-Goog-Drive-Resource-Keys HTTP 標頭指定一或多個資源金鑰。

語法

檔案 ID 和資源金鑰組會使用正斜線 (/) 分隔符號，設定在標頭中。標頭是透過逗號 (,) 分隔符號，合併所有檔案 ID 和資源鍵值組建而成。

舉例來說，假設您要求將檔案 fileId1 從資料夾 fileId2 移至資料夾 fileId3。假設這三個檔案的資源鍵分別為 resourceKey1、resourceKey2 和 resourceKey3。使用正斜線和逗號分隔符號，從這些值建構的標頭如下：

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