Opengraph/object

跳转到: 导航, 搜索
第21行: 第21行:
 
|-
 
|-
 
!width="30%" style="{{Table_css_2}}"|对象类型(Object Types)
 
!width="30%" style="{{Table_css_2}}"|对象类型(Object Types)
!width="70%" style="font-weight:bolder;border:1px solid #CCCCCC;"|说明描述
+
!width="70%" style="{{Table_css_2}}"|说明描述
{{rdes_args_2|at||微博创建时间}}
+
{{rdes_args_2|webpage|网页,是最基本的对象类型,如果你搞不清楚自己的类型,都可以选此类型。}}
{{rdes_args_2|at||微博创建时间}}
+
{{rdes_args_2|article|文章,通常是一篇有作者的文字作品。}}
{{rdes_args_2|at||微博创建时间}}
+
{{rdes_args_2|audio|音频,可播放的音乐、歌曲等音频作品。}}
 +
{{rdes_args_2|person|人物,名人、公众人物等,普通个人由于隐私问题不建议对象化。}}
 +
{{rdes_args_2|product|商品,人们交易的产品、货物等。}}
 +
{{rdes_args_2|recruit|招聘,即招聘、职位等信息。}}
 +
{{rdes_args_2|video|视频,可播放的影视作品。}}
 +
{{rdes_args_2|book|图书,出版物、印刷品等。}}
 +
{{rdes_args_2|shop|店铺,包括网络上的电子商务店铺。}}
 +
{{rdes_args_2|game|游戏,单机、联网、手游、页游、社交游戏。}}
 +
{{rdes_args_2|app|应用,适用于各种平台的应用程序。}}
 
|}
 
|}
  
第41行: 第49行:
 
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
 
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
 
|-
 
|-
!width="25%" style="{{Table_css_2}}"|属性
+
!width="25%" style="{{Table_css_2}}"|属性(Object Properties)
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|值的类型
+
!width="15%" style="{{Table_css_2}}"|值的类型
!width="60%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|说明描述
+
!width="60%" style="{{Table_css_2}}"|说明描述
{{rdes_args|id|int64|微博ID}}
+
{{rdes_args|display_name|string|对象的显示标题名称,一个对象必须包含此属性。}}
 +
{{rdes_args|image|media link|对象的显示图片。}}
 +
{{rdes_args|summary|string|对象的文字描述。}}
 +
{{rdes_args|url|string|对象对应的网页URL,一个对象必须包含此属性。}}
 +
{{rdes_args|create_at|date time|对象的创建时间。}}
 +
{{rdes_args|author|object|对象的作者、所有者。}}
 +
{{rdes_args|object_type|string|对象类型,可以从上面的对象类型列表里选择,一个对象必须包含此属性。}}
 
|}
 
|}
  

2013年8月7日 (三) 18:37的版本

对象(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 对象的显示标题名称,一个对象必须包含此属性。
image media link 对象的显示图片。
summary string 对象的文字描述。
url string 对象对应的网页URL,一个对象必须包含此属性。
create_at date time 对象的创建时间。
author object 对象的作者、所有者。
object_type string 对象类型,可以从上面的对象类型列表里选择,一个对象必须包含此属性。


示例:

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