View
 

Review

Page history last edited by Chris Messina 14 years, 11 months ago

There are many services where users compose reviews. Several include Yelp, Amazon, and the Apple Store.

A review can be represented by:

  • <activity:verb> = Post
  • <activity:object-type> = Review
  • <thr:in-reply-to> = Item reviewed 

Proposed Language

The "review" object type represents a user's review of an object.

A review object MUST include a thr:in-reply-to element that identifies the object that is being reviewed.

A review MUST include the title of the object being reviewed as either <entry><title> or <entry><activity:object><title>

Properties

Property name Type Required Property Description JSON field Atom field RSS field
title string yes Title of the review  displayName atom:title rss:title 
name string no A human-readable name for the author    atom:name  
summary string no A short or truncated version of the review    atom:summary  
content string yes The complete content    atom:content rss:description 
owner object no The author of the review   
atom:author  
id string yes A unique ID representing the review
 
atom:id  
url URI yes Link to the review  
atom:link rel="alternate" rel:link 
published W3CDTF timestamp no When the review was published  
atom:published rss:pubDate 
updated W3CDTF timestamp no Last modification time updated atom:updated rss:lastBuildDate 
source object no If the review was resyndicated, source will contain the original representation of the review    atom:source  
related links array no Related links links atom:link rel="related"  

URI

http://activitystrea.ms/schema/1.0/review

Examples

  • Amazon
  • Apple.com
  • Digg
  • Hulu implements <activity:verb>... post and <activity:object-type>... review in RSS 2.0 (from this feed linked from the profile). Example gist.
  • Qype
  • Rotten Tomatoes
  • Yelp

Notes

It is recommended to look to hReview for the attributes for review objects.

Status

The Review object-type was included in a June 2009 draft of the Activity Streams base schema, but it is not included in a January 2010 draft.

Questions

  • How to handle rating scales? 1-5 scales vs 1 out of 100... etc
  • Different rating types -- vote up/vote down versus star rating versus percentage versus tomatoes, etc.

Maintainers

  • Rob Dolin

Comments (0)

You don't have permission to comment on this page.