相关文章推荐

平台政策与指引

微博登录接入

移动应用接入

媒体接入平台

电商接入平台

粉丝服务平台

商业接口

网站接入

微博API

资源下载

跳转到: 导航 , 搜索

对象(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)

     
    推荐文章