data 对象中的保留属性名

JSON 对象的 data 属性可以包含以下属性。

data.kind

属性值类型：string | 父级：data

kind 属性用于指示此特定对象存储的信息类型。它可以出现在 data 级别、items 级别，或任何有助于区分不同类型对象的对象中。如果存在 kind 对象，它应该是对象中的第一个属性（详见下面的”属性排序”部分）。 示例：

// "Kind" 在 Picasa API 中表示一个 "album"。
{"data": {"kind": "album"}}

data.fields

属性值类型：string | 父级：data

表示执行部分 GET 时响应中存在的字段，或执行部分 PATCH 时请求中存在的字段。此属性仅应在部分 GET/PATCH 期间存在，且不应为空。 示例：

{
  "data": {
    "kind": "user",
    "fields": "author,id",
    "id": "bart",
    "author": "Bart"
  }
}

data.etag

属性值类型：string | 父级：data

表示响应的 etag。有关 GData API 中 ETag 的详细信息可以在这里找到：https://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning  示例：

{"data": {"etag": "W/\"C0QBRXcycSp7ImA9WxRVFUk.\""}}

data.id

属性值类型：string | 父级：data

用于引用对象的全局唯一字符串。id 属性的具体细节由服务决定。 示例：

{"data": {"id": "12345"}}

data.lang

属性值类型：string（按 BCP 47 指定格式） | 父级：data（或任何子元素）

指示此对象中其余属性的语言。此属性模仿 HTML 的 lang 属性和 XML 的 xml:lang 属性。值应该是 BCP 47  中定义的语言值。如果单个 JSON 对象包含多种语言的数据，服务负责开发和记录 lang 属性的适当位置。 示例：

{"data": {
  "items": [
    { "lang": "en",
      "title": "Hello world!" },
    { "lang": "fr",
      "title": "Bonjour monde!" }
  ]}
}

data.updated

属性值类型：string（按 RFC 3339 指定格式） | 父级：data

表示项目最后更新的日期/时间（RFC 3339 ），由服务定义。 示例：

{"data": {"updated": "2007-11-06T16:34:41.000Z"}}

data.deleted

属性值类型：boolean | 父级：data（或任何子元素）

一个标记元素，存在时表示包含的条目已被删除。如果 deleted 存在，其值必须为 true；值为 false 可能会造成混淆，应避免使用。 示例：

{"data": {
  "items": [
    { "title": "A deleted entry",
      "deleted": true
    }
  ]}
}

data.items

属性值类型：array | 父级：data

属性名 items 被保留用于表示项目数组（例如，Picasa 中的照片，YouTube 中的视频）。此结构旨在为与当前结果相关的集合提供标准位置。例如，JSON 输出可以插入到一个通用的分页系统中，该系统知道对 items 数组进行分页。如果 items 存在，它应该是 data 对象中的最后一个属性（详见下面的”属性排序”部分）。 示例：

{
  "data": {
    "items": [
      { /* Object #1 */ },
      { /* Object #2 */ },
      ...
    ]
  }
}