API ile Goodreads Ratings Nasıl Gidilir?
Belirli bir türden hoşlanan kitap severler için, muhtemelen herhangi bir en çok satanlar listesine uymak yerine bir arkadaşının tavsiyesine bakacaklar. Bu yüzden Amazon'un Goodreads hevesli okuyucular için yer imlerine eklenmiş bir sitedir. Kitap severlerin kapsamlı kitaplarını, önerilerini ve yorumlarını içeren bir veritabanı bulabileceğiniz bir yer.
Goodreads ayrıca geliştiriciler için bir API sağlar. verilerine erişmek ve daha fazla kişiselleştirmek uygulamamıza göre. Bugün, Goodreads kitap derecelendirmelerini, daha sonra kitap bilgilerini ve web sitenizde görüntülerken kullanılabilecek ISBN veya Uluslararası Standart Kitap Numarası'nı kullanarak Goodreads API'sini kullanarak nasıl alacağımızı göreceğiz..
Başlamak için, ya oturum açın ya da bir isim, e-posta kimliği ve şifre ile Goodreads adresine gidin ve https://www.goodreads.com/api/keys (Bağlantı). Herhangi bir uygulama adını ve şirket adını girin ve API anahtarınızı oluşturun. Ardından, girdiğiniz e-posta kimliğinde alınan e-posta yoluyla hesabınızı doğrulayın..
API için Geliştirici Hizmet Şartlarını kontrol ettiğinizden emin olun. Ayrıca, API sayfalarında bir API yöntemleri listesi de vardır, bu yöntemlerden bazıları OAuth kimlik doğrulaması gerektirir; geliştirici anahtarına ihtiyacınız var, Bu yayına bakacağımız gibi.
Bu yöntemlerin yanıt türü değişebilir, yalnızca XML veya JSON'da ya da bu ikisi arasında seçim yapma seçeneği biçim parametre.
book.review_counts kitap ISBN'lerinin bir listesi için tüm inceleme istatistiklerini elde edecek bir Goodreads API yöntemidir. Yanıt tipi JSON'dur. İstek URL'si şunun gibidir: https://www.goodreads.com/book/review_counts.json .
Dört parametre alır:
anahtar, geliştirici anahtarı hangisiISBNler- Dizin veya tek virgülle ayrılmış, dizinin incelenen istatistiklerini istediğimiz kitapların ISBN'lerinibiçim- Yanıtın biçimi (tüm dürüstlükte olsa da, bunun neden var olduğundan emin değilim, çünkü cevap her zaman JSON'da olacak. Gelecekteki uygulamalar için planlar?)geri aramak, JSON yanıtını saracak işlev
İki kitabı alalım; İlk Java Başkanı, İlk baskı (ISBN: 0596009208) ve JavaScript: İyi Parçalar, 1. baskı (ISBN: 0596517742) ve inceleme istatistiklerini alın. İstek URL'si şunun gibidir:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
Ve responseText güzelleştirme sonra böyle görünüyor.
"books": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "derecelendirme_sayısı": 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": "4.22"]
Eğer derecelendirmesini istiyorsanız Önce Java, Birinci Basım kitap, içinde myJSON.books [0] .average_rating. RATINGS_COUNT ve reviews_count Nesnelerin içindeki anahtarlar, kitabın belirli bir basımı için yapılan toplam derecelendirme ve inceleme sayısını temsil eder..
benzer şekilde , text_reviews_count Kitabın belirli sayısının yalnızca salt metin incelemelerini temsil eder. Buna karşılık work_ratings_count, work_reviews_count ve work_text_reviews_count tüm baskıların toplam derecelendirmelerini, incelemelerini ve salt metin incelemelerini temsil eder.
Eğer Rating Details’ın üzerine tıklarsanız JavaScript: İyi Parçalar (1. Baskı) Goodreads'ta bunu görüntüler.
Bu ek inceleme bilgilerini kullanarak kitap için yıldız derecelendirmesi kullanmak veya kitap için yıldız derecelendirmesi görüntülemek isteyebilirsiniz. Ortalama puanı anahtar değer.
Not: API dokümantasyonuna göre, “Goodreads API, Goodreads'ın sahip olduğu meta verilere tam erişim sağlar, ancak Ingram gibi üçüncü taraflarca sağlanan meta verilere kitap erişimine tam erişim sağlamaz. Üçüncü taraf kaynaklardan gelen kitap kapağı resimleri, açıklamaları ve diğer veriler hariç tutulabilir, çünkü bu verileri API üzerinden dağıtma lisansımız yok..”
Kitap kapaklarını ve açıklamalarını hazırladıktan sonra, kitap bilgilerini aşağıda gösterildiği şekilde biraz görüntüleyebilirsiniz..
