data對(duì)象的保留屬性名

JSON對(duì)象的_data_屬性可能包含以下屬性。

data.kind

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

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

示例：

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

data.fields

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

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

示例：

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

data.etag

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

響應(yīng)時(shí)提供etag。關(guān)于GData APIs中的ETags詳情可以在這里找到：http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning

示例：

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

data.id

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

一個(gè)全局唯一標(biāo)識(shí)符用于引用該對(duì)象。_id_屬性的具體細(xì)節(jié)都留給了服務(wù)。

示例：

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

data.lang

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

表示該對(duì)象內(nèi)其他屬性的語言。該屬性模擬HTML的_lang_屬性和XML的_xml:lang_屬性。值應(yīng)該時(shí)BCP 47中定義的一種語言值。如果一個(gè)單一的JSON對(duì)象包含的數(shù)據(jù)有多種語言，服務(wù)負(fù)責(zé)制定和標(biāo)明的lang屬性的適當(dāng)位置。

示例：

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

data.updated

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

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

示例：

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

data.deleted

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

一個(gè)標(biāo)記元素，當(dāng)出現(xiàn)時(shí)，表示包含的條目已被刪除。如果提供了刪除屬性，它的值必須為true;為_false_會(huì)導(dǎo)致混亂，應(yīng)該避免。

示例：

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

data.items

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

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

示例：

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