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 เวอร์ชันที่เฉพาะเจาะจง