JSON對象的_data_屬性可能包含以下屬性。 ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datakind)data.kind ~~~ 屬性值類型: 字符串(sting) 父節點: data ~~~ _kind_屬性是對某個特定的對象存儲何種類型的信息的指南。可以把它放在_data_層次，或_items_的層次，或其它任何有助于區分各類對象的對象中。如果_kind_對象被提供，它應該是對象的第一個屬性（詳見下面的_屬性順序_部分）。 示例： ~~~ // "Kind" indicates an "album" in the Picasa API. {"data": {"kind": "album"}} ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datafields)data.fields ~~~ 屬性值類型: 字符串(string) 父節點: data ~~~ 表示做了部分GET之后響應中出現的字段，或做了部分PATCH之后出現在請求中的字段。該屬性僅在做了部分GET請求/批處理時存在，且不能為空。 示例： ~~~ { "data": { "kind": "user", "fields": "author,id", "id": "bart", "author": "Bart" } } ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataetag)data.etag ~~~ 屬性值類型: 字符串(string) 父節點: data ~~~ 響應時提供etag。關于GData APIs中的ETags詳情可以在這里找到：[http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning](http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning) 示例： ~~~ {"data": {"etag": "W/"C0QBRXcycSp7ImA9WxRVFUk.""}} ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataid)data.id ~~~ 屬性值類型: 字符串(string) 父節點: data ~~~ 一個全局唯一標識符用于引用該對象。_id_屬性的具體細節都留給了服務。 示例： ~~~ {"data": {"id": "12345"}} ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datalang)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!" } ]} } ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataupdated)data.updated ~~~ 屬性值類型: 字符串(string)(格式由RFC 3339指定) 父節點: data ~~~ 指明條目更新的最后日期/時間(RFC 3339)，由服務規定。 示例： ~~~ {"data": {"updated": "2007-11-06T16:34:41.000Z"}} ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datadeleted)data.deleted ~~~ 屬性值類型: 布爾(boolean) 父節點: data (或任何子元素) ~~~ 一個標記元素，當出現時，表示包含的條目已被刪除。如果提供了刪除屬性，它的值必須為_true_;為_false_會導致混亂，應該避免。 示例： ~~~ {"data": { "items": [ { "title": "A deleted entry", "deleted": true } ]} } ~~~ ### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataitems)data.items ~~~ 屬性值類型: 數組(array) 父節點: data ~~~ 屬性名_items_被保留用作表示一組條目(例如,Picasa中的圖片，YouTube中的視頻)。這種結構的目的是給與當前結果相關的集合提供一個標準位置。例如，知道頁面上的_items_是數組，JSON輸出便可能插入一個通用的分頁系統。如果_items_存在，它應該是_data_對象的最后一個屬性。（詳見下面的_屬性順序_部分）。 示例： ~~~ { "data": { "items": [ { /* Object #1 */ }, { /* Object #2 */ }, ... ] } } ~~~