APIを介してGoodreads評価を取得する方法

特定のジャンルが好きな本を愛する人のために、彼らはおそらくどんなベストセラーリストに従うよりも友人の推薦をチェックするでしょう。 AmazonのGoodreadsが熱心な読者のためのブックマークされたサイトであるのはこのためです。それはあなたが本、同僚の本を愛する人たちによる推薦とレビューの広範なデータベースを見つけることができる場所です.

Goodreadsは開発者に以下のためのAPIも提供します。 そのデータにアクセスし、さらにパーソナライズする 私達の適用によってそれ。今日は、ISBNまたはInternational Standard Book Numberを使用して、Goodreads APIを介してGoodreadsの書籍評価を取得する方法について説明します。これは、後で書籍情報などをWebサイトに表示するときに使用できます。.

開始するには、ログインするか、Goodreadsに名前、EメールID、およびパスワードでサインアップしてに進みます。 https://www.goodreads.com/api/keys （リンク）。アプリケーション名と会社名を入力してAPIキーを生成します。次に、入力したメールアドレスに記載されているメールでアカウントを確認します。.

必ずAPIの開発者向け利用規約をチェックしてください。彼らはまた彼らのAPIページにAPIメソッドのリストを持っています、それらのメソッドのいくつかはOAuth認証を必要とするでしょう、残りはただ 開発者キーが必要, この記事で見るもののように.

これらのメソッドのレスポンスタイプはさまざまです。XMLかJSONのどちらか、あるいはこれらの2つの間で選択するオプションのどちらかです。 フォーマット パラメータ.

book.review_counts 書籍ISBNのリストに関するすべてのレビュー統計を取得するGoodreads APIメソッドです。その応答タイプはJSONです。リクエストURLは次のとおりです。https://www.goodreads.com/book/review_counts.json .

それは4つのパラメータを取ります。

キー, これは開発者キーです
isbns - レビューの対象となる書籍のISBNの配列またはカンマ区切りの文字列
フォーマット - 応答の形式（ただし、正直言って、応答が常にJSONで行われるため、これが存在する理由はよくわかりません。今後の実装の予定はありますか？）
折り返し電話, JSONレスポンスをラップする関数

2冊の本を取りましょう。 Head First Java、初版 （ISBN：0596009208）そして JavaScript：グッドパーツ、第1版 （ISBN：0596517742）そして、彼らのレビューの統計情報を入手してください。リクエストURLは次のとおりです。

https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742

そしてその responseText 美化後はこんな感じ.

"books"：["id"：231262、 "isbn"： "0596009208"、 "isbn13"： "9780596009205"、 "ratings_count"：1842、 "reviews_count"：3599、 "text_reviews_count"：124、 "work_ratings_count" ：2016、 "work_reviews_count"：3943、 "work_text_reviews_count"：136、 "average_rating"： "4.16"、"id"：2998152、 "isbn"： "0596517742"、 "isbn13"： "9780596517748"、 "ratings_count" ：4430、 "reviews_count"：8921、 "text_reviews_count"：363、 "work_ratings_count"：4990、 "work_reviews_count"：9821、 "work_text_reviews_count"：381、 "average_rating"： "4.22"]

あなたが評価したい場合 ヘッドファーストJava、ファーストエディション 本、それは myJSON.books [0] .average_rating. の ratings_count そして reviews_count オブジェクト内のキーは、その本の特定のエディションに対して行われた評価およびレビューの合計数を表します。.

同様に , text_reviews_count 本の特定の版のテキストのみの総レビューを表します。一方で work_ratings_count, work_reviews_count そして work_text_reviews_count すべてのエディションの総合評価、レビュー、およびテキストのみのレビューを表します。.

評価の詳細をクリックした場合 JavaScript：グッドパーツ（第1版） Goodreadsではこれを表示します.

を使用して本の星評価を表示する場合は、これらの追加レビュー情報をすべて使用できます。 average_rating キー値.

注意：APIのドキュメントによると, “Goodreads APIは、Goodreadsが所有するメタデータへのフルアクセスを提供しますが、Ingramなどのサードパーティが提供するブックメタデータへのフルアクセスを提供するわけではありません。 APIを介してこれらのデータを配布するためのライセンスがないため、本の表紙の画像、説明、およびその他の第三者からのデータは除外される可能性があります。.”

本の表紙と説明を用意したら、次のように本の情報を表示できます。.