產生 CSE 權杖,可用於建立或更新 CSE 檔案。
HTTP 要求
GET https://www.googleapis.com/drive/v3/files/generateCseToken
這個網址使用 gRPC 轉碼語法。
查詢參數
| 參數 | |
|---|---|
fileId |
要產生 JWT 的檔案 ID。如未提供,系統會產生 ID。 |
parent |
檔案預期父項的 ID。用於為新的 CSE 檔案產生 JWT。如果指定了父項,系統會擷取該父項,如果父項是共用雲端硬碟項目,系統會使用共用雲端硬碟的政策,判斷應使用的 KACLS。 在單一要求中同時指定 fileId 和 parent 無效。 |
要求主體
要求主體必須為空白。
回應主體
用來產生 CSE 檔案的 JWT 和相關中繼資料。
如果成功,回應主體會含有以下結構的資料:
| JSON 表示法 |
|---|
{ "fileId": string, "currentKaclsId": string, "currentKaclsName": string, "jwt": string, "kind": string } |
| 欄位 | |
|---|---|
fileId |
產生 JWT 的檔案 ID。 |
currentKaclsId |
與 JWT 相關聯的目前金鑰 ACL 服務 (KACLS) ID。 |
currentKaclsName |
傳回的 KACL ID 所指向的 KACL 名稱。 |
jwt |
檔案的已簽署 JSON Web Token (JWT)。 |
kind |
僅供輸出。表示資源的種類。值:固定字串 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/docshttps://www.googleapis.com/auth/drive
部分範圍受到限制,應用程式必須通過安全評估才能使用。詳情請參閱授權指南。