Kako dobiti Goodreads Ratings prek API-ja
Za ljubitelje knjig, ki imajo radi določen žanr, bodo verjetno preverili priporočilo prijatelja, kot sledi kateremukoli seznamu najboljših prodajalcev. To je razlog, zakaj je Goodreads GoodWorks Amazon mesto za navdušene bralce. To je kraj, kjer lahko najdete obsežno zbirko knjig, priporočil in kritik, ki jih objavijo ljubitelji knjig.
Goodreads ponuja tudi API za razvijalce dostop do njenih podatkov in nadaljnje prilagajanje po naši prijavi. Danes bomo videli, kako pridobiti ocene knjig Goodreads prek API-ja Goodreads z uporabo številke ISBN ali mednarodne standardne knjige, ki se lahko kasneje uporabi pri prikazovanju informacij o knjigah in podobnih na vaši spletni strani..
Če želite začeti, se prijavite ali se prijavite z imenom, e-poštnim ID-jem in geslom za Goodreads in pojdite na https://www.goodreads.com/api/keys (povezava). Vnesite ime in ime podjetja ter ustvarite ključ API. Nato preverite svoj račun z e-poštnim naslovom, ki ste ga prejeli v vneseni e-poštni ID.
Ne pozabite preveriti njihovih pogojev storitve za razvijalce za API. Imajo tudi seznam metod API-ja na strani API-ja, nekatere od teh metod bodo zahtevale preverjanje pristnosti OAuth, ostalo pa bo samo potrebujete ključ razvijalca, podobno tistemu, ki ga bomo pogledali na tem mestu.
Vrsta odziva teh metod je različna, bodisi samo v XML ali JSON, bodisi možnost izbire med tema dvema z uporabo format parameter.
book.review_counts je metoda API Goodreads, ki bo prenesla vse statistične podatke o pregledu za seznam knjig ISBN. Njegov odzivni tip je JSON. URL zahteve je takole: https://www.goodreads.com/book/review_counts.json .
Ima štiri parametre:
tipko, ki je ključ razvijalcaisbns- niz ali posamezen niz oznak ISBN iz knjig, ki jih želimo pregledatiformat- format odziva (čeprav v vseh iskrenosti nisem prepričan, zakaj ta obstaja, saj bo odziv vedno v JSON. Načrti za prihodnje izvedbe?)poklicati nazaj, funkcijo, ki bo zaključila odziv JSON
Vzemimo dve knjigi; Head First Java, Prva izdaja (ISBN: 0596009208) in JavaScript: Dobri deli, 1. izdaja (ISBN: 0596517742) in dobite njihovo pregledno statistiko. URL zahteve je tak:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
In responseText po razvajanju izgleda takole.
"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"]
Če želite oceno Prva prva Java, prva izdaja knjiga, je v myJSON.books [0] .average_rating. The ratings_count in review_count ključi v objektih predstavljajo skupno število oddanih ocen in preglede za to posamezno izdajo knjige.
podobno , text_reviews_count predstavlja celoten pregled besedila posamezne izdaje knjige. Ker work_ratings_count, work_reviews_count in work_text_reviews_count predstavljajo skupne ocene, ocene in samo besedilne ocene vseh izdaj.
Če kliknete na Rating Details of JavaScript: dobri deli (1. izdaja) v Goodreads bo to prikazal.
Vse te dodatne informacije o pregledu lahko uporabite, če želite ali samo prikazati oceno zvezdic za knjigo z uporabo average_rating ključna vrednost.
Opomba: V skladu z dokumentacijo API, “API Goodreads vam omogoča popoln dostop do metapodatkov, ki so v lasti Goodreads, vendar vam ne daje popolnega dostopa do metapodatkov, ki jih posredujejo tretje osebe, kot je Ingram. Slike, opisi in drugi podatki iz knjig iz tretjih oseb so morda izključeni, ker nimamo licence za distribucijo teh podatkov prek API-ja.”
Ko ste pripravili naslovnice in opise knjig, lahko podatke o knjigi prikažete kot spodaj.
