โปรแกรมสำรวจ Google Ads API เป็นสภาพแวดล้อมการดำเนินการแบบอินเทอร์แอกทีฟที่ช่วยให้คุณสร้างและส่งคำขอ API แบบเรียลไทม์ได้โดยตรงจากเบราว์เซอร์ เครื่องมือนี้ฝังอยู่ในเอกสารอ้างอิง โดยจะจัดการความซับซ้อนของการตรวจสอบสิทธิ์ OAuth 2.0 และการจัดรูปแบบเพย์โหลด JSON ซึ่งช่วยให้คุณทดสอบบริการและเมธอดที่เฉพาะเจาะจงได้โดยไม่ต้องเขียนโค้ดแม้แต่บรรทัดเดียว
ข้อดี
- การทดสอบแบบไม่ใช้โค้ด: เรียกใช้ API แบบเรียลไทม์ (ทั้งอ่านและเขียน) โดยตรงจากเอกสารประกอบโดยไม่ต้องตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง
- การค้นพบโปรโตคอล: ดูโครงสร้างที่แน่นอนของคำขอ HTTP และการตอบกลับเพื่อทำความเข้าใจลักษณะการทำงานของ API
- การสร้างต้นแบบที่ง่ายดาย: ยืนยันลักษณะการทำงานของปลายทางและตรวจสอบการตอบกลับจาก API ดิบได้ทันทีก่อนที่จะใช้ตรรกะในแอปพลิเคชัน
- การตรวจสอบสิทธิ์ที่ง่ายขึ้น: เครื่องมือจะจัดการขั้นตอน OAuth 2.0 โดยอัตโนมัติ ซึ่งช่วยให้คุณมุ่งเน้นที่คำขอ API แทนการจัดการข้อมูลเข้าสู่ระบบได้
เริ่มต้นใช้งาน
- ไปที่เอกสารประกอบ: ไปที่เอกสารอ้างอิง แล้วเลือกบริการและเมธอดที่ต้องการทดสอบ เช่น
GoogleAdsService/Search - เปิด Explorer: มองหาแผงลองใช้วิธีนี้ทางด้านขวาของหน้า
- กำหนดค่าคำขอ
- ป้อนพารามิเตอร์คำขอที่จำเป็น เช่น
customerIdและขยายส่วนหัวเพื่อระบุส่วนหัว HTTP ที่ไม่บังคับ เช่นlogin-customer-id(จำเป็นเฉพาะเมื่อเข้าถึงบัญชีผ่านบัญชีดูแลจัดการ) โปรดทราบว่าโทเค็นของนักพัฒนาแอป (developer-token) ได้เลิกใช้งานไปแล้วเมื่อวันที่ 9 กันยายน 2026 และเซิร์ฟเวอร์ API จะไม่สนใจโทเค็นดังกล่าว แม้ว่าคุณจะยังคงป้อนค่าได้หากแบบฟอร์มแจ้งให้ป้อน - กำหนดเนื้อหาคำขอโดยใช้เครื่องมือแก้ไข JSON แบบอินเทอร์แอกทีฟหากเมธอดต้องใช้เพย์โหลด เช่น สำหรับการดำเนินการ
searchหรือmutate
- ป้อนพารามิเตอร์คำขอที่จำเป็น เช่น
- Execute: คลิก Execute เพื่อส่งคำขอ เครื่องมือจะแสดงคำขอ HTTP แบบเต็มและการตอบกลับ JSON แบบเรียลไทม์จาก API
ฟีเจอร์หลัก
- การดำเนินการแบบเรียลไทม์: ดำเนินการ
searchและmutateแบบเรียลไทม์กับบัญชีที่ใช้งานจริงหรือบัญชีทดสอบ - การจัดรูปแบบเพย์โหลด JSON: สร้างออบเจ็กต์ JSON ที่ซับซ้อนสำหรับคำขอแบบอินเทอร์แอกทีฟ โดยเครื่องมือจะไฮไลต์ฟิลด์ที่จำเป็นและโครงสร้างสคีมาที่ถูกต้อง
- มาสก์ฟิลด์: ทดสอบตรรกะ
update_maskเพื่อดูว่าการอัปเดตทรัพยากรบางส่วนทำงานอย่างไรในทางปฏิบัติ - การตรวจสอบข้อผิดพลาด: ดูข้อความแสดงข้อผิดพลาดและรหัสข้อผิดพลาดโดยละเอียด (เช่น
QUERY_ERRORหรือAUTHENTICATION_ERROR) ในการตอบกลับแบบข้อมูลดิบเพื่อช่วยให้แก้ไขข้อบกพร่องได้เร็วขึ้น - การส่งออกโค้ด: ส่งออกคำสั่ง
curl, คำขอ HTTP ดิบ หรือโค้ด JavaScript ตัวอย่างจากมุมมองแบบขยายของโปรแกรมสำรวจ API
ตัวอย่าง Use Case
- ตรวจสอบการตั้งค่าบัญชี: ดึงข้อมูลการกำหนดค่าหรือข้อมูลเมตาระดับบัญชีได้อย่างรวดเร็วโดยส่งคำขอ
GoogleAdsService/Searchไปยังทรัพยากรcustomer - ทดสอบการเปลี่ยนแปลง: ยืนยันความสําเร็จของการสร้างแคมเปญหรือการอัปเดตงบประมาณก่อนที่จะนําโค้ดไปใช้งานจริง
- แก้ไขข้อบกพร่อง GAQL: ใช้ Explorer เพื่อเรียกใช้สตริง Google Ads Query Language (GAQL) และยืนยันว่าโครงสร้าง JSON ที่แสดงผลตรงกับความคาดหวังของแอปพลิเคชัน
- การตรวจสอบโปรโตคอล: ตรวจสอบส่วนหัว HTTP และการฝัง JSON ที่แน่นอนซึ่งจำเป็นสำหรับ API เวอร์ชันที่เฉพาะเจาะจง