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

您可以使用 Drive UI 或 Google Drive API，與其他人共用 Google 雲端硬碟檔案和資料夾。透過雲端硬碟共用檔案時，你可以控管共用對象是否可以編輯檔案、為檔案新增註解，或是只允許對方開啟檔案。

資源金鑰有助於防止檔案遭到意外存取。資源鍵是傳遞的額外參數，可讓使用者存取已使用連結共用的特定檔案。未曾查看檔案的使用者必須提供資源金鑰，才能取得存取權。近期曾查看檔案或可直接存取檔案的使用者，無須提供資源金鑰即可存取檔案。

只有透過 type=user 或 type=group permissions 資源存取檔案的使用者，才能透過連結存取雲端硬碟檔案。如果使用者只透過 type=domain 或 type=anyone 權限存取這些連結共用檔案，可能需要資源索引鍵。

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

從檔案讀取資源鍵

Drive API 會在 files 資源的唯讀 resourceKey 欄位中，傳回檔案的資源鍵。

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

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

在要求中設定資源鍵

系統會在 X-Goog-Drive-Resource-Keys HTTP 標頭上設定 Drive API 要求參照的所有檔案資源鍵。

向 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