Kako dobiti Goodreads Ratings putem API-ja
Za ljubitelje knjiga koji imaju sklonost prema određenom žanru, vjerojatno će provjeriti preporuku prijatelja nego slijediti bilo koji popis bestselera. To je razlog zašto Amazon's Goodreads je označen site za pohlepan čitatelja. To je mjesto gdje možete pronaći opsežnu bazu knjiga, preporuka i osvrta ljubitelja knjiga.
Goodreads također nudi API za programere pristupite njegovim podacima i dodatno personalizirajte po našoj prijavi. Danas ćemo vidjeti kako preuzeti Goodreads ocjene knjiga putem Goodreads API-ja pomoću ISBN-a ili Međunarodnog standardnog broja knjige, koji se kasnije može koristiti pri prikazivanju informacija o knjizi i slično na vašoj web-lokaciji.
Za početak, prijavite se ili se prijavite s imenom, ID-om e-pošte i zaporkom na Goodreads i idite na https://www.goodreads.com/api/keys (veza). Unesite bilo koje ime i naziv tvrtke i generirajte API ključ. Potom potvrdite svoj račun putem e-pošte primljene u ID-u e-pošte koji ste unijeli.
Svakako provjerite njihove uvjete pružanja usluge za razvojne programere za API. Oni također imaju popis API metoda na svojoj API stranici, neke od tih metoda zahtijevat će OAuth autentifikaciju, ostalo će samo trebate ključ razvojnog programera, poput one koju ćemo pogledati u ovom postu.
Vrsta odgovora tih metoda varira, ili je to samo u XML-u ili JSON-u, ili mogućnost izbora između ove dvije vrste pomoću format parametar.
book.review_counts je metoda Goodreads API-ja koja će dohvatiti sve statistike pregleda za popis ISBN-ova knjige. Njegov odgovor je JSON. URL zahtjeva je ovako: https://www.goodreads.com/book/review_counts.json .
Potrebna su četiri parametra:
ključ, što je ključ razvojnog programeraISBN- niz ili pojedinačni niz ISBN-ova knjiga koje želimo pregledatiformat- format odgovora (iako iskreno, nisam baš siguran zašto postoji, jer će odgovor uvijek biti u JSON-u. Planovi za buduće implementacije?)uzvratiti poziv, funkcija koja će završiti JSON odgovor
Uzmimo dvije knjige; Head First Java, Prvo izdanje (ISBN: 0596009208) i JavaScript: Dobri dijelovi, 1. izdanje (ISBN: 0596517742) i pregledajte njihovu statistiku. URL zahtjeva je ovako:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
I responseText nakon uljepšavanja izgleda ovako.
"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"]
Ako želite ocjenu Prva prva Java, prvo izdanje knjiga, ona je unutra myJSON.books [0] .average_rating. RATINGS_COUNT i reviews_count ključevi u objektima predstavljaju ukupan broj ocjenjivanja i ocjene izrađene za određeno izdanje knjige.
slično , text_reviews_count predstavlja ukupne tekstualne recenzije pojedinog izdanja knjige. Dok work_ratings_count, work_reviews_count i work_text_reviews_count predstavljaju ukupne ocjene, recenzije i recenzije samo za sva izdanja.
Ako kliknete na pojedinosti o ocjeni JavaScript: dobri dijelovi (1. izdanje) u Goodreads će to prikazati.
Možete upotrijebiti sve te dodatne informacije o pregledu ako želite ili samo prikazati ocjenu zvjezdicom za knjigu pomoću Prosječna ocjena ključna vrijednost.
Bilješka: Prema API dokumentaciji, “API Goodreads vam daje puni pristup metapodacima u vlasništvu Goodreads, ali vam ne daje puni pristup metapodacima za knjige koje su dostavile treće strane, kao što je Ingram. Slike naslovnica, opisi i drugi podaci iz izvora trećih strana mogu biti isključeni jer nemamo licencu za distribuciju tih podataka putem našeg API-ja.”
Nakon što pripremite naslovnice i opise knjiga, možete prikazati informacije o knjizi kao što je dolje.
