Come ottenere valutazioni di Goodreads tramite API
Per gli amanti dei libri che amano uno specifico genere, probabilmente controlleranno le raccomandazioni di un amico piuttosto che seguire una lista di bestseller. Questo è il motivo per cui Amazon Goodreads è un sito preferito dai lettori accaniti. È un posto in cui puoi trovare un ampio database di libri, consigli e recensioni di altri amanti dei libri.
Goodreads fornisce anche un'API per gli sviluppatori accedi ai suoi dati e personalizza ulteriormente come da nostra applicazione. Oggi vedremo come recuperare le valutazioni del libro Goodreads tramite l'API Goodreads utilizzando il codice ISBN o il numero del libro standard internazionale, che può essere utilizzato in futuro durante la visualizzazione delle informazioni sui libri e simili sul tuo sito web.
Per iniziare, accedi o registrati con un nome, e-mail id e password per Goodreads e vai a https://www.goodreads.com/api/keys (Link). Immettere il nome dell'applicazione e il nome dell'azienda e generare la chiave API. Quindi verifica il tuo account tramite l'e-mail ricevuta nell'ID e-mail che hai inserito.
Assicurati di consultare i Termini di servizio per gli sviluppatori per l'API. Hanno anche un elenco di metodi API nella loro pagina API, alcuni di questi metodi richiedono l'autenticazione OAuth, il resto solo bisogno della chiave dello sviluppatore, come quello che vedremo in questo post.
Il tipo di risposta di questi metodi varia, è solo in XML o JSON, o un'opzione per scegliere tra questi due utilizzando il formato parametro.
book.review_counts è un metodo API Goodreads che recupera tutte le statistiche di revisione per un elenco di ISBN di libri. Il suo tipo di risposta è JSON. L'URL della richiesta è simile a questo: https://www.goodreads.com/book/review_counts.json .
Ci vogliono quattro parametri:
chiave, che è la chiave dello sviluppatoreISBN- un array o una singola stringa separata da virgola dei codici ISBN dei libri di cui vogliamo le statistiche di revisioneformato- il formato della risposta (anche se in tutta onestà, non sono davvero sicuro del motivo per cui questo esiste, dal momento che la risposta sarà sempre in JSON. Piani per future implementazioni?)richiama, la funzione che riassumerà la risposta JSON
Prendiamo i due libri; Head First Java, Prima edizione (ISBN: 0596009208) e JavaScript: The Good Parts, 1a edizione (ISBN: 0596517742) e ottieni le loro statistiche sulle recensioni. L'URL della richiesta è come questo:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
E il responseText dopo l'abbellimento assomiglia a questo.
"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"]
Se vuoi la valutazione del Head First Java, Prima edizione libro, è dentro myJSON.books [0] .average_rating. Il ratings_count e reviews_count le chiavi negli oggetti rappresentano il numero totale di voti espressi e recensioni fatte per quella particolare edizione del libro.
allo stesso modo , text_reviews_count rappresenta le revisioni totali di solo testo della particolare edizione del libro. Mentre work_ratings_count, work_reviews_count e work_text_reviews_count rappresentano le valutazioni totali, recensioni e recensioni di solo testo di tutte le edizioni.
Se clicchi su Rating Details di JavaScript: The Good Parts (1st Edition) in Goodreads lo mostrerà.
Puoi utilizzare tutte le informazioni di revisione aggiuntive se desideri o semplicemente visualizzare una valutazione a stelle per il libro utilizzando il voto medio valore chiave.
Nota: Secondo la documentazione di API, “L'API Goodreads ti dà pieno accesso ai meta-dati di proprietà di Goodreads, ma non ti dà pieno accesso ai meta-dati di libri forniti da terze parti come Ingram. Potrebbero essere escluse le immagini di copertina del libro, le descrizioni e altri dati da fonti di terze parti, perché non abbiamo una licenza per distribuire questi dati tramite la nostra API.”
Dopo aver letto le copertine e le descrizioni dei libri, puoi visualizzare le informazioni del libro in un modo simile al seguente.
