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