Ako získať hodnotenia Goodreads prostredníctvom rozhrania API
Pre milovníkov kníh, ktorí majú záujem o určitý žáner, pravdepodobne skontrolujú odporúčanie priateľa, než aby sledovali zoznam bestsellerov. To je dôvod, prečo Amazon's Goodreads je stránkou so záložkami pre vášnivých čitateľov. Je to miesto, kde môžete nájsť rozsiahlu databázu kníh, odporúčaní a recenzií od ostatných milovníkov kníh.
Goodreads tiež poskytuje API pre vývojárov prístup k jeho údajom a ďalšie prispôsobenie podľa našej žiadosti. Dnes uvidíme, ako načítať hodnotenie kníh Goodreads prostredníctvom API Goodreads pomocou čísla ISBN alebo medzinárodného štandardného čísla knihy, ktoré sa môže neskôr použiť pri zobrazovaní informácií o knihách a takých na vašom webe.
Ak chcete začať, buď sa prihláste alebo sa prihláste s menom, e-mailovou adresou a heslom pre Goodreads a prejdite na https://www.goodreads.com/api/keys (Link). Zadajte ľubovoľný názov aplikácie a názov spoločnosti a vygenerujte kľúč API. Následne overte svoj účet prostredníctvom e-mailu prijatého v zadanom e-mailovom id.
Uistite sa, že ste si prehliadli svoje zmluvné podmienky vývojára pre rozhranie API. Majú tiež zoznam metód API na svojej stránke API, niektoré z týchto metód vyžadujú overenie OAuth, zvyšok bude iba potrebujete kľúč pre vývojárov, ako je ten, na ktorý sa pozrieme v tomto príspevku.
Typ odpovede týchto metód sa líši, je to buď len vo formáte XML alebo JSON, alebo možnosť vybrať si medzi týmito dvoma spôsobmi formát parameter.
book.review_counts je metódou Goodreads API, ktorá získa zoznam štatistických prehľadov pre zoznam ISBN kníh. Jeho typ odpovede je JSON. Adresa URL žiadosti je takto: https://www.goodreads.com/book/review_counts.json .
Trvá štyri parametre:
kľúč, ktorý je kľúčom pre vývojárovčísla ISBN- poľa alebo jeden reťazec oddelený čiarou kódov ISBN kníh, na ktorých chceme štatistiky recenziíformát- formát odpovede (aj keď vôbec nie som si istý, prečo existuje, pretože odpoveď bude vždy v JSON.) Plány pre budúce implementácie?)zavolaj späť, funkciu, ktorá ukončí odpoveď JSON
Vezmime dve knihy; Hlava Prvá Java, prvé vydanie (ISBN: 0596009208) a JavaScript: Dobré diely, 1. vydanie (ISBN: 0596517742) a získajte ich štatistiky prehľadu. Adresa URL žiadosti je takto:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
A responseText po zdobení vyzerá takto.
"id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "ratings_count": 1842, "reviews_count": 3599, "text_reviews_count" : 2016, work_reviews_count: 3943, "work_text_reviews_count": 136, "average_rating": "4.16", id id 2998152, isbn "0596517742, isbn13, 9780596517748, : 4430, recenzie_count: 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "average_rating": "4.22"
Ak chcete hodnotenie hodnotenia Hlava Prvá Java, prvé vydanie kniha, je to v myJSON.books [0] .average_rating. ratings_count a reviews_count kľúče v objektoch predstavujú celkový počet hodnotení a recenzie vykonané pre príslušné vydanie knihy.
podobne , text_reviews_count predstavuje celkový textový prehľad o konkrétnom vydaní knihy. kdežto work_ratings_count, work_reviews_count a work_text_reviews_count predstavujú celkové hodnotenia, recenzie a textové recenzie všetkých edícií.
Ak kliknete na údaje o hodnotení JavaScript: Dobré diely (1. vydanie) v Goodreads to zobrazí.
Všetky tieto recenzné informácie môžete použiť, ak chcete alebo len zobraziť hviezdičkové hodnotenie knihy pomocou priemerné hodnotenie kľúčovú hodnotu.
Poznámka: Podľa dokumentácie API, “Aplikácia Goodreads API vám poskytuje plný prístup k meta-dátam vlastneným spoločnosťou Goodreads, ale nedáva vám plný prístup k meta-dátach kníh dodávaným tretími stranami, ako je Ingram. Obrázky obalov kníh, popisy a ďalšie údaje z tretích strán môžu byť vylúčené, pretože nemáme licenciu na distribúciu týchto údajov prostredníctvom rozhrania API.”
Akonáhle ste si pripravili kryty a popisy kníh, môžete zobraziť informácie o knihe trochu ako nižšie.
