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

更新媒体资源。