• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Social distancing? Try a better way to work remotely on your online files. Dokkio, a new product from PBworks, can help your team find, organize, and collaborate on your Drive, Gmail, Dropbox, Box, and Slack files. Sign up for free.

View
 

Review

Page history last edited by Chris Messina 10 years, 2 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.