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

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

รับบัญชี Google

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

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

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

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

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

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

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

การเรียกใช้ API มี 2 วิธีดังนี้

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

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

REST ย่อมาจาก "Representational State Transfer" ในบริบทของ Google API หมายถึงการใช้คํากริยา 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 Knowledge Graph 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 จะสรุปไว้ในเอกสารข้อมูลอ้างอิง Google Knowledge Graph Search API

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

Google Knowledge Graph Search API จะแสดงผลเป็นรูปแบบ JSON

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