ขอแนะนำ Google Ads API Developer Assistant v3.0.0

วันพุธที่ 10 มิถุนายน 2569

เรายินดีที่จะประกาศเปิดตัว v3.0.0 ของผู้ช่วยนักพัฒนาแอป Google Ads API การเปิดตัวครั้งสำคัญนี้ถือเป็นก้าวสำคัญในการพัฒนา Assistant โดยมุ่งเน้นที่การปรับปรุงสถาปัตยกรรมให้ทันสมัย ความน่าเชื่อถือที่เพิ่มขึ้น และการออกแบบที่แยกเป็นโมดูลมากขึ้น

ในเวอร์ชันนี้ เราจะย้าย Assistant ไปยังเฟรมเวิร์ก Agent Antigravity ของ Google และเปลี่ยนไปใช้สถาปัตยกรรมที่อิงตามทักษะ การเปลี่ยนแปลงเหล่านี้ทำให้ Assistant มีประสิทธิภาพมากขึ้น ดูแลรักษาง่ายขึ้น และลดการใช้โทเค็น

มีอะไรใหม่ในเวอร์ชัน 3.0.0

1. ขับเคลื่อนโดยเฟรมเวิร์ก Antigravity

ผู้ช่วยนักพัฒนาซอฟต์แวร์ Google Ads API ได้ย้ายข้อมูลจาก gemini-cli ไปยังเฟรมเวิร์ก Agent ของ Antigravity (v3.0.0) แล้ว การอัปเกรดเฟรมเวิร์กพื้นฐานนี้จะช่วยให้สภาพแวดล้อมการดำเนินการมีโครงสร้างและเชื่อถือได้มากขึ้น นอกจากนี้ โครงสร้างไดเรกทอรีและไฟล์ของโปรเจ็กต์ยังได้รับการอัปเดตให้พร้อมใช้งาน Antigravity อย่างเต็มรูปแบบด้วย

การรองรับ gemini-cli จะสิ้นสุดลงในวันที่ 18 มิถุนายน 2026 ตามรายละเอียดในประกาศในบล็อกของ Google นี้

2. สถาปัตยกรรมแบบโมดูลที่อิงตามทักษะ

เราได้เปลี่ยนความสามารถหลักของ Assistant เป็นทักษะแล้ว ตอนนี้ Assistant จะโหลดไดเรกทอรีเครื่องมือเฉพาะทางที่ผ่านการทดสอบ (ทักษะ) แบบไดนามิกเมื่อจำเป็น แทนที่จะอาศัยคำสั่งแบบกว้างๆ ที่ไม่มีโครงสร้างในไฟล์บริบท ซึ่งจะช่วยลด "อาการหลอน" ได้อย่างมาก และช่วยให้มั่นใจได้ว่าระบบจะดำเนินงานโดยใช้ขั้นตอนที่แม่นยำและได้รับการยืนยันแล้ว

การอัปเดตที่สำคัญในการเปลี่ยนผ่านแบบโมดูลาร์นี้มีดังนี้

  • การตรวจสอบ GAQL (validate_gaql): ย้ายไปยังทักษะเฉพาะ ตอนนี้เครื่องมือนี้มีการตรวจสอบการค้นหาแบบคงที่ที่ปรับปรุงแล้วสำหรับกลุ่มวันที่ ตัวกรองวันเดียว click_view และขอบเขต change_status
  • แก้ปัญหา Conversion (troubleshoot_conversions): แทนที่ conversions_support_package เดิม โดยจะรวมสคริปต์การแก้ปัญหา Conversion และสคริปต์สรุปการอัปโหลด รวมถึงการทดสอบทั้งหมดไว้ในไดเรกทอรีทักษะที่สอดคล้องกันเพียงแห่งเดียว
  • คำสั่งที่มีโครงสร้าง (explain และ step_by_step): แปลงเป็นทักษะเพื่อบังคับใช้เลย์เอาต์ที่มีโครงสร้างและสอดคล้องกันสำหรับคำอธิบาย
  • การแมปบัญชีใหม่ (get_cids_under_mcc): ทักษะใหม่ในการดึงข้อมูลบัญชีของเด็กทั้งหมดภายใต้บัญชีดูแลจัดการ (MCC)
  • การตรวจสอบออบเจ็กต์ใหม่ (inspect_object): ทักษะใหม่สำหรับการค้นหาข้อความ Protobuf และ Enum แบบไดนามิกได้ทันที เพื่อช่วยให้มั่นใจว่า Assistant จะใช้โครงสร้างที่ถูกต้องเสมอ
  • ตัวกรองข้อมูลใหม่ของ PMax (pmax_listing_filter): ทักษะใหม่ในการกำหนดมาตรฐานการแก้ไขแผนผังการยกเว้นหน้าเว็บของกลุ่มรายชื่อสำหรับแคมเปญ Performance Max

3. ความสม่ำเสมอและความเข้มงวดที่เพิ่มขึ้น

