用于链接的保留属性名
最后更新于：2022-04-01 06:07:24
下面的属性位于_data_对象中，用来表示对其他资源的引用。有两种形式的链接属性：1）对象，它可以包含任何种类的引用（比如JSON-RPC对象），2)URL字符串，表示资源的URIs(后缀总为'Link')。
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataself--dataselflink)data.self / data.selfLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
自身链接可以用于取回条目数据。比如，在用户的Picasa相册中，条目中的每个相册对象都会包含一个_selfLink_用于检索这个相册的相关数据。
示例：
~~~
{
"data": {
"self": { },
"selfLink": "http://www.google.com/feeds/album/1234"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataedit--dataeditlink)data.edit / data.editLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
编辑链接表明用户可以发送更新或删除请求。这对于REST风格的APIs很有用。该链接仅在用户能够更新和删除该条目时提供。
示例：
~~~
{
"data": {
"edit": { },
"editLink": "http://www.google.com/feeds/album/1234/edit"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datanext--datanextlink)data.next / data.nextLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
该下一页链接标明如何取得更多数据。它指明载入下一组数据的位置。它可以同_itemsPerPage_，_startIndex_ 和 _totalItems_属性一起使用用于分页数据。
示例：
~~~
{
"data": {
"next": { },
"nextLink": "http://www.google.com/feeds/album/1234/next"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataprevious--datapreviouslink)data.previous / data.previousLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
该上一页链接标明如何取得更多数据。它指明载入上一组数据的位置。它可以连同_itemsPerPage_，_startIndex_ 和 _totalItems_属性用于分页数据。
示例：
~~~
{
"data": {
"previous": { },
"previousLink": "http://www.google.com/feeds/album/1234/next"
}
}
~~~