Hogyan juthat el a Goodreads minősítésekhez az API segítségével
Azok a könyv szerelmeseinek, akik egy adott műfajra tetszenek, valószínűleg megnézik egy barátjának ajánlását, mint a bestseller listák követése. Ezért az Amazon Goodreads egy könyvjelzővel ellátott webhely a lelkes olvasók számára. Ez egy olyan hely, ahol a könyvek, ajánlások és vélemények széles körű adatbázisa megtalálható a könyvkönyvelők számára.
A Goodreads API-t is biztosít a fejlesztők számára hozzáférjen az adatokhoz, és személyre szabhatja az alkalmazásunk szerint. Ma látni fogjuk, hogyan nyerhetjük le a Goodreads könyveit a Goodreads API-n keresztül az ISBN vagy a nemzetközi szabványos könyvszám használatával, amelyet később használhat a könyvinformációk és az ilyenek megjelenítésekor a webhelyén.
Először is jelentkezzen be vagy regisztráljon egy nevet, e-mail azonosítót és jelszót a Goodreads-nak és menjen https://www.goodreads.com/api/keys (link). Adja meg az alkalmazás nevét és cégnevét, és generálja az API kulcsot. Ezután ellenőrizze fiókját a megadott e-mail azonosítóban kapott e-mailben.
Győződjön meg róla, hogy megvizsgálja az API fejlesztői használati feltételeit. Az API-oldalukon megtalálhatók az API-módszerek listája is, ezek közül néhány az OAuth-hitelesítést igényli, a többi csak szükség van a fejlesztői kulcsra, mint az, amit ebben a bejegyzésben fogunk nézni.
Ezeknek a módszereknek a válasz típusa változik, vagy csak XML-ben vagy JSON-ben, vagy egy lehetőség arra, hogy a kettő közül választja ki a formátum paraméter.
book.review_counts egy Goodreads API-módszer, amely az összes könyvstatisztikát fogja megkeresni az ISBN-könyvek listájához. Reponse típusa a JSON. A kérés URL-je ilyen: https://www.goodreads.com/book/review_counts.json .
Négy paramétert vesz igénybe:
kulcs, ami a fejlesztői kulcsISBN-ek- egy tömb vagy egy vesszővel elválasztott sztring a könyvek ISBN-jéből, amelyeket a felülvizsgálat statisztikái szeretneformátum- a válasz formátuma (bár őszintén szólva, nem vagyok biztos benne, miért létezik ez, mivel a válasz mindig a JSON-ban lesz. Tervek a jövőbeli megvalósításokhoz?)visszahív, a JSON válasz feloldása
Vegyük a két könyvet; Fejezd be az első Java-ot, az első kiadást (ISBN: 0596009208) és JavaScript: The Good Parts, 1. kiadás (ISBN: 0596517742) és megkapja a felülvizsgálati statisztikát. A kérés URL-je ilyen:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
És a responseText a szépítés után így néz ki.
"books": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "rating_count": 1842, "reviews_count": 3599, "text_reviews_count": 124, "work_ratings_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, "átlagos_gyors": "4.22"]
Ha azt szeretné, hogy a Fejezd be az első Java-ot, az első kiadást könyv, ez benne van myJSON.books [0] .average_rating. A RATINGS_COUNT és reviews_count az objektumok gombjai a leadott minősítések és a könyv adott kiadásaihoz kapcsolódó értékelések teljes számát képviselik.
Hasonlóképpen , text_reviews_count a könyv adott kiadásának teljes szöveges áttekintését jelenti. mivel work_ratings_count, work_reviews_count és work_text_reviews_count képviselje az összes kiadás összes értékelését, értékelését és szöveges értékelését.
Ha rákattint a Értékelés részletei elemre JavaScript: A jó részek (1. kiadás) a Goodreads-ban ez meg fog jelenni.
Az összes extra felülvizsgálati információt akkor használhatja, ha azt szeretné, vagy csak egy csillagértéket jelenít meg a könyvhez a átlagos értékelés kulcs érték.
jegyzet: Az API dokumentációja szerint, “A Goodreads API teljes hozzáférést biztosít a Goodreads tulajdonában lévő metaadatokhoz, de nem biztosít teljes hozzáférést a harmadik felek, például az Ingram által szolgáltatott könyv-metaadatokhoz. Lehet, hogy kizárják a könyvborító képeit, leírásait és a harmadik felektől származó forrásokból származó egyéb adatokat, mivel nincs engedélyünk ezen adatok API-n keresztüli terjesztésére.”
Miután elkészítette a könyvborítókat és leírásokat, megjelenítheti az alábbi könyvadatokat.
