Jak uzyskać ocenę Goodreads przez API

Dla miłośników książek, którzy lubią określony gatunek, prawdopodobnie sprawdzą rekomendacje przyjaciela niż podążą za jakąkolwiek listą bestsellerów. Dlatego właśnie Amazon's Goodreads jest stroną z zakładkami dla zapalonych czytelników. To miejsce, w którym znajdziesz obszerną bazę książek, rekomendacji i recenzji innych miłośników książek.

Goodreads zapewnia także API dla programistów uzyskaj dostęp do swoich danych i dalej personalizuj jak w naszej aplikacji. Dzisiaj zobaczymy, jak pobrać oceny książek Goodreads za pomocą interfejsu API Goodreads przy użyciu numeru ISBN lub międzynarodowego standardowego numeru książki, które mogą być później wykorzystane podczas wyświetlania informacji o książce i na stronie internetowej.

Aby rozpocząć, zaloguj się lub zarejestruj się przy użyciu nazwy, adresu e-mail i hasła do Goodreads i przejdź do https://www.goodreads.com/api/keys (połączyć). Wprowadź dowolną nazwę aplikacji i nazwę firmy i wygeneruj klucz API. Następnie zweryfikuj swoje konto za pomocą wiadomości e-mail otrzymanej w podanym identyfikatorze e-mail.

Pamiętaj o zapoznaniu się z Warunkami korzystania z usługi dla programistów. Mają także listę metod API na swojej stronie API, niektóre z tych metod wymagają uwierzytelnienia OAuth, reszta będzie tylko potrzebujesz klucza programisty, jak ten, który obejrzymy w tym poście.

Typ odpowiedzi tych metod jest różny, jest on albo w formacie XML, albo JSON, albo opcja wyboru między tymi dwoma przy użyciu format parametr.

book.review_counts to metoda API Goodreads, która pobiera wszystkie statystyki przeglądu dla listy książek ISBN. Jego typem odpowiedzi jest JSON. Adres URL żądania jest następujący: https://www.goodreads.com/book/review_counts.json .

Wymaga czterech parametrów:

• klawisz, który jest kluczem programisty
• isbns - tablica lub pojedynczy ciąg oddzielonych przecinkami numerów ISBN książek, które chcemy statystyki przeglądu
• format - format odpowiedzi (szczerze mówiąc, nie jestem do końca pewien, dlaczego ten istnieje, ponieważ odpowiedź będzie zawsze w JSON. Plany przyszłych wdrożeń?)
• oddzwonić, funkcja, która zakończy odpowiedź JSON

Weźmy dwie książki; Head First Java, pierwsza edycja (ISBN: 0596009208) i JavaScript: dobre części, pierwsze wydanie (ISBN: 0596517742) i uzyskaj ich statystyki przeglądu. Adres URL żądania jest następujący:

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

I responseText po upiększeniu wygląda tak.

„książki”: [„id”: 231262, „isbn”: „0596009208”, „isbn13”: „9780596009205”, „rating_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”, „rating_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”] 

Jeśli chcesz ocenić Head First Java, First Edition książka, jest w środku myJSON.books [0] .average_rating. The rating_count i opinie_konto klucze w obiektach reprezentują całkowitą liczbę oddanych ocen i recenzji dokonanych dla danej edycji książki.

podobnie , text_reviews_count reprezentuje całkowitą liczbę tekstowych recenzji danej edycji książki. Natomiast work_ratings_count, work_reviews_count i work_text_reviews_count reprezentują wszystkie oceny, recenzje i recenzje tekstowe wszystkich wydań.

Jeśli klikniesz na Rating Details of JavaScript: dobre części (pierwsza edycja) w Goodreads wyświetli to.

Możesz użyć wszystkich tych dodatkowych informacji o przeglądach, jeśli chcesz lub po prostu wyświetlić ocenę gwiazdki za pomocą Średnia ocena kluczowa wartość.

Uwaga: Zgodnie z dokumentacją API, “Interfejs API Goodreads zapewnia pełny dostęp do metadanych należących do Goodreads, ale nie daje pełnego dostępu do metadanych książki dostarczonych przez strony trzecie, takie jak Ingram. Obrazy okładek książek, opisy i inne dane ze źródeł zewnętrznych mogą zostać wykluczone, ponieważ nie mamy licencji na rozpowszechnianie tych danych za pośrednictwem naszego interfejsu API.”

Po przygotowaniu okładek i opisów książek możesz wyświetlić informacje o książce nieco jak poniżej.