Startseite » Codierung » So erhalten Sie Goodreads-Bewertungen über die API

    So erhalten Sie Goodreads-Bewertungen über die API

    Für Buchliebhaber, die eine Vorliebe für ein bestimmtes Genre haben, werden sie wahrscheinlich die Empfehlung eines Freundes durchgehen, bevor sie einer Bestsellerliste folgen. Aus diesem Grund ist Amazon Goodreads eine Seite mit Lesezeichen für begeisterte Leser. Hier finden Sie eine umfangreiche Datenbank mit Büchern, Empfehlungen und Rezensionen von Buchfreunden.

    Goodreads bietet auch eine API für Entwickler auf seine Daten zugreifen und weiter personalisieren es nach unserer anwendung. Heute erfahren Sie, wie Sie Goodreads-Buchbewertungen über die Goodreads-API mithilfe der ISBN oder der International Standard Book Number abrufen. Diese Nummer kann später verwendet werden, wenn Sie Buchinformationen und dergleichen auf Ihrer Website anzeigen.

    Um zu beginnen, loggen Sie sich entweder ein oder melden Sie sich mit einem Namen, einer E-Mail-Adresse und einem Passwort an Goodreads an und gehen Sie zu https://www.goodreads.com/api/keys (Verknüpfung). Geben Sie einen beliebigen Anwendungsnamen und Firmennamen ein und generieren Sie Ihren API-Schlüssel. Überprüfen Sie dann Ihr Konto anhand der E-Mail, die Sie in der von Ihnen eingegebenen E-Mail-ID erhalten haben.

    Vergewissern Sie sich, dass Sie die Nutzungsbedingungen für Entwickler für die API überprüfen. Sie haben auch eine Liste von API-Methoden auf ihrer API-Seite. Einige dieser Methoden erfordern die OAuth-Authentifizierung, der Rest nur brauche den Entwicklerschlüssel, wie die, die wir in diesem Beitrag betrachten werden.

    Der Antworttyp dieser Methoden ist unterschiedlich, entweder nur in XML oder JSON oder mit Hilfe der Option Format Parameter.

    book.review_counts ist eine Goodreads-API-Methode, die alle Überprüfungsstatistiken für eine Liste von Buch-ISBNs abruft. Der Antworttyp ist JSON. Die Anforderungs-URL lautet wie folgt: https://www.goodreads.com/book/review_counts.json .

    Es sind vier Parameter erforderlich:

    • Schlüssel, Welches ist der Entwicklerschlüssel
    • isbns - ein Array oder eine durch Kommas getrennte Zeichenfolge der ISBN-Nummern der Bücher, für die die Überprüfungsstatistik erstellt werden soll
    • Format - das Format der Antwort (obwohl ich ehrlich gesagt nicht wirklich weiß, warum es diese gibt, da die Antwort immer in JSON erfolgt. Planen Sie zukünftige Implementierungen?)
    • Ruf zurück, Die Funktion, die die JSON-Antwort abschließt

    Nehmen wir die beiden Bücher. Head First Java, Erste Ausgabe (ISBN: 0596009208) und JavaScript: Die guten Teile, 1. Auflage (ISBN: 0596517742) und erhalten ihre Bewertungsstatistiken. Die Anforderungs-URL sieht folgendermaßen aus:

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

    Und das responseText nach der Verschönerung sieht das so aus.

    "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"] 

    Wenn Sie die Bewertung von wollen Head First Java, Erste Ausgabe Buch, es ist in myJSON.books [0] .average_rating. Das ratings_count und reviews_count Die Schlüssel in den Objekten stellen die Gesamtzahl der Bewertungen und Bewertungen dar, die für diese bestimmte Ausgabe des Buches vorgenommen wurden.

    Ähnlich , text_reviews_count steht für die gesamte Textüberprüfung der jeweiligen Ausgabe des Buches. Wohingegen work_ratings_count, work_reviews_count und work_text_reviews_count stehen für die Gesamtbewertungen, Rezensionen und Textberichte aller Ausgaben.

    Wenn Sie auf Bewertungsdetails von klicken JavaScript: Die guten Teile (1. Auflage) In Goodreads wird dies angezeigt.

    Sie können alle diese zusätzlichen Überprüfungsinformationen verwenden, wenn Sie die Sternbewertung für das Buch anzeigen möchten durchschnittliche Bewertung Schlüsselwert.

    Hinweis: Laut API-Dokumentation, “Über die Goodreads-API haben Sie vollen Zugriff auf Goodreads-eigene Metadaten, jedoch nicht auf Buchmetadaten, die von Dritten wie z. B. Ingram bereitgestellt werden. Bilder, Beschreibungen und andere Daten von Buchumschlägen von Drittanbietern können ausgeschlossen werden, da wir keine Lizenz zur Verteilung dieser Daten über unsere API haben.”

    Nachdem Sie die Buchumschläge und -beschreibungen gelesen haben, können Sie die Buchinformationen wie unten angezeigt anzeigen.