โปรแกรมสำรวจ Google Ads API

Google Ads API Explorer เป็นสภาพแวดล้อมการดำเนินการแบบอินเทอร์แอกทีฟที่ช่วยให้คุณสร้างและส่งคำขอ API แบบสดได้โดยตรงจากเบราว์เซอร์ โดยจะฝังตัวอยู่ในเอกสารอ้างอิง ซึ่งจะจัดการความซับซ้อนของการตรวจสอบสิทธิ์ OAuth 2.0 และการจัดรูปแบบเพย์โหลด JSON เพื่อให้คุณทดสอบบริการและเมธอดที่เฉพาะเจาะจงได้โดยไม่ต้องเขียนโค้ดแม้แต่บรรทัดเดียว

ข้อดี

  • การทดสอบแบบไม่ต้องเขียนโค้ด: เรียกใช้ API จริง (ทั้งแบบอ่านและเขียน) ได้โดยตรง จากเอกสารประกอบโดยไม่ต้องตั้งค่าสภาพแวดล้อมการพัฒนาในเครื่อง
  • การค้นพบโปรโตคอล: ดูโครงสร้างที่แน่นอนของคำขอ HTTP และ การตอบกลับเพื่อทำความเข้าใจลักษณะการทำงานของ API
  • การสร้างต้นแบบที่ราบรื่น: ยืนยันลักษณะการทำงานของปลายทางและตรวจสอบการตอบกลับ API ดิบ ได้ทันทีก่อนที่จะใช้ตรรกะในแอปพลิเคชัน
  • การตรวจสอบสิทธิ์ที่ง่ายขึ้น: เครื่องมือจะจัดการโฟลว์ OAuth 2.0 โดยอัตโนมัติ เพื่อให้คุณมุ่งเน้นไปที่คำขอ API แทนการจัดการ ข้อมูลเข้าสู่ระบบ

เริ่มต้นใช้งาน

  1. ไปที่เอกสารประกอบ: ไปที่เอกสารประกอบอ้างอิง แล้วเลือกบริการและวิธีการที่ต้องการ ทดสอบ เช่น GoogleAdsService/Search
  2. เปิด Explorer: มองหาแผง "ลองเลย!" ทางด้านขวาของหน้า
  3. กำหนดค่าคำขอ:
    • ป้อนพารามิเตอร์คำขอที่จำเป็น เช่น developer-token และ login-customer-id
    • กำหนดเนื้อหาคำขอโดยใช้โปรแกรมแก้ไข JSON แบบอินเทอร์แอกทีฟ หากเมธอดต้องใช้เพย์โหลด เช่น สำหรับการดำเนินการ `mutate`
  4. ดำเนินการ: คลิกดำเนินการเพื่อส่งคำขอ เครื่องมือจะ แสดงคำขอ 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 เวอร์ชันที่เฉพาะเจาะจง