เราได้เปิดตัวกฎและข้อกำหนดที่เข้มงวดยิ่งขึ้นเพื่อช่วยให้มั่นใจว่าการสร้างโค้ดและการตรวจสอบความถูกต้องของคำค้นหาจะมีคุณภาพสูง ดังนี้

  • การกำหนดเวอร์ชัน API ที่ชัดเจน: ทักษะที่สำคัญ เช่น get_cids_under_mcc, validate_gaql และ troubleshoot_conversions ต้องใช้อาร์กิวเมนต์ api_version ที่ชัดเจนเพื่อขจัดความกำกวม
  • กฎ GAQL ที่เข้มงวด:
    • เพิ่มกฎลงใน AGENTS.md เพื่อป้องกันการใช้ฟังก์ชันรวมข้อมูล SQL (เช่น SUM, COUNT และ AVG) ในการค้นหา GAQL เนื่องจากระบบไม่รองรับ
    • เพิ่มกฎให้ตรวจสอบบันทึกประจำรุ่นของเว็บไซต์นักพัฒนาซอฟต์แวร์ Google Ads API ก่อนสำหรับ API เวอร์ชันปัจจุบันเพื่อให้ Assistant ใช้เอกสารประกอบที่เป็นปัจจุบัน
    • การกำหนดค่าที่มีประสิทธิภาพมากขึ้น: AGENTS.md ได้รับการปรับปรุงให้มีประสิทธิภาพมากขึ้น ซึ่งทำให้หน้าต่างบริบทเริ่มต้นมีขนาดเล็กลง เราได้นำเอกสารประกอบเกี่ยวกับ Conversion ที่ซ้ำกันออกเพื่อสนับสนุนทักษะด้านการเขียนโปรแกรม

4. การปรับปรุงประสบการณ์ของนักพัฒนาซอฟต์แวร์ (DX)

เราได้ทำการปรับปรุงคุณภาพชีวิตหลายอย่างเพื่อให้วงจรการพัฒนาของคุณรวดเร็วและราบรื่นยิ่งขึ้น

  • สภาพแวดล้อมเสมือนแบบถาวร (.venv): ระบบจะไม่ลบสภาพแวดล้อมเสมือนเมื่อสิ้นสุดเซสชันอีกต่อไป เมื่อเริ่มต้นระบบ ผู้ช่วยจะตรวจสอบเวอร์ชัน Python ของระบบ และจะสร้าง .venv ขึ้นมาใหม่ก็ต่อเมื่อมี Python เวอร์ชันใหม่พร้อมใช้งาน
  • การแคชเวอร์ชัน API อัจฉริยะ: ตอนนี้ Assistant จะแคช Google Ads API เวอร์ชันปัจจุบันที่มี TTL 19 ชั่วโมง ซึ่งช่วยลดเวลาเริ่มต้นระบบโดยหลีกเลี่ยงการตรวจสอบเครือข่ายที่ซ้ำซ้อน
  • การแก้ไขข้อบกพร่องที่ดีขึ้นด้วยบันทึกแบบถาวร: ตอนนี้ข้อความในบันทึกจะมีการประทับวันที่และเวลา ระบบจะเขียนไฟล์บันทึกไปยังไดเรกทอรี .agents/ และจะไม่รีเซ็ตอีกต่อไปในการเรียกใช้แต่ละครั้ง เพื่อเก็บประวัติไว้สำหรับการแก้ปัญหา

ทำไมคุณจึงควรอัปเกรด

การอัปเกรดเป็น v3.0.0 จะเน้นที่ความน่าเชื่อถือและโครงสร้างเป็นหลัก การเปลี่ยนไปใช้เฟรมเวิร์ก Antigravity และแยกฟีเจอร์ออกเป็นโมดูลทักษะต่างๆ ช่วยให้ Assistant คาดการณ์ได้มากขึ้นและใช้ทรัพยากรได้อย่างมีประสิทธิภาพ

หากต้องการให้เริ่มต้นทำงานได้เร็วขึ้น มีการตรวจสอบ GAQL ที่เชื่อถือได้มากขึ้น และประสบการณ์การแก้ปัญหาที่มีประสิทธิภาพยิ่งขึ้น เราขอแนะนำให้อัปเกรดเป็น v3.0.0

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

การติดตั้งครั้งแรก

  1. ติดตั้ง Antigravity CLI: ทำตามวิธีการที่ https://antigravity.google/
  2. โคลน Assistant: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. เรียกใช้สคริปต์การติดตั้ง:
    • Linux/macOS: เรียกใช้ ./install.sh (ค่าเริ่มต้นคือการรองรับ Python ให้ใช้แฟล็ก เช่น --php หรือ --ruby สำหรับภาษาอื่นๆ)
    • Windows: เปิด PowerShell และเรียกใช้ .\install.ps1

อัปเกรดจาก v2.x

  1. คัดลอกโค้ดหรือข้อมูลที่กำหนดเองจาก saved/ ไปยังตำแหน่งที่ปลอดภัยนอกไดเรกทอรีโปรเจ็กต์
  2. ลบโคลน Assistant ในเครื่อง
  3. โคลนที่เก็บ:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. เรียกใช้สคริปต์การติดตั้ง (install.sh หรือ install.ps1) เพื่อเริ่มต้นสภาพแวดล้อม Antigravity ใหม่

Bob Hancock, ทีม Google Ads API

ป้ายกำกับ: google-ads-api, release