كيفية الحصول على تصنيفات Goodreads عبر API

لمحبي الكتب الذين لديهم إعجاب بنوع معين ، من المحتمل أن يقوموا بمراجعة توصية أحد الأصدقاء من متابعة أي قائمة من أفضل الكتب مبيعًا. هذا هو السبب في أن موقع Amazon's Goodreads هو موقع مرجعي للقراء المتعطشين. إنه مكان يمكنك من خلاله العثور على قاعدة بيانات شاملة للكتب والتوصيات والتعليقات من قِبل عشاق الكتب.

يوفر Goodreads أيضًا واجهة برمجة التطبيقات للمطورين الوصول إلى البيانات الخاصة به وتخصيص أكثر ذلك حسب طلبنا. سنرى اليوم كيفية استرداد تصنيفات كتاب Goodreads من خلال واجهة برمجة تطبيقات Goodreads باستخدام رقم ISBN أو الرقم القياسي الدولي للكتاب ، والذي يمكن استخدامه لاحقًا أثناء عرض معلومات الكتاب وما شابه ذلك على موقع الويب الخاص بك.

للبدء ، إما تسجيل الدخول أو التسجيل باستخدام اسم معرف البريد الإلكتروني وكلمة المرور إلى Goodreads والانتقال إلى https://www.goodreads.com/api/keys (حلقة الوصل). أدخل أي اسم التطبيق واسم الشركة وإنشاء مفتاح API الخاص بك. ثم تحقق من حسابك من خلال البريد الإلكتروني المستلم في معرف البريد الإلكتروني الذي أدخلته.

تأكد من مراجعة شروط خدمة مطوري البرامج لواجهة برمجة التطبيقات. لديهم أيضًا قائمة بأساليب API في صفحة API الخاصة بهم ، وبعض هذه الأساليب سوف تتطلب مصادقة OAuth ، والباقي فقط بحاجة إلى مفتاح المطور, مثل واحد سننظر في هذا المنصب.

يختلف نوع استجابة هذه الأساليب ، إما في XML أو JSON فقط ، أو خيار للاختيار بين هاتين الطريقتين باستخدام شكل معامل.

book.review_counts هي طريقة واجهة برمجة تطبيقات Goodreads والتي ستجلب جميع إحصائيات المراجعة للحصول على قائمة بأرقام ISBN للكتاب. نوع الرد هو JSON. يشبه عنوان URL للطلب: https://www.goodreads.com/book/review_counts.json .

يستغرق أربعة معايير:

مفتاح, وهو مفتاح المطور
أرقام ISBN - مجموعة أو سلسلة مفصولة بفواصل من أرقام ISBN للكتب التي نريد إحصائيات المراجعة الخاصة بها
شكل - تنسيق الاستجابة (على الرغم من الصدق التام ، لست متأكدًا من سبب وجود هذا الرد ، لأن الاستجابة ستكون دائمًا في JSON. خطط للتطبيقات المستقبلية؟)
أتصل مرة أخرى, الوظيفة التي ستختتم استجابة JSON

لنأخذ الكتابين ؛ رئيس جافا أولا ، الطبعة الأولى (ISBN: 0596009208) و جافا سكريبت: الأجزاء الجيدة ، الطبعة الأولى (ISBN: 0596517742) واحصل على إحصائيات المراجعة الخاصة بهم. عنوان URL للطلب يشبه هذا:

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

و ال responseText بعد تجميل يشبه هذا.

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

إذا كنت تريد تصنيف رئيس جافا أولا ، الطبعة الأولى كتاب ، إنه في myJSON.books [0] .average_rating. ال RATINGS_COUNT و reviews_count تمثل المفاتيح في الكائنات إجمالي عدد التصنيفات المدلى بها والمراجعات التي تمت لهذه الطبعة المعينة من الكتاب.

وبالمثل , text_reviews_count يمثل إجمالي المراجعات النصية فقط للطبعة المعينة من الكتاب. بينما work_ratings_count, work_reviews_count و work_text_reviews_count تمثل إجمالي التقييمات والتعليقات والمراجعات النصية فقط لجميع الطبعات.

إذا نقرت على تصنيف تفاصيل جافا سكريبت: الأجزاء الجيدة (الطبعة الأولى) في Goodreads انها سوف يعرض هذا.

يمكنك استخدام جميع معلومات المراجعة الإضافية هذه إذا كنت ترغب في عرض تصنيف النجوم للكتاب باستخدام متوسط تقييم القيمة الرئيسية.

ملحوظة: وفقا ل API documentationenation, “تمنحك واجهة برمجة تطبيقات Goodreads وصولاً كاملاً إلى البيانات الوصفية المملوكة لشركة Goodreads ، لكنها لا تمنحك حق الوصول الكامل إلى بيانات التعريف المحجوزة المقدمة من جهات خارجية مثل Ingram. قد يتم استبعاد صور غلاف الكتاب ، والأوصاف ، وغيرها من البيانات من مصادر الطرف الثالث ، لأنه ليس لدينا ترخيص لتوزيع هذه البيانات عبر واجهة برمجة التطبيقات.”

بمجرد الانتهاء من إعداد أغلفة الكتب وأوصافها ، يمكنك عرض معلومات الكتاب كما هو موضح أدناه.