Metadata
第5行: | 第5行: | ||
<p style="text-indent:24px;">当你创建了一条微博时,你可以在这条微博上添加一个或多个元数据。这些数据是关于这条微博的结构化信息。元数据的内容由你来决定。但元数据的结构和语法需要遵循一定的标准。</p> | <p style="text-indent:24px;">当你创建了一条微博时,你可以在这条微博上添加一个或多个元数据。这些数据是关于这条微博的结构化信息。元数据的内容由你来决定。但元数据的结构和语法需要遵循一定的标准。</p> | ||
+ | |||
+ | |||
+ | 示例: | ||
+ | <pre> | ||
+ | … | ||
+ | "annotations": [ | ||
+ | {"movie": { | ||
+ | "title": "Wall Street", | ||
+ | "url": "http://video.sina.com.cn/m/gsd_61145667.html", | ||
+ | "text": "Wall Street: Money Never Sleeps"}}], | ||
+ | … | ||
+ | </pre> | ||
+ | |||
+ | ==微博元数据格式说明== | ||
+ | |||
+ | 微博元数据由“type(类型)”、“attribute(属性)”、“value(值)”组成: | ||
+ | <pre> | ||
+ | "annotations": [{"type": {"attribute": "value"}}] | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | 一个属性对应一个值,一个类型可以有多个属性,一条微博的元数据可以有多个类型。 | ||
+ | |||
+ | <pre> | ||
+ | "annotations": [ | ||
+ | {"type": { | ||
+ | "another_attribute": "value", | ||
+ | "attribute": "value"}}, | ||
+ | {"type": { | ||
+ | "another_attribute": "value", | ||
+ | "attribute": "value"}}] | ||
+ | </pre> | ||
+ | |||
+ | ==type类型== | ||
+ | |||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">TYPE类型</td> | ||
+ | <td style="padding:5px;">描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">webpage</td> | ||
+ | <td style="padding:3px;">图文内容、新闻、博客等网页信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">product</td> | ||
+ | <td style="padding:3px;">电子商务的产品信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">video</td> | ||
+ | <td style="padding:3px;">视频信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">movie</td> | ||
+ | <td style="padding:3px;">电影信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">song</td> | ||
+ | <td style="padding:3px;">音乐信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">people</td> | ||
+ | <td style="padding:3px;">人物信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">place</td> | ||
+ | <td style="padding:3px;">地点信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">review</td> | ||
+ | <td style="padding:3px;">点评信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">restaurant</td> | ||
+ | <td style="padding:3px;">餐饮信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">book</td> | ||
+ | <td style="padding:3px;">图书信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">stock</td> | ||
+ | <td style="padding:3px;">股票信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">event</td> | ||
+ | <td style="padding:3px;">活动信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">vote</td> | ||
+ | <td style="padding:3px;">投票统计信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">pay</td> | ||
+ | <td style="padding:3px;">支付信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">job</td> | ||
+ | <td style="padding:3px;">招聘信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">game</td> | ||
+ | <td style="padding:3px;">游戏信息</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">app</td> | ||
+ | <td style="padding:3px;">微博应用信息</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | ==属性attribute说明== | ||
+ | |||
+ | ===通用属性=== | ||
+ | |||
+ | 所有类型都可以使用 | ||
+ | |||
+ | |||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">标题</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">image</td> | ||
+ | <td style="padding:3px;">图片</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">元数据对应的url地址</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">text</td> | ||
+ | <td style="padding:3px;">描述文字</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | ===类型属性=== | ||
+ | |||
+ | 不同type类型的特殊属性或含义,类型属性可以多个组合使用,并不局限于type类型 | ||
+ | |||
+ | |||
+ | <b>webpage</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">标题</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">image</td> | ||
+ | <td style="padding:3px;">图片</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">元数据对应的url地址</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>product</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">brand</td> | ||
+ | <td style="padding:3px;">商品品牌</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">model</td> | ||
+ | <td style="padding:3px;">商品的具体型号</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">price</td> | ||
+ | <td style="padding:3px;">商品的价格,包含货币符号</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">origin</td> | ||
+ | <td style="padding:3px;">商品的原产地</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">category</td> | ||
+ | <td style="padding:3px;">商品分类</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>video</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">视频节目标题</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">视频播放地址</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>movie</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">电影名称</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">链接到该电影的介绍页</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">director</td> | ||
+ | <td style="padding:3px;">电影导演的名字</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">year</td> | ||
+ | <td style="padding:3px;">电影出品的年代,格式:YYYY</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>song</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">音乐歌曲名称</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">链接到该音乐歌曲的介绍页,或播放页</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">artist</td> | ||
+ | <td style="padding:3px;">该音乐歌曲的艺术家、歌手</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">year</td> | ||
+ | <td style="padding:3px;">音乐歌曲出品的年代,格式:YYYY</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">genre</td> | ||
+ | <td style="padding:3px;">音乐风格类型</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">album</td> | ||
+ | <td style="padding:3px;">所在专辑</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>people</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">人物姓名</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">链接到该人物的介绍页</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">hometown</td> | ||
+ | <td style="padding:3px;">人物籍贯</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">birthday</td> | ||
+ | <td style="padding:3px;">人物生辰日期,格式:MM/DD/YYYY</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>place</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">title</td> | ||
+ | <td style="padding:3px;">地点名称</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">链接到该地点的介绍页</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">street_address</td> | ||
+ | <td style="padding:3px;">大街地址</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">locality</td> | ||
+ | <td style="padding:3px;">地方(区、县)</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">region</td> | ||
+ | <td style="padding:3px;">地区(省、市)</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">postal_code</td> | ||
+ | <td style="padding:3px;">邮政编码</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">country_name</td> | ||
+ | <td style="padding:3px;">国家名称</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">phone</td> | ||
+ | <td style="padding:3px;">电话号码</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">latitude</td> | ||
+ | <td style="padding:3px;">纬度</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">longitude</td> | ||
+ | <td style="padding:3px;">经度</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>review</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">content</td> | ||
+ | <td style="padding:3px;">点评的内容</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">rating</td> | ||
+ | <td style="padding:3px;">评分,例如:3/5颗星就表示为“0.6”</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">url</td> | ||
+ | <td style="padding:3px;">链接到包含该点评的网页</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>restaurant</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">cuisine</td> | ||
+ | <td style="padding:3px;">菜系,风味</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">pricerange</td> | ||
+ | <td style="padding:3px;">人均价格区间,格式:¥nn-¥mm</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>book</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">isbn</td> | ||
+ | <td style="padding:3px;">10或13位数字的ISBN书号</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">author</td> | ||
+ | <td style="padding:3px;">书的作者</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">publisher</td> | ||
+ | <td style="padding:3px;">出版社</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">year</td> | ||
+ | <td style="padding:3px;">出版年份,格式:YYYY</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>stock</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">symbol</td> | ||
+ | <td style="padding:3px;">股票代码</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">price</td> | ||
+ | <td style="padding:3px;">股价,包含货币符号,例:¥nnn.nn</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>event</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">location</td> | ||
+ | <td style="padding:3px;">活动地点</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">start_date</td> | ||
+ | <td style="padding:3px;">开始时间</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">end_date</td> | ||
+ | <td style="padding:3px;">结束时间</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>vote</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">option</td> | ||
+ | <td style="padding:3px;">投票统计项</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">count</td> | ||
+ | <td style="padding:3px;">数量</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>pay</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">seller</td> | ||
+ | <td style="padding:3px;">卖家</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">end_date</td> | ||
+ | <td style="padding:3px;">结束时间</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">price</td> | ||
+ | <td style="padding:3px;">支付额,包含货币符号,例:¥nnn.nn</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">discount</td> | ||
+ | <td style="padding:3px;">折扣,nn% 或 ¥nnn.nn</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>job</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">company</td> | ||
+ | <td style="padding:3px;">公司</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">duties</td> | ||
+ | <td style="padding:3px;">职务</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>game</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">manufacturer</td> | ||
+ | <td style="padding:3px;">出品厂商</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">platform</td> | ||
+ | <td style="padding:3px;">平台,例:PC、PSP</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | <b>app</b> | ||
+ | <table style="width:100%;border:1px solid #CCCCCC;" border="1"> | ||
+ | <tr style="font-weight:bold;background:#FBFBE7;"> | ||
+ | <td style="padding:5px;width:150px;">属性</td> | ||
+ | <td style="padding:5px;">对应值的描述</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">author</td> | ||
+ | <td style="padding:3px;">应用作者的微博昵称</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">tags</td> | ||
+ | <td style="padding:3px;">应用的标签</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">category</td> | ||
+ | <td style="padding:3px;">应用的分类,站内或站外等</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td style="padding:3px;">rating</td> | ||
+ | <td style="padding:3px;">应用的评分,例如:3/5颗星就表示为“0.6”</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | ==微博元数据的限制== | ||
+ | |||
+ | 元数据的长度不超过512个字符。 | ||
+ | |||
+ | 仅支持用户以json 数组格式提交的元数据。 | ||
+ | |||
+ | |||
+ | <b>JSON:</b> | ||
+ | <pre> | ||
+ | [{"type": {"attribute": "value"}}] | ||
+ | </pre> | ||
+ | |||
+ | ==发送带元数据的微博== | ||
+ | |||
+ | 参考:[http://open.t.sina.com.cn/wiki/index.php/Statuses/update_%E5%B8%A6%E5%85%83%E6%95%B0%E6%8D%AE Statuses/update 带元数据] | ||
+ | |||
+ | |||
+ | <b>返回带元数据的微博JSON示例:</b> | ||
+ | |||
+ | <pre> | ||
+ | { | ||
+ | "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"}} | ||
+ | ] | ||
+ | } | ||
+ | </pre> |
2010年11月22日 (一) 10:06的版本
目录 |
带元数据的微博
元数据包括事件、人物、地点等,它可以被其他的软件、搜索引擎检测到,并提取出相应的信息,把这些信息以其他形式重复使用或组合,做出各种应用。
当你创建了一条微博时,你可以在这条微博上添加一个或多个元数据。这些数据是关于这条微博的结构化信息。元数据的内容由你来决定。但元数据的结构和语法需要遵循一定的标准。
示例:
… "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 | 视频播放地址 |
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"}} ] }