Как да получите Goodreads Ratings чрез API
За любителите на книги, които харесват даден жанр, те вероятно ще проверят препоръката на приятел, отколкото да следват всеки списък с бестселъри. Ето защо Goodreads на Amazon е отметнат сайт за запалените читатели. Това е място, където можете да намерите обширна база от книги, препоръки и ревюта на любители на книги.
Goodreads предлага и API за разработчиците достъп до неговите данни и допълнително персонализиране според нашата молба. Днес ще видим как да извличаме рейтингите на книгите на Goodreads чрез API на Goodreads, като използваме ISBN или международен стандартен номер на книга, който по-късно може да се използва при показване на информация за книги и такива на уебсайта ви.
За да започнете, влезте или се регистрирайте с име, имейл адрес и парола за Goodreads и отидете на https://www.goodreads.com/api/keys (Връзка). Въведете името на всяко приложение и името на фирмата си и генерирайте ключа API. След това потвърдете профила си чрез имейла, получен в въведения от вас имейл адрес.
Не забравяйте да проверите Общите условия на разработчика за приложния програмен интерфейс (API). Освен това те имат списък с API методи на страницата си с API, някои от тези методи ще изискват OAuth удостоверяване, а останалите - само трябва ключ за програмиста, подобно на тази, която ще разгледаме в тази публикация.
Видът на отговора на тези методи варира, той е или само в XML или JSON, или опция за избор между тези две, използвайки формат параметър.
book.review_counts е метод на API за Goodreads, който ще извлече всички статистически данни за прегледа за списък с ISBN книги. Типът му отговор е JSON. URL адресът на искането е по следния начин: https://www.goodreads.com/book/review_counts.json .
Отнема четири параметъра:
ключ, което е ключът на разработчикаISBN номера- масив или единичен низ, разделен със запетая на ISBN-ите на книгите, които искаме да прегледаме статистиката наформат- форматът на отговора (въпреки че искрено не съм сигурен защо съществува такъв, тъй като отговорът винаги ще бъде в JSON. Планове за бъдещи реализации?)обаждане, функцията, която ще приключи отговора на JSON
Да вземем двете книги; 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 ще покаже това.
Можете да използвате всички тези допълнителни данни за преглед, ако искате или просто да показвате оценка на звезда за книгата с помощта на среден рейтинг ключова стойност.
Забележка: Според документацията на API, “API на Goodreads ви дава пълен достъп до мета-данни, притежавани от Goodreads, но не ви дава пълен достъп до метаданни за книги, предоставени от трети страни, като например Ingram. Възможно е да бъдат изключени изображения, описания и други данни от източници на книги от трети страни, тъй като нямаме лиценз за разпространение на тези данни чрез нашия приложен програмен интерфейс (API).”
След като подготвите кориците и описанията на книгите, можете да покажете информация за книгата по-долу.
