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 (GAQL) และยืนยันว่าโครงสร้าง JSON ที่แสดงผลตรงกับความคาดหวังของแอปพลิเคชัน
- การยืนยันโปรโตคอล: ตรวจสอบส่วนหัว HTTP และการซ้อน JSON ที่แน่นอน ซึ่งจำเป็นสำหรับ API เวอร์ชันที่เฉพาะเจาะจง