Google Ads API Explorer เป็นสภาพแวดล้อมการดำเนินการแบบอินเทอร์แอกทีฟที่ช่วยให้คุณสร้างและส่งคำขอ 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
- ป้อนพารามิเตอร์คำขอ ที่จำเป็น เช่น
- เรียกใช้: คลิกเรียกใช้ เพื่อส่งคำขอ เครื่องมือจะแสดงคำขอ HTTP แบบเต็มและการตอบกลับ JSON แบบสดจาก API
ฟีเจอร์หลัก
- การดำเนินการแบบสด: ดำเนินการ
searchและmutateแบบเรียลไทม์กับบัญชีที่ใช้งานจริงหรือบัญชีทดสอบ - การจัดรูปแบบเพย์โหลด JSON: สร้างออบเจ็กต์ JSON ที่ซับซ้อนสำหรับคำขอแบบอินเทอร์แอกทีฟ โดยเครื่องมือจะไฮไลต์ช่องที่จำเป็นและโครงสร้างสคีมาที่ถูกต้อง
- มาสก์ของฟิลด์: ทดสอบตรรกะ
update_maskเพื่อดูว่าการอัปเดตทรัพยากรบางส่วนทำงานอย่างไรในทางปฏิบัติ - การตรวจสอบข้อผิดพลาด: ดูข้อความแสดงข้อผิดพลาดและรหัสข้อผิดพลาดโดยละเอียด (เช่น
QUERY_ERRORหรือAUTHENTICATION_ERROR) ในการตอบกลับแบบดิบๆ เพื่อช่วยในการแก้ไขข้อบกพร่องได้เร็วขึ้น - การส่งออกโค้ด: ส่งออกคำสั่ง
curlคำขอ HTTP แบบดิบๆ หรือโค้ด JavaScript ตัวอย่างจากมุมมองแบบขยายของ API Explorer
ตัวอย่าง Use Case
- ตรวจสอบการตั้งค่าบัญชี: ดึงข้อมูลการกำหนดค่าที่ระดับบัญชี
หรือข้อมูลเมตาอย่างรวดเร็วโดยเรียกใช้คำขอ
GoogleAdsService/Searchกับทรัพยากรcustomer - ทดสอบการเปลี่ยนแปลง: ตรวจสอบความสำเร็จของการสร้างแคมเปญหรือการอัปเดตงบประมาณก่อนที่จะนำโค้ดไปใช้จริง
- แก้ไขข้อบกพร่องของ GAQL: ใช้ Explorer เพื่อเรียกใช้สตริง Google Ads Query Language (GAQL) และตรวจสอบว่าโครงสร้าง JSON ที่แสดงผลตรงกับที่แอปพลิเคชันของคุณคาดหวังไว้
- การตรวจสอบโปรโตคอล: ตรวจสอบส่วนหัว HTTP และการซ้อน JSON ที่แน่นอนซึ่งจำเป็นสำหรับ API เวอร์ชันที่เฉพาะเจาะจง