资源:属性
附加到应用的公开或私有文件的键值对。
以下限制适用于文件属性:
- 每个文件总共最多 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 |
此属性的键。 |
方法 |
|
---|---|
|
删除属性。 |
|
通过键获取属性。 |
|
向文件添加属性;如果属性已存在,则更新该属性。 |
|
列出文件的属性。 |
|
更新媒体资源。 |
|
更新媒体资源。 |