สิ่งที่ต้องดำเนินการก่อน

ก่อนที่คุณจะเริ่มเขียนโค้ดแอปพลิเคชันไคลเอ็นต์แรกได้ คุณต้องดำเนินการบางอย่างหากยังไม่ได้ทำ

รับบัญชี Google

คุณต้องมีบัญชี Google เพื่อสร้างโปรเจ็กต์ในคอนโซล Google API หากมีบัญชีอยู่แล้ว คุณก็พร้อมใช้งานได้

คุณอาจต้องการบัญชี Google แยกต่างหากเพื่อวัตถุประสงค์ในการทดสอบ

สร้างโปรเจ็กต์สำหรับไคลเอ็นต์

ก่อนที่จะส่งคำขอไปยัง Google Knowledge Graph Search API คุณต้องแจ้งให้ Google ทราบเกี่ยวกับไคลเอ็นต์ของคุณและเปิดใช้งานการเข้าถึง API คุณสามารถดำเนินการได้โดยใช้คอนโซล Google API เพื่อสร้างโปรเจ็กต์ ซึ่งเป็นชุดการตั้งค่าที่มีชื่อและข้อมูลการเข้าถึง API แล้วลงทะเบียนแอปพลิเคชันของคุณ

หากต้องการเริ่มต้นใช้งาน Google Knowledge Graph Search API คุณจะต้องใช้เครื่องมือตั้งค่า ซึ่งจะแนะนำคุณตลอดขั้นตอนการสร้างโปรเจ็กต์ในคอนโซล Google API, การเปิดใช้ API และสร้างข้อมูลเข้าสู่ระบบ

หากยังไม่ได้ดำเนินการ ให้สร้างคีย์ API ของแอปพลิเคชันโดยคลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API จากนั้นมองหาคีย์ API ในส่วนคีย์ API

ดูข้อมูลพื้นฐานเกี่ยวกับ REST

การเรียก API ทำได้ 2 วิธีดังนี้

หากคุณตัดสินใจไม่ใช้ไลบรารีของไคลเอ็นต์ คุณจะต้องทำความเข้าใจพื้นฐานของ REST

REST คือรูปแบบสถาปัตยกรรมซอฟต์แวร์ที่ให้วิธีการขอและแก้ไขข้อมูลที่สะดวกและสอดคล้องกัน

คำว่า REST เป็นคำสั้นๆ ของ "Assignational State Transfer" ในบริบทของ Google APIs หมายถึงการใช้คำกริยา HTTP เพื่อดึงและแก้ไขการนำเสนอข้อมูลที่ Google จัดเก็บไว้

ในระบบ RESTful ทรัพยากรจะจัดเก็บอยู่ในพื้นที่เก็บข้อมูล ไคลเอ็นต์จะขอให้เซิร์ฟเวอร์ดำเนินการบางอย่าง (เช่น สร้าง เรียก อัปเดต หรือลบทรัพยากร) และเซิร์ฟเวอร์จะดำเนินการดังกล่าวและส่งการตอบกลับ โดยมักจะอยู่ในรูปแบบเป็นตัวแทนของทรัพยากรที่ระบุ

ใน RESTful API ของ Google ไคลเอ็นต์จะระบุการทำงานโดยใช้คำกริยา HTTP เช่น POST, GET, PUT หรือ DELETE โดยจะระบุทรัพยากรตาม URI ที่ไม่ซ้ำกันทั่วโลกในรูปแบบต่อไปนี้

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

เนื่องจากทรัพยากร API ทั้งหมดมี URI ที่เข้าถึงได้แบบ HTTP ที่ไม่ซ้ำกัน REST จึงทำให้เกิดการแคชข้อมูลและมีการปรับให้เหมาะสมเพื่อทำงานกับโครงสร้างพื้นฐานแบบกระจายตัวของเว็บ

คุณดูคำจำกัดความของเมธอดได้ในเอกสารประกอบของมาตรฐาน HTTP 1.1 ซึ่งมีประโยชน์เช่นกัน ซึ่งมีข้อกำหนดของ GET, POST, PUT และ DELETE

REST ใน Google กราฟความรู้ Search API

การดำเนินการของ Google Knowledge Graph Search API จะจับคู่กับคำกริยา HTTP ของ REST โดยตรง

รูปแบบที่เฉพาะเจาะจงสำหรับ URI ของ Google Knowledge Graph Search API ได้แก่

https://kgsearch.googleapis.com/v1/entities:search?query=your_query&parameters

ชุด URI แบบเต็มที่ใช้สำหรับการดำเนินการที่รองรับแต่ละรายการใน API จะสรุปไว้ในเอกสารข้อมูลอ้างอิง API การค้นหาในกราฟความรู้ของ Google

ดูข้อมูลเบื้องต้นเกี่ยวกับ JSON

Google Knowledge Graph Search API แสดงข้อมูลในรูปแบบ JSON

JSON (JavaScript Object Notation) เป็นรูปแบบข้อมูลทั่วไปที่ไม่ขึ้นอยู่กับภาษา ซึ่งมีการนำเสนอแบบข้อความอย่างง่ายของโครงสร้างข้อมูลที่กำหนดเอง สำหรับข้อมูลเพิ่มเติม โปรดดู json.org