Opengraph/object
对象(Object)
对象(Object)是你的应用或网站中的一个“实体”,比如一本名为《西游记》的书。在你的应用中,对象一般是人们兴趣行为的目标。绝大多数的对象其实就是一个个网页、或这些网页中的内容,对象一般属于公共信息。
微博采用结构化的数据来描述这些对象,并将其存储在微博的对象库中,并由一个特定的URL来唯一定义每个对象。微博采集到这些结构化的对象数据,以产生兴趣内容来显示在人们的微博消息流中。
对象是一个JSON编码的数据结构,其包含对象类型(Object Type)和对象属性数据(Object Data)。
对象类型(Object Type)
标识对象的类型,比如:book(图书)、video(视频)。每个对象都有且仅有一个对象类型。
你可以从如下的标准对象类型中选择适合你应用的:
对象类型(Object Types) | 说明描述 |
---|---|
at | |
at | |
at |
对象属性数据(Object Data)
对象属性是描述对象各个方面的数据元素。每个对象的属性都继承于一个通用类型的对象(webpage),同时某些特殊类型的对象也拥有自己特有的对象属性。
你还可以为对象添加新的自定义属性,自定义属性将放置在对象的"custom_data"属性下。
下面是一些常用的标准对象属性,可以帮助你定义你的结构化的对象数据:
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
id | int64 | 微博ID |
示例:
{ "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)。