Kaip gauti „Goodreads“ reitingus naudojant API
Knygų mylėtojams, kurie mėgsta tam tikrą žanrą, jie tikriausiai patikrins draugo rekomendaciją, nei atliks bestselerių sąrašą. Štai kodėl „Amazon“ „Goodreads“ yra žymių svetainių, kuriose yra skaitytojai, žymėjimas. Tai vieta, kur galima rasti išsamią knygų, rekomendacijų ir atsiliepimų duomenų bazę su kitais knygų mylėtojais.
„Goodreads“ taip pat suteikia API programuotojams prieigą prie savo duomenų ir toliau individualizuoti tai, kaip mūsų paraiškoje. Šiandien pamatysime, kaip gauti „Goodreads“ knygų reitingus per „Goodreads“ API, naudojant ISBN arba tarptautinį standartinį knygų numerį, kuris vėliau gali būti naudojamas parodant knygų informaciją ir tokią informaciją jūsų svetainėje.
Norėdami pradėti, prisijunkite arba užsiregistruokite naudodami „Goodreads“ vardą, el. Pašto adresą ir slaptažodį ir eikite į https://www.goodreads.com/api/keys (nuoroda). Įveskite bet kurį programos pavadinimą ir įmonės pavadinimą ir sukurkite savo API raktą. Tada patvirtinkite paskyrą naudodami el. Pašto adresą, kurį gavote įvestame el. Pašto ID.
Būtinai patikrinkite API kūrėjo paslaugų teikimo sąlygas. Jie taip pat turi API metodų sąrašą savo API puslapyje, kai kuriems iš šių metodų reikės OAuth autentifikavimo, kiti bus tik reikia kūrėjo rakto, kaip tai, ką mes peržiūrėsime šiame pranešime.
Šių metodų atsakymo tipas skiriasi - tai tik XML arba JSON, arba galimybė pasirinkti tarp šių dviejų naudojant formatą parametras.
book.review_counts yra „Goodreads“ API metodas, kuris atsiųs visas knygų ISBN sąrašo apžvalgas. Jo reponso tipas yra JSON. Prašymo URL yra toks: https://www.goodreads.com/book/review_counts.json .
Jis turi keturis parametrus:
Raktas, kuris yra kūrėjo raktasIsbns- masyvas arba atskiras kableliais atskirtų knygų ISBN, kurias norime peržiūrėtiformatą- atsakymo formatas (nors ir visiškai sąžiningai, aš tikrai nežinau, kodėl toks egzistuoja, nes atsakymas visada bus JSON. Planai ateityje įgyvendinti?)perskambink, funkcija, kuri apvyks JSON atsakymu
Paimkime dvi knygas; Vadovas pirmasis „Java“, pirmasis leidimas (ISBN: 0596009208) ir „JavaScript“: „The Good Parts“, pirmasis leidimas (ISBN: 0596517742) ir gauti jų peržiūros statistiką. Prašymo URL yra toks:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
Ir answerText po beautification atrodo taip.
"books": ["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“: 381, „Average_rating“: „4.22“]
Jei norite Pirmoji „Java“ versija, pirmasis leidimas knyga, tai yra myJSON.books [0] .average_rating. The rating_count ir atsiliepimų skaičius Objektų raktai rodo bendrą įvertinimų skaičių ir apžvalgas, atliktas tam tikram knygos leidimui.
Panašiai , text_reviews_count reiškia visas tik knygos tikrojo teksto apžvalgas. Kadangi work_ratings_count, work_reviews_count ir work_text_reviews_count atspindi visus visų leidinių reitingus, apžvalgas ir tik tekstą.
Jei spustelėsite „Reitingo duomenys“, „JavaScript“: geros dalys (1-asis leidimas) „Goodreads“ parodys tai.
Galite naudoti visą papildomą peržiūros informaciją, jei norite arba tiesiog rodyti žvaigždės įvertinimą knygai naudodami Vidutinis reitingas pagrindinė vertė.
Pastaba: Pagal API dokumentaciją, “„Goodreads“ API suteikia jums pilną prieigą prie „Goodreads“ priklausančių metaduomenų, tačiau nesuteikia jums visiškos prieigos prie trečiųjų šalių, pvz., „Ingram“ pateiktų knygų meta duomenų. Knygos viršelio vaizdai, aprašymai ir kiti duomenys iš trečiųjų šalių šaltinių gali būti atmesti, nes neturime licencijos šių duomenų platinimui per API.”
Perskaitę knygų viršelius ir aprašymus, galite rodyti šiek tiek panašią knygų informaciją.
