您可以使用 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