資源:屬性
附加至檔案 (可由應用程式公開或不公開) 的鍵/值組合。
檔案屬性適用以下限制:
- 每個檔案總計不得超過 100 個屬性
- 每個應用程式最多可加入 30 個私有屬性
- 最多只能有 30 個公開資源
- 以 UTF-8 編碼的單一屬性 (鍵 + 值) 字串大小上限為 124 個位元組
部分資源方法 (例如 properties.update
) 需要 propertyKey
。使用 properties.list
方法擷取屬性的金鑰。
JSON 表示法 |
---|
{ "selfLink": string, "value": string, "visibility": string, "kind": string, "etag": string, "key": string } |
欄位 | |
---|---|
selfLink |
僅供輸出。返回這項資源的連結。 |
value |
這個屬性的值。 |
visibility |
這項資源的瀏覽權限。允許的值為 PRIVATE (預設值) 和 PUBLIC。私人屬性只能透過經過驗證的要求擷取。已驗證的要求會使用透過 OAuth 2 用戶端 ID 取得的存取權杖。您無法使用 API 金鑰擷取不公開屬性。 |
kind |
僅供輸出。一律為 |
etag |
僅供輸出。屬性的 ETag。 |
key |
這個屬性的鍵。 |
方法 |
|
---|---|
|
刪除屬性。 |
|
透過索引鍵取得屬性。 |
|
將屬性新增至檔案,或更新已存在的屬性。 |
|
列出檔案的屬性。 |
|
更新屬性。 |
|
更新屬性。 |