วิธีรับคะแนน Goodreads ผ่าน API
สำหรับคนรักหนังสือที่ชื่นชอบประเภทที่เฉพาะเจาะจงพวกเขาอาจจะตรวจสอบคำแนะนำของเพื่อนมากกว่าทำตามรายชื่อหนังสือขายดี นี่คือเหตุผลที่ Goodreads ของ Amazon เป็นเว็บไซต์ที่คั่นหน้าไว้สำหรับผู้อ่านตัวยง มันเป็นสถานที่ที่คุณสามารถค้นหาฐานข้อมูลที่กว้างขวางของหนังสือคำแนะนำและบทวิจารณ์โดยคนรักหนังสือเพื่อน.
Goodreads ยังมี API สำหรับผู้พัฒนาด้วย เข้าถึงข้อมูลและปรับแต่งเพิ่มเติม มันเป็นตามใบสมัครของเรา วันนี้เราจะมาดูวิธีการดึงเรตติ้งของหนังสือ Goodreads ผ่าน Goodreads API โดยใช้หมายเลข ISBN หรือหมายเลขมาตรฐานสากลซึ่งสามารถนำมาใช้ภายหลังได้ในขณะที่แสดงข้อมูลหนังสือและบนเว็บไซต์ของคุณ.
ในการเริ่มต้นให้ลงชื่อเข้าใช้หรือลงทะเบียนด้วยชื่ออีเมลและรหัสผ่านไปยัง Goodreads แล้วไปที่ https://www.goodreads.com/api/keys (ลิงค์) ป้อนชื่อแอปพลิเคชันและชื่อ บริษัท และสร้างคีย์ API ของคุณ จากนั้นยืนยันบัญชีของคุณผ่านอีเมลที่ได้รับในรหัสอีเมลที่คุณป้อน.
อย่าลืมตรวจสอบข้อกำหนดในการให้บริการสำหรับนักพัฒนาของพวกเขาสำหรับ API พวกเขายังมีรายการวิธีการ API ในหน้า API ของพวกเขาบางวิธีนั้นจะต้องมีการตรวจสอบสิทธิ์ OAuth ส่วนที่เหลือจะเป็นเท่านั้น ต้องการรหัสผู้พัฒนา, เหมือนที่เราจะดูในโพสต์นี้.
ประเภทการตอบสนองของวิธีการเหล่านั้นแตกต่างกันไปมีเฉพาะใน XML หรือ JSON หรือตัวเลือกให้เลือกระหว่างสองวิธีนี้โดยใช้ รูป
พารามิเตอร์.
book.review_counts
เป็นวิธี Goodreads API ที่จะดึงสถิติการตรวจสอบทั้งหมดสำหรับรายการหนังสือ ISBN ประเภทของ reponse คือ JSON URL คำขอมีลักษณะดังนี้: https://www.goodreads.com/book/review_counts.json .
ใช้พารามิเตอร์สี่ตัว:
สำคัญ
, ซึ่งเป็นรหัสผู้พัฒนาเลข ISBN
- อาเรย์หรือสตริงที่คั่นด้วยเครื่องหมายจุลภาคเดี่ยวของ ISBN ของหนังสือที่เราต้องการตรวจสอบสถิติรูป
- รูปแบบของการตอบสนอง (แม้ว่าในความซื่อสัตย์ฉันไม่แน่ใจว่าทำไมสิ่งนี้มีอยู่จริงเนื่องจากการตอบสนองจะอยู่ใน JSON เสมอแผนสำหรับการใช้งานในอนาคต?)โทรกลับ
, ฟังก์ชั่นที่จะสรุปการตอบสนอง JSON
ลองดูหนังสือสองเล่ม; Head First Java, ฉบับพิมพ์ครั้งแรก (ISBN: 0596009208) และ JavaScript: The Good Parts รุ่นที่ 1 (ISBN: 0596517742) และรับสถิติการตรวจสอบของพวกเขา URL คำขอเป็นดังนี้:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
และ responseText
หลังจากความสวยงามดูเหมือนว่านี้.
"books": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "การจัดอันดับ": 1842, "reviews_count": 3599, "ข้อความ _ รีวิว: 124," work_ratings_count " : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "ค่าเฉลี่ยการจัดอันดับ": "4.16", "id": 2998152, "isbn": "0596517742", "isbn13": "9780596517748", "อันดับ" : 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"]
หากคุณต้องการให้คะแนนของ หัวหน้าเฟิร์สชวา, First Edition หนังสือมันอยู่ใน myJSON.books [0] .average_rating
. ratings_count
และ reviews_count
กุญแจในวัตถุแสดงถึงจำนวนคะแนนรวมและบทวิจารณ์ที่จัดทำขึ้นสำหรับหนังสือเล่มนั้น.
เหมือนกับ , text_reviews_count
แสดงให้เห็นถึงความคิดเห็นข้อความอย่างเดียวรวมของรุ่นที่เฉพาะเจาะจงของหนังสือเล่มนี้ แต่ทว่า work_ratings_count
, work_reviews_count
และ work_text_reviews_count
แสดงการจัดอันดับโดยรวมบทวิจารณ์และบทวิจารณ์แบบข้อความอย่างเดียวของทุกฉบับ.
หากคุณคลิกที่รายละเอียดการให้คะแนนของ JavaScript: The Good Parts (ฉบับที่ 1) ใน Goodreads จะแสดงรายการนี้.
คุณสามารถใช้ข้อมูลการตรวจสอบพิเศษทั้งหมดหากคุณต้องการหรือเพียงแค่แสดงคะแนนดาวสำหรับหนังสือโดยใช้ คะแนนเฉลี่ย
ค่าคีย์.
บันทึก: ตาม API documenation, “Goodreads API ให้คุณเข้าถึงเมตาดาต้าที่เป็นเจ้าของ Goodreads ได้อย่างเต็มที่ แต่ก็ไม่ได้ให้สิทธิ์คุณในการเข้าถึงข้อมูลเมตาที่จัดทำโดยบุคคลที่สามเช่น Ingram รูปภาพปกหนังสือคำอธิบายและข้อมูลอื่น ๆ จากแหล่งบุคคลที่สามอาจถูกแยกออกเนื่องจากเราไม่มีใบอนุญาตในการเผยแพร่ข้อมูลเหล่านี้ผ่าน API ของเรา.”
เมื่อคุณอ่านหน้าปกหนังสือและคำอธิบายแล้วคุณสามารถแสดงข้อมูลหนังสือได้ดังนี้.