Book Rates Action

For developers building book apps, Facebook provides a common books.rates action. This action signals that a person is rating a book.

This action can only refer to the common books.book object.

This action and associated object types are automatically added to the App Dashboard when you use the action for the first time.

This document covers the following topics:

Code Samples and Reference

You can find platform-specific code samples on how to create, read, update, or delete a books.rates action in the API Reference Guide.

Publishing Ratings

If you need to add parameters to the same action, for example, when a person first rates a book and later adds a review, you should update the original action that you published.

This is an example code to publish a Rate action with a review:

curl -F 'access_token=YOUR_TOKEN' \
  -F 'book=https://www.example.com/book_123.html' \
  -F 'rating:value=4.5' \
  -F 'rating:scale=5' \
  -F 'review_text=This book made me laugh and cry...' \
  'https://graph.facebook.com/me/books.rates'

Submission Criteria

Custom read, rate, or review actions connected with book objects are no longer accepted. Please use the standard actions.

When submitting these actions, please remember to keep in mind the following:

  • If your app enables users to manually indicate that they've read a mass number of books at once, you should turn off feed stories for those actions with the setting no_feed_story=1
  • Rate actions should make the user flow explicitly clear when representing the user's intent. For example, asking a user to "like" a book is not the same as giving the book a numerical rating.
  • If your app is publishing a rate action, it should have some kind of star or a quantified rating system. The rating should be the same within the app and the published story on Facebook. For example, if your app uses a 100 point rating system, you should not switch to a 10 point rating system in your published story.
  • If your app is publishing a rate action, you should not prompt the user for user generated messaging. If the user writes a review, you should use og.review object
  • All book objects must have correct metadata, including the proper Author, Title, and be a real book with ISBN. Additionally, each image should display the entire cover so as to avoid getting cut off. Please do not use the book object to represent magazines, blogs, newspapers, periodicals, or other forms of literature.

Find more information on the submission process here