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

您可以使用 雲端硬碟 UI Google Drive API,與他人共用 Google 雲端硬碟檔案和資料夾。透過雲端硬碟共用檔案時,您可以控管使用者是否能夠編輯檔案、為檔案加上註解,或只能開啟檔案。

資源金鑰可協助防止檔案遭到意外存取。資源金鑰是額外的參數,使用者可以存取透過連結共用的某些檔案。從未檢視過檔案的使用者必須提供資源金鑰,才能存取檔案。近期查看或直接存取檔案的使用者不需要資源金鑰即可存取檔案。

只有透過 type=usertype=group permissions 資源可以存取該檔案的使用者,才能找到透過連結共用的雲端硬碟檔案。如果使用者必須透過 type=domaintype=anyone 權限存取這些連結共用檔案,則向這類要求可能必須具備資源金鑰。

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

從檔案中讀取資源金鑰

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

如果檔案是雲端硬碟捷徑,則捷徑目標的資源鍵會傳回唯讀 shortcutDetails.targetResourceKey 欄位。

files 資源中會傳回網址的欄位 (例如 exportLinkswebContentLinkwebViewLink),也包含 resourceKey。與雲端硬碟 UI 整合的用戶端也可以在 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