Πώς να λάβετε τις βαθμολογίες Goodreads μέσω API

Για τους λάτρεις των βιβλίων που έχουν μια προτίμηση για ένα συγκεκριμένο είδος, πιθανότατα θα ελέγξουν τη σύσταση ενός φίλου παρά να ακολουθήσουν μια λίστα με τους καλύτερους πωλητές. Αυτός είναι ο λόγος για τον οποίο το Amazon's Goodreads είναι ένα σελιδοδείκτη για τους άπληστους αναγνώστες. Είναι ένας τόπος όπου μπορείτε να βρείτε μια εκτενή βάση δεδομένων με βιβλία, συστάσεις και σχόλια από τους συναδέλφους τους λάτρεις του βιβλίου.

Το Goodreads παρέχει επίσης ένα API για προγραμματιστές πρόσβαση στα δεδομένα της και περαιτέρω εξατομίκευση σύμφωνα με την αίτησή μας. Σήμερα θα δούμε πώς μπορείτε να ανακτήσετε τις αξιολογήσεις βιβλίων Goodreads μέσω του Goodreads API χρησιμοποιώντας τον ISBN ή τον διεθνή πρότυπο αριθμό βιβλίου, ο οποίος μπορεί αργότερα να χρησιμοποιηθεί κατά την εμφάνιση πληροφοριών βιβλίου και αυτών στον ιστότοπό σας.

Για να ξεκινήσετε, συνδεθείτε ή εγγραφείτε με όνομα, διεύθυνση ηλεκτρονικού ταχυδρομείου και κωδικό πρόσβασης στο Goodreads και πηγαίνετε στο https://www.goodreads.com/api/keys (Σύνδεσμος). Καταχωρίστε οποιοδήποτε όνομα εφαρμογής και όνομα εταιρείας και δημιουργήστε το κλειδί API. Στη συνέχεια, επαληθεύστε τον λογαριασμό σας μέσω του μηνύματος που λάβατε με το αναγνωριστικό ηλεκτρονικού ταχυδρομείου που καταχωρίσατε.

Βεβαιωθείτε ότι έχετε ελέγξει τους Όρους Παροχής Υπηρεσιών για προγραμματιστές για το API. Έχουν επίσης μια λίστα με τις μεθόδους API στη σελίδα API τους, μερικές από αυτές τις μεθόδους θα απαιτούν έλεγχο ταυτότητας OAuth, οι υπόλοιποι μόνο χρειάζονται το κλειδί προγραμματιστή, όπως αυτή που θα δούμε σε αυτή τη θέση.

Ο τύπος απόκρισης αυτών των μεθόδων ποικίλλει, είναι είτε μόνο σε XML είτε JSON, ή μια επιλογή για να επιλέξετε μεταξύ αυτών των δύο χρησιμοποιώντας το μορφή παράμετρο.

book.review_counts είναι μια μέθοδος API Goodreads που θα συγκεντρώσει όλα τα στατιστικά στοιχεία ανασκόπησης για μια λίστα βιβλίων ISBN βιβλίων. Ο τύπος απάντησης είναι JSON. Η διεύθυνση URL αιτήματος είναι η εξής: https://www.goodreads.com/book/review_counts.json .

Χρειάζονται τέσσερις παράμετροι:

• κλειδί, που είναι το κλειδί του προγραμματιστή
• isbns - μια σειρά ή μια ξεχωριστή σειρά με κόμματα των ISBN των βιβλίων που θέλουμε τα στατιστικά στοιχεία ανασκόπησης
• μορφή - η μορφή της απάντησης (αν και με κάθε ειλικρίνεια, δεν είμαι πραγματικά βέβαιος γιατί υπάρχει, γιατί η απάντηση θα είναι πάντα στο JSON.) Σχέδια για μελλοντικές εφαρμογές;)
• επανάκλησης, η λειτουργία που θα ολοκληρώσει την απάντηση JSON

Ας πάρουμε τα δύο βιβλία. Κεφάλαιο Πρώτη Java, Πρώτη έκδοση (ISBN: 0596009208) και JavaScript: Τα καλά μέρη, 1η έκδοση (ISBN: 0596517742) και να λάβετε τα στατιστικά σχόλια τους. Η διεύθυνση URL αιτήματος είναι η εξής:

https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742 

Και το responseText μετά την εξολόθρευση μοιάζει με αυτό.

"βιβλία": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "ratings_count": 1842, "reviews_count": 3599, "work_ratings_count" : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "average_rating": "4.16", id: 2998152, isbn " : 4430, "reviews_count": 8921, "work_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "average_rating": "4.22" 

Εάν θέλετε την αξιολόγηση του Κεφάλαιο Πρώτη έκδοση Java, πρώτη έκδοση βιβλίο, είναι μέσα myJSON.books [0] .average_rating. ο ratings_count και reviews_count τα πλήκτρα στα αντικείμενα αντιπροσωπεύουν το συνολικό αριθμό αξιολογήσεων και τις αξιολογήσεις που έγιναν για τη συγκεκριμένη έκδοση του βιβλίου.

Ομοίως , text_reviews_count αντιπροσωπεύει το συνολικό σχόλιο μόνο για το κείμενο της συγκεκριμένης έκδοσης του βιβλίου. Ενώ work_ratings_count, work_reviews_count και work_text_reviews_count αντιπροσωπεύουν τις συνολικές αξιολογήσεις, σχόλια και κριτικές μόνο για το κείμενο όλων των εκδόσεων.

Αν κάνετε κλικ στις Λεπτομέρειες αξιολόγησης του JavaScript: Τα καλά μέρη (1η έκδοση) στο Goodreads θα εμφανιστεί αυτό.

Μπορείτε να χρησιμοποιήσετε όλες αυτές τις επιπλέον πληροφορίες αναθεώρησης εάν θέλετε ή απλά να εμφανίσετε μια βαθμολογία αστεριών για το βιβλίο χρησιμοποιώντας το average_rating βασική τιμή.

Σημείωση: Σύμφωνα με την τεκμηρίωση API, “Το Goodreads API σάς παρέχει πλήρη πρόσβαση σε μεταδεδομένα που ανήκουν στην Goodreads, αλλά δεν σας παρέχει πλήρη πρόσβαση σε μεταδεδομένα βιβλίων που παρέχονται από τρίτους όπως το Ingram. Μπορούν να αποκλειστούν εικόνες κάλυψης βιβλίων, περιγραφές και άλλα δεδομένα από πηγές τρίτων, επειδή δεν διαθέτουμε άδεια για τη διανομή αυτών των δεδομένων μέσω του API.”

Αφού προετοιμάσετε τα καλύμματα και τις περιγραφές του βιβλίου, μπορείτε να εμφανίσετε τις πληροφορίες του βιβλίου κάπως όπως παρακάτω.