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

更新媒体资源。