Opengraph/object

跳转到: 导航, 搜索

对象(Object)

对象(Object)是你的应用或网站中的一个“实体”,比如一本名为《西游记》的书。在你的应用中,对象一般是人们兴趣行为的目标。绝大多数的对象其实就是一个个网页、或这些网页中的内容,对象一般属于公共信息。


微博采用结构化的数据来描述这些对象,并将其存储在微博的对象库中,并由一个特定的URL来唯一定义每个对象。微博采集到这些结构化的对象数据,以产生兴趣内容来显示在人们的微博消息流中。


对象是一个JSON编码的数据结构,其包含对象类型(Object Type)和对象属性数据(Object Data)。


对象类型(Object Type)

标识对象的类型,比如:book(图书)、video(视频)。每个对象都有且仅有一个对象类型。


对象属性数据(Object Data)

对象属性是描述对象各个方面的数据元素。每个对象的属性都继承于一个通用类型的对象(webpage),同时某些特殊类型的对象也拥有自己特有的对象属性。


你还可以为对象添加新的自定义属性,自定义属性将放置在对象的"custom_data"属性下。


示例:

{
    "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)