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

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

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

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

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

從檔案讀取資源鍵

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

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

files 資源中的欄位會傳回網址,例如 exportLinkswebContentLinkwebViewLink,也會包含 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。假設這三個檔案的資源鍵分別為 resourceKey1resourceKey2resourceKey3。使用正斜線和逗號分隔符號,從這些值建立的標頭如下:

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