Metadata
(→类型属性) |
|||
第213行: | 第213行: | ||
<tr> | <tr> | ||
<td style="padding:3px;">url</td> | <td style="padding:3px;">url</td> | ||
− | <td style="padding:3px;"> | + | <td style="padding:3px;">视频节目网站详细页地址</td> |
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">player_url</td> | ||
+ | <td style="padding:3px;">视频播放器地址</td> | ||
</tr> | </tr> | ||
</table> | </table> |
2010年12月23日 (四) 10:50的最后版本
目录 |
带元数据的微博
元数据包括事件、人物、地点等,它可以被其他的软件、搜索引擎检测到,并提取出相应的信息,把这些信息以其他形式重复使用或组合,做出各种应用。
当你创建了一条微博时,你可以在这条微博上添加一个或多个元数据。这些数据是关于这条微博的结构化信息。元数据的内容由你来决定。但元数据的结构和语法需要遵循一定的标准。
示例:
… "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"}}]
发送带元数据的微博
返回带元数据的微博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"}} ] }
文档更新时间: 2010-12-23