Metadata

跳转到: 导航, 搜索

目录

带元数据的微博

元数据包括事件、人物、地点等,它可以被其他的软件、搜索引擎检测到,并提取出相应的信息,把这些信息以其他形式重复使用或组合,做出各种应用。


当你创建了一条微博时,你可以在这条微博上添加一个或多个元数据。这些数据是关于这条微博的结构化信息。元数据的内容由你来决定。但元数据的结构和语法需要遵循一定的标准。


示例:

…
"annotations": [
    {"movie": {
	"title": "Wall Street",
	"url": "http://video.sina.com.cn/m/gsd_61145667.html",
	"text": "Wall Street: Money Never Sleeps"}}],
…

微博元数据格式说明

微博元数据由“type(类型)”、“attribute(属性)”、“value(值)”组成:

"annotations": [{"type": {"attribute": "value"}}]


一个属性对应一个值,一个类型可以有多个属性,一条微博的元数据可以有多个类型。

"annotations": [
    {"type": {
        "another_attribute": "value",
        "attribute": "value"}},
    {"type": {
        "another_attribute": "value",
        "attribute": "value"}}]

type类型

TYPE类型 描述
webpage 图文内容、新闻、博客等网页信息
product 电子商务的产品信息
video 视频信息
movie 电影信息
song 音乐信息
people 人物信息
place 地点信息
review 点评信息
restaurant 餐饮信息
book 图书信息
stock 股票信息
event 活动信息
vote 投票统计信息
pay 支付信息
job 招聘信息
game 游戏信息
app 微博应用信息

属性attribute说明

通用属性

所有类型都可以使用


属性 对应值的描述
title 标题
image 图片
url 元数据对应的url地址
text 描述文字


类型属性

不同type类型的特殊属性或含义,类型属性可以多个组合使用,并不局限于type类型


webpage

属性 对应值的描述
title 标题
image 图片
url 元数据对应的url地址


product

属性 对应值的描述
brand 商品品牌
model 商品的具体型号
price 商品的价格,包含货币符号
origin 商品的原产地
category 商品分类


video

属性 对应值的描述
title 视频节目标题
url 视频节目网站详细页地址
player_url 视频播放器地址


movie

属性 对应值的描述
title 电影名称
url 链接到该电影的介绍页
director 电影导演的名字
year 电影出品的年代,格式:YYYY


song

属性 对应值的描述
title 音乐歌曲名称
url 链接到该音乐歌曲的介绍页,或播放页
artist 该音乐歌曲的艺术家、歌手
year 音乐歌曲出品的年代,格式:YYYY
genre 音乐风格类型
album 所在专辑


people

属性 对应值的描述
title 人物姓名
url 链接到该人物的介绍页
hometown 人物籍贯
birthday 人物生辰日期,格式:MM/DD/YYYY


place

属性 对应值的描述
title 地点名称
url 链接到该地点的介绍页
street_address 大街地址
locality 地方(区、县)
region 地区(省、市)
postal_code 邮政编码
country_name 国家名称
phone 电话号码
latitude 纬度
longitude 经度


review

属性 对应值的描述
content 点评的内容
rating 评分,例如:3/5颗星就表示为“0.6”
url 链接到包含该点评的网页


restaurant

属性 对应值的描述
cuisine 菜系,风味
pricerange 人均价格区间,格式:¥nn-¥mm


book

属性 对应值的描述
isbn 10或13位数字的ISBN书号
author 书的作者
publisher 出版社
year 出版年份,格式:YYYY


stock

属性 对应值的描述
symbol 股票代码
price 股价,包含货币符号,例:¥nnn.nn


event

属性 对应值的描述
location 活动地点
start_date 开始时间
end_date 结束时间


vote

属性 对应值的描述
option 投票统计项
count 数量


pay

属性 对应值的描述
seller 卖家
end_date 结束时间
price 支付额,包含货币符号,例:¥nnn.nn
discount 折扣,nn% 或 ¥nnn.nn


job

属性 对应值的描述
company 公司
duties 职务


game

属性 对应值的描述
manufacturer 出品厂商
platform 平台,例:PC、PSP


app

属性 对应值的描述
author 应用作者的微博昵称
tags 应用的标签
category 应用的分类,站内或站外等
rating 应用的评分,例如:3/5颗星就表示为“0.6”

微博元数据的限制

元数据的长度不超过512个字符。

仅支持用户以json 数组格式提交的元数据。


JSON:

[{"type": {"attribute": "value"}}]

发送带元数据的微博

参考:Statuses/update 带元数据


返回带元数据的微博JSON示例:

{
	"created_at":"Fri Jul 30 14:01:57 +0800 2010",
	"id":1413384253,
	"text":"playing with cURL and the Sina API",
	"source":"<a href=\"http://open.t.sina.com.cn/wiki/index.php/SDK/\" rel=\"nofollow\">dabr for weibo</a>",
	"favorited":false,
	"truncated":false,
	"in_reply_to_status_id":"",
	"in_reply_to_user_id":"",
	"in_reply_to_screen_name":"",
	"geo":null,
	"user":{
		"id":10506,
		"screen_name":"hustfisher",
		"name":"hustfisher",
		"province":"44",
		"city":"1",
		"location":"广东 广州",
		"description":"",
		"url":"",
		"profile_image_url":"http://tp3.sinaimg.cn/10506/50/0","domain":"",
		"gender":"m",
		"followers_count":8,
		"friends_count":39,
		"statuses_count":169,
		"favourites_count":0,
		"created_at":"Tue Oct 20 00:00:00 +0800 2009",
		"following":false,
		"allow_all_act_msg":false,
		"geo_enabled":false,
		"verified":false
	},
	"annotations":[
		{"type":{"attribute":"value","another_attribute":"value"}},
		{"another_type":{"attribute":"value"}}
	]
}