REST Resource: properties

資源:屬性

附加至檔案 (可由應用程式公開或不公開) 的鍵/值組合。

檔案屬性適用以下限制:

  • 每個檔案總計不得超過 100 個屬性
  • 每個應用程式最多可加入 30 個私有屬性
  • 最多只能有 30 個公開資源
  • 以 UTF-8 編碼的單一屬性 (鍵 + 值) 字串大小上限為 124 個位元組

部分資源方法 (例如 properties.update) 需要 propertyKey。使用 properties.list 方法擷取屬性的金鑰。

JSON 表示法
{
  "selfLink": string,
  "value": string,
  "visibility": string,
  "kind": string,
  "etag": string,
  "key": string
}
欄位
value

string

這個屬性的值。

visibility

string

這項資源的瀏覽權限。允許的值為 PRIVATE (預設值) 和 PUBLIC。私人屬性只能透過經過驗證的要求擷取。已驗證的要求會使用透過 OAuth 2 用戶端 ID 取得的存取權杖。您無法使用 API 金鑰擷取不公開屬性。

kind

string

僅供輸出。一律為 drive#property

etag

string

僅供輸出。屬性的 ETag。

key

string

這個屬性的鍵。

方法

delete

刪除屬性。

get

透過索引鍵取得屬性。

insert

將屬性新增至檔案,或更新已存在的屬性。

list

列出檔案的屬性。

patch

更新屬性。

update

更新屬性。