Opengraph/object
| 第50行： | 第50行： | ||
|- | |- | ||
!width="25%" style="{{Table_css_2}}"|属性（Object Properties） | !width="25%" style="{{Table_css_2}}"|属性（Object Properties） | ||
| − | !width=" | + | !width="15%" style="{{Table_css_2}}"|值的类型 |
| − | !width=" | + | !width="60%" style="{{Table_css_2}}"|说明描述 |
{{rdes_args|display_name|string|对象的显示标题名称，一个对象必须包含此属性。}} | {{rdes_args|display_name|string|对象的显示标题名称，一个对象必须包含此属性。}} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{{rdes_args|object_type|string|对象类型，可以从上面的对象类型列表里选择，一个对象必须包含此属性。}} | {{rdes_args|object_type|string|对象类型，可以从上面的对象类型列表里选择，一个对象必须包含此属性。}} | ||
| + | {{rdes_args|url|string|对象对应的网页URL，一个对象必须包含此属性，该URL地址必须为一个纯净的URL，不带有无关的参数，其将作为对象数据的唯一标识依据，保持该URL的干净将有利于数据的统一和有效。}} | ||
| + | {{rdes_args|image|media link|对象的显示图片。}} | ||
| + | {{rdes_args|author|object|对象的作者、所有者，其值为一个person类型的子对象。}} | ||
| + | {{rdes_args|summary|string|对象的文字描述，字数建议控制在300字以内。}} | ||
| + | {{rdes_args|create_at|date time|对象的创建时间，格式强烈建议用国际化格式：Wed Jan 06 11: 26: 01+0800 2010，或者用简易格式：2012-10-18。}} | ||
| + | {{rdes_args|tags|object array|对象的标签属性，对象数据的通用属性，为一个object array的对象数组。}} | ||
| + | {{rdes_args|links|object|对象的交互属性，对象数据的通用属性，为一个子对象。}} | ||
| + | {{rdes_args|custom_data|object |对象的自定义属性数据，其值为一个子对象，子对象内你可以自定义自己的属性。}} | ||
|} | |} | ||
2013年8月7日 (三) 18:57的版本
对象（Object）
对象（Object）是你的应用或网站中的一个“实体”，比如一本名为《西游记》的书。在你的应用中，对象一般是人们兴趣行为的目标。绝大多数的对象其实就是一个个网页、或这些网页中的内容，对象一般属于公共信息。
微博采用结构化的数据来描述这些对象，并将其存储在微博的对象库中，并由一个特定的URL来唯一定义每个对象。微博采集到这些结构化的对象数据，以产生兴趣内容来显示在人们的微博消息流中。
对象是一个JSON编码的数据结构，其包含对象类型（Object Type）和对象属性数据（Object Data）。
对象类型（Object Type）
标识对象的类型，比如：book（图书）、video（视频）。每个对象都有且仅有一个对象类型。
你可以从如下的标准对象类型中选择适合你应用的：
| 对象类型（Object Types） | 说明描述 |
|---|---|
| webpage | 网页，是最基本的对象类型，如果你搞不清楚自己的类型，都可以选此类型。 |
| article | 文章，通常是一篇有作者的文字作品。 |
| audio | 音频，可播放的音乐、歌曲等音频作品。 |
| person | 人物，名人、公众人物等，普通个人由于隐私问题不建议对象化。 |
| product | 商品，人们交易的产品、货物等。 |
| recruit | 招聘，即招聘、职位等信息。 |
| video | 视频，可播放的影视作品。 |
| book | 图书，出版物、印刷品等。 |
| shop | 店铺，包括网络上的电子商务店铺。 |
| game | 游戏，单机、联网、手游、页游、社交游戏。 |
| app | 应用，适用于各种平台的应用程序。 |
对象属性数据（Object Data）
对象属性是描述对象各个方面的数据元素。每个对象的属性都继承于一个通用类型的对象（webpage），同时某些特殊类型的对象也拥有自己特有的对象属性。
你还可以为对象添加新的自定义属性，自定义属性将放置在对象的"custom_data"属性下。
下面是一些常用的标准对象属性，可以帮助你定义你的结构化的对象数据：
| 属性（Object Properties） | 值的类型 | 说明描述 |
|---|---|---|
| display_name | string | 对象的显示标题名称，一个对象必须包含此属性。 |
| object_type | string | 对象类型，可以从上面的对象类型列表里选择，一个对象必须包含此属性。 |
| url | string | 对象对应的网页URL，一个对象必须包含此属性，该URL地址必须为一个纯净的URL，不带有无关的参数，其将作为对象数据的唯一标识依据，保持该URL的干净将有利于数据的统一和有效。 |
| image | media link | 对象的显示图片。 |
| author | object | 对象的作者、所有者，其值为一个person类型的子对象。 |
| summary | string | 对象的文字描述，字数建议控制在300字以内。 |
| create_at | date time | 对象的创建时间，格式强烈建议用国际化格式：Wed Jan 06 11: 26: 01+0800 2010，或者用简易格式：2012-10-18。 |
| tags | object array | 对象的标签属性，对象数据的通用属性，为一个object array的对象数组。 |
| links | object | 对象的交互属性，对象数据的通用属性，为一个子对象。 |
| custom_data | object | 对象的自定义属性数据，其值为一个子对象，子对象内你可以自定义自己的属性。 |
示例：
{
"id": "2003022:3c979425f3083a2d5aee5e8af2c810fc",
"author": {
"display_name": "李教授",
"url": "http://sina.com/user/rtgcx",
"object_type": "person"
},
"display_name": "东西方的差异",
"object_type": "article",
"image": {
"url": "http://sina.com/zt/89356.jpg",
"width": "300",
"height": "300"
},
"summary": "经常会听到朋友手机的铃声传出了蝈蝈、蛐蛐或黄蛉的叫声，一下子将人思绪引入乡村旷野...",
"url": "http://sina.com/a/89356",
"links": {
"url": "http://sina.cn/h5/89356"
},
"tags": [
{
"display_name": "文化"
}
],
"create_at": "Wed Jan 06 11: 26: 01+0800 2010",
"updated": "Wed Jan 06 11: 26: 01+0800 2010"
}
接入对象库（Connect Object）
接入对象库，提供结构化对象数据的采集，有2种接入方法：
- 微博元标记（Weibo Meta Tags）
- 对象数据回调（Object Data Callback）
微博元标记（Weibo Meta Tags）
要使你的网页成为一个对象（Object），你需要在网页源代码的<head>里打上meta标签，标签里包含的结构化数据对象的属性值，即微博元标记（Weibo Meta Tags）。
微博元标记，支持和兼容FaceBook的OpenGraph协议中的常规标签，并基于本地化对OpenGraph不适用的对象类型或属性进行了有限扩展标记。可以和OpenGraph一起使用。
想要了解更多有关于微博元标记（Weibo Meta Tags）的内容，可以参见 微博元标记（Weibo Meta Tags）。
对象数据回调（Object Data Callback）
采用回调开发者的对象数据接口，实现采集接入方的结构化对象数据的方式。
开发者需提供：
链接匹配规则（URL Rule）
是一个简单的通配或正则表达式，用于识别和匹配各个开发者接入对象库的网页链接。
对象数据回调接口（Object Data Callback API）
开发者需提供的一个接口，参数为接入对象库的网页链接，也就是通过链接匹配规则筛选出来的URL，接口返回对应网页上的结构化的对象数据，为JSON数据格式。
想要了解更多有关于对象数据回调（Object Data Callback）的内容，可以参见 对象数据回调（Object Data Callback）。
