对象(Object)
对象(Object)是你的应用或网站中的一个“实体”,比如一本名为《西游记》的书。在你的应用中,对象一般是人们兴趣行为的目标。绝大多数的对象其实就是一个个网页、或这些网页中的内容,对象一般属于公共信息。
微博采用结构化的数据来描述这些对象,并将其存储在微博的对象库中,并由一个特定的URL来唯一定义每个对象。微博采集到这些结构化的对象数据,以产生兴趣内容来显示在人们的微博消息流中。
对象是一个JSON编码的数据结构,其包含对象类型(Object Type)和对象属性数据(Object Data)。
对象类型(Object Type)
标识对象的类型,比如:book(图书)、video(视频)。每个对象都有且仅有一个对象类型。
你可以从如下的标准对象类型中选择适合你应用的:
对象属性数据(Object Data)
对象属性是描述对象各个方面的数据元素。每个对象的属性都继承于一个通用类型的对象(webpage),同时某些特殊类型的对象也拥有自己特有的对象属性。
你还可以为对象添加新的自定义属性,自定义属性将放置在对象的"custom_data"属性下。
下面是一些常用的标准对象属性,可以帮助你定义你的结构化的对象数据:
string
对象对应的网页URL,一个对象必须包含此属性,该URL地址必须为一个纯净的URL,不带有无关的参数,其将作为对象数据的唯一标识依据,一个URL只能对应一个独立的对象,保持该URL的干净将有利于数据的统一和有效。
image
media link
对象的显示图片,我们建议图片尺寸至少不小于200 × 200 pixels,有关媒体属性类型,请阅读
media link
。
author
object
对象的作者、所有者,其值为一个person类型的子对象。
summary
string
对象的文字描述,字数建议控制在300字以内。
category
string
对象的类目信息,一般商品的对象类型这个属性很有用。
create_at
date time
对象的创建时间,格式强烈建议用国际化格式:Wed Jan 06 11: 26: 01+0800 2010,或者用简易格式:2012-10-18。
object array
对象的标签属性,对象数据的通用属性,为一个object array的对象数组,有关标签属性类型,请阅读
tags
。
links
object
对象的交互属性,对象数据的通用属性,为一个子对象,有关交互属性类型,请阅读
links
。
custom_data
object
对象的自定义属性数据,其值为一个子对象,子对象内你可以自定义自己的属性。
除了通用的标准属性,某些特殊的对象类型(比如视频 video)有其特有的属性,你可以参考下面的列表:
audio(音频)
media link
音频流的播放源,应为一个mp3流地址,用于PC、移动设备上的直接播放,为一个media link类型的属性,为了更好的用户体验,我们建议是必填。但如果接入方由于某种原因,不想在微博客户端内嵌直接播放,则可以不填写该属性。有关媒体属性类型,请阅读
media link
。
recruit(招聘)
media link
视频流的播放源,优先建议为m3u8格式,或者为mp4格式,用于PC、移动设备上的直接播放,为一个media link类型的属性,为了更好的用户体验,我们建议是必填。但如果接入方由于某种原因,不想在微博客户端内嵌直接播放,则可以不填写该属性。有关媒体属性类型,请阅读
media link
。
book(图书)
string
媒体的资源地址,如果对象为图片则该属性即为图片地址,如果对象是流媒体则为媒体流地址,一个media link类型的属性里必须包含此子属性。当对象是视频流媒体时,此地址应为的视频m3u8、或mp4地址,当第三方提供的是m3u8格式的视频时,可获得在微博移动客户端直接播放的优良体验,因此有m3u8格式的建议优先填写m3u8格式。当提供的是mp4格式的视频流,则只有当视频小于10分钟时,才可以获得客户端直接播放的优良体验,除此之外移动客户端将跳转到H5播放页(详见links属性)。当对象是音乐流媒体时,此地址应为音频的mp3地址。
hd_url
string
媒体的高清资源地址,比如高清图片地址,或高清视频流地址,其他规则同url属性。
width
媒体的宽度,如果对象为图片则就是图片宽度。
height
媒体的高度,如果对象为图片则就是图片高度。
标签属性类型 tags(object array)
string
点击对象的交互URL,例如你的应用运行在移动端,则这个URL可以是一个H5的地址;又或者由于对象内的url属性要求是纯净的,如果你有统计的需求,可以采用这个url子属性,其可以带各种统计参数,而不会影响对象的采集。
"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)
。