ก่อนที่จะเริ่มเขียนโค้ดแอปพลิเคชันไคลเอ็นต์แรก คุณต้องดำเนินการบางอย่างดังต่อไปนี้หากยังไม่ได้ทำ
รับบัญชี Google
คุณต้องมีบัญชี Google เพื่อสร้างโปรเจ็กต์ในคอนโซล Google API หากมีบัญชีอยู่แล้ว คุณก็พร้อมใช้งานได้
นอกจากนี้ คุณอาจต้องการบัญชี Google แยกต่างหากเพื่อวัตถุประสงค์ในการทดสอบ
ลองใช้รายงานประสบการณ์การใช้งานโฆษณาของ Google
เอกสาร API นี้ถือว่าคุณเคยใช้รายงานประสบการณ์โฆษณาของ Google และคุ้นเคยกับแนวคิดการเขียนโปรแกรมบนเว็บและรูปแบบข้อมูลบนเว็บ
หากคุณยังไม่เคยใช้รายงานประสบการณ์การใช้งานโฆษณาของ Google ให้ลองใช้อินเทอร์เฟซผู้ใช้ก่อนเริ่มเขียนโค้ด
สร้างโปรเจ็กต์สำหรับไคลเอ็นต์
ก่อนที่จะส่งคำขอไปยังรายงานประสบการณ์โฆษณาของ Google ได้ คุณต้องแจ้งให้ Google ทราบเกี่ยวกับไคลเอ็นต์และเปิดใช้งานการเข้าถึง API ดังกล่าว ซึ่งทำได้โดยใช้คอนโซล Google API เพื่อสร้างโปรเจ็กต์ หรือคอลเล็กชันการตั้งค่าที่มีชื่อและข้อมูลการเข้าถึง API ตลอดจนลงทะเบียนแอปพลิเคชันของคุณ
ดูข้อมูลพื้นฐานเกี่ยวกับ REST
คุณเรียกใช้ API ได้ 2 วิธี ดังนี้
- การส่งคำขอ HTTP และการแยกวิเคราะห์การตอบกลับ
- การใช้ไลบรารีของไคลเอ็นต์
หากตัดสินใจที่จะไม่ใช้ไลบรารีของไคลเอ็นต์ คุณจะต้องเข้าใจพื้นฐานของ 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 Ad Experience Report API
การดำเนินการของ Google Ad Experience Report API จะแมปกับคำกริยา HTTP ของ REST โดยตรง
รูปแบบที่เฉพาะเจาะจงสำหรับ URI ของ Google Ad Experience Report API มีดังนี้
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
ชุด URI ทั้งหมดที่ใช้สำหรับการดำเนินการที่รองรับแต่ละรายการใน API จะสรุปไว้ในเอกสารข้อมูลอ้างอิงของ Google Ad Experience Report API
ดูข้อมูลเบื้องต้นเกี่ยวกับ JSON
API รายงานประสบการณ์การใช้งานโฆษณาของ Google จะแสดงข้อมูลในรูปแบบ JSON
JSON (JavaScript Object Notation) เป็นรูปแบบข้อมูลทั่วไปที่ไม่ขึ้นอยู่กับภาษา ซึ่งแสดงโครงสร้างข้อมูลที่กำหนดเองในรูปแบบข้อความอย่างง่าย ดูข้อมูลเพิ่มเติมได้ที่ json.org