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