返回首页 Google JSON 风格指南

用于链接的保留属性名

下面的属性位于data对象中,用来表示对其他资源的引用。有两种形式的链接属性:1)对象,它可以包含任何种类的引用(比如JSON-RPC对象),2)URL字符串,表示资源的URIs(后缀总为'Link')。

data.self / data.selfLink

属性值类型: 对象(object)/字符串(string)
父节点: data

自身链接可以用于取回条目数据。比如,在用户的Picasa相册中,条目中的每个相册对象都会包含一个selfLink用于检索这个相册的相关数据。

示例:

{
  "data": {
    "self": { },
    "selfLink": "http://www.google.com/feeds/album/1234"
  }
}

data.edit / data.editLink

属性值类型: 对象(object)/字符串(string)
父节点: data

编辑链接表明用户可以发送更新或删除请求。这对于REST风格的APIs很有用。该链接仅在用户能够更新和删除该条目时提供。

示例:

{
  "data": {
    "edit": { },
    "editLink": "http://www.google.com/feeds/album/1234/edit"
  }
}

data.next / data.nextLink

属性值类型: 对象(object)/字符串(string)
父节点: data

该下一页链接标明如何取得更多数据。它指明载入下一组数据的位置。它可以同itemsPerPagestartIndextotalItems 属性一起使用用于分页数据。

示例:

{
  "data": {
    "next": { },
    "nextLink": "http://www.google.com/feeds/album/1234/next"
  }
}

data.previous / data.previousLink

属性值类型: 对象(object)/字符串(string)
父节点: data

该上一页链接标明如何取得更多数据。它指明载入上一组数据的位置。它可以连同itemsPerPagestartIndextotalItems 属性用于分页数据。

示例:

{
  "data": {
    "previous": { },
    "previousLink": "http://www.google.com/feeds/album/1234/next"
  }
}