data對象的保留屬性名

JSON對象的_data_屬性可能包含以下屬性。

data.kind

屬性值類型: 字符串(sting)
父節(jié)點: data

_kind_屬性是對某個特定的對象存儲何種類型的信息的指南?？梢园阉旁赺data_層次，或_items_的層次，或其它任何有助于區(qū)分各類對象的對象中。如果_kind_對象被提供，它應該是對象的第一個屬性（詳見下面的_屬性順序_部分）。

示例：

// "Kind" indicates an "album" in the Picasa API.
{"data": {"kind": "album"}}

data.fields

屬性值類型: 字符串(string)
父節(jié)點: data

表示做了部分GET之后響應中出現(xiàn)的字段，或做了部分PATCH之后出現(xiàn)在請求中的字段。該屬性僅在做了部分GET請求/批處理時存在，且不能為空。

示例：

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

data.etag

屬性值類型: 字符串(string)
父節(jié)點: data

響應時提供etag。關于GData APIs中的ETags詳情可以在這里找到：http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning

示例：

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

data.id

屬性值類型: 字符串(string)
父節(jié)點: data

一個全局唯一標識符用于引用該對象。_id_屬性的具體細節(jié)都留給了服務。

示例：

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

data.lang

屬性值類型: 字符串(string)(格式由BCP 47指定)
父節(jié)點: data (或任何子元素)

表示該對象內其他屬性的語言。該屬性模擬HTML的_lang_屬性和XML的_xml:lang_屬性。值應該時BCP 47中定義的一種語言值。如果一個單一的JSON對象包含的數(shù)據(jù)有多種語言，服務負責制定和標明的lang屬性的適當位置。

示例：

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

data.updated

屬性值類型: 字符串(string)(格式由RFC 3339指定)
父節(jié)點: data

指明條目更新的最后日期/時間(RFC 3339)，由服務規(guī)定。

示例：

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

data.deleted

屬性值類型: 布爾(boolean)
父節(jié)點: data (或任何子元素)

一個標記元素，當出現(xiàn)時，表示包含的條目已被刪除。如果提供了刪除屬性，它的值必須為true;為_false_會導致混亂，應該避免。

示例：

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

data.items

屬性值類型: 數(shù)組(array)
父節(jié)點: data

屬性名_items_被保留用作表示一組條目(例如,Picasa中的圖片，YouTube中的視頻)。這種結構的目的是給與當前結果相關的集合提供一個標準位置。例如，知道頁面上的_items_是數(shù)組，JSON輸出便可能插入一個通用的分頁系統(tǒng)。如果_items_存在，它應該是_data_對象的最后一個屬性。（詳見下面的_屬性順序_部分）。

示例：

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