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