ขอแนะนำ Google Ads API Developer Assistant v2.0

วันพฤหัสบดีที่ 26 กุมภาพันธ์ 2026

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

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

1. การติดตั้งและการบำรุงรักษาที่ง่ายขึ้น

การตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบหลายภาษาไม่ควรเป็นเรื่องยุ่งยาก

  • การตั้งค่าด้วยคำสั่งเดียว: ใช้แฟล็ก --install-deps ใหม่กับ install.sh หรือ install.ps1 เพื่อจัดการทรัพยากร Dependency ของ pip, composer และ bundler ในครั้งเดียว
  • โครงสร้างไดเรกทอรีแบบรวม: ตอนนี้โค้ดที่สร้างขึ้น, การส่งออก CSV และรายงานการวินิจฉัยทั้งหมดจะจัดระเบียบอยู่ภายใต้ไดเรกทอรี saved/ เดียว โดยมีไดเรกทอรีย่อยสำหรับเอาต์พุตแต่ละประเภท
  • การอัปเดตด้วยคำสั่งเดียว: เมื่อมีการเปิดตัว API และไลบรารีของไคลเอ็นต์เวอร์ชันใหม่ คุณต้องเรียกใช้ update.sh เพื่อทำงานกับเวอร์ชันล่าสุด นอกจากนี้ คุณยังใช้ update.sh เพื่อเพิ่มไลบรารีของไคลเอ็นต์อื่นๆ ลงในบริบทได้ด้วย

2. การแก้ปัญหา Conversion ที่เป็น Agent

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

ในเวอร์ชัน 2.0 เราได้เปิดตัวชุดการแก้ปัญหาและการวินิจฉัย Conversion โดยเฉพาะ

  • สคริปต์ใหม่: api_examples/collect_conversions_troubleshooting_data.py
  • คำสั่งใหม่: /conversions_support_data

สคริปต์จะเรียกใช้รายงานมาตรฐานสําหรับการแก้ปัญหา Conversion และให้บริบทแก่ Assistant เพื่อแก้ปัญหาของคุณ

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

3. สร้างขึ้นสำหรับ API เวอร์ชันล่าสุด (v23)

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

4. การทำงานอัตโนมัติที่ราบรื่นด้วย Session Hook

เราได้เพิ่ม SessionStart และ SessionEnd hooks เพื่อให้เวิร์กโฟลว์ของคุณราบรื่นอย่างแท้จริง

  • การกำหนดค่าอัตโนมัติ: ตอนนี้ Assistant สามารถค้นหาไฟล์การกำหนดค่าในไดเรกทอรี $HOME ได้โดยอัตโนมัติเมื่อเริ่มเซสชัน โดยจะคัดลอกไปยังการกำหนดค่าไดเรกทอรีย่อยในไดเรกทอรีโปรเจ็กต์ Python เป็นภาษาที่ Gemini ต้องการใช้ในการค้นหา API ดังนั้น หากคุณใช้ภาษาอื่น ระบบจะอ่านไฟล์การกำหนดค่าและสร้าง google-ads.yaml ชั่วคราวใน config สำหรับการค้นหา แต่จะยังคงตอบกลับเป็นโค้ดของภาษาที่คุณต้องการ
  • การล้างข้อมูลอัตโนมัติ: ระบบจะล้างการกำหนดค่าชั่วคราวอย่างปลอดภัยเมื่อคุณออก เพื่อให้พื้นที่ทำงานสะอาดและข้อมูลเข้าสู่ระบบปลอดภัย

5. การตรวจสอบ GAQL ที่ชาญฉลาดยิ่งขึ้น

การสร้างคำค้นหา GAQL ที่ซับซ้อนทำได้ง่ายกว่าที่เคย เราได้อัปเดต GEMINI.md และ conversions/GEMINI.md ด้วยกฎการตรวจสอบที่เข้มงวดสำหรับกรณี Edge Case ของ API ล่าสุด ซึ่งรวมถึงการจัดการกลุ่มวันที่และข้อกำหนดช่วงที่จำกัดที่ได้รับการปรับปรุง ตอนนี้ Assistant จะตรวจจับข้อผิดพลาดทางตรรกะก่อนที่คุณจะเรียกใช้การค้นหา

6. ทักษะ

ลองนึกถึงทักษะว่าเป็นปลั๊กอินขนาดเล็กหรือ "พิมพ์เขียวของลักษณะการทำงาน" แม้ว่าบริบททั่วไป (เช่น ไฟล์ GEMINI.md) จะให้ข้อมูลเบื้องหลัง แต่ทักษะจะ "โหลด" เข้าสู่สมองของ AI ก็ต่อเมื่อจำเป็นต้องทำงานที่ซับซ้อนและเป็นขั้นตอน เช่น การรับเวอร์ชันปัจจุบันของส่วนขยายนี้ คุณไม่ได้เรียกใช้ Skill โดยตรง Gemini จะตัดสินใจเองเมื่อต้องการข้อมูล

แม้ว่าจะยังเป็นฟีเจอร์ทดลอง แต่เราได้รวมฟีเจอร์นี้ไว้ในรุ่นนี้เพื่อเสริมการใช้ฮุกสำหรับการเริ่มต้นเซสชันและการล้างข้อมูล

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

การก้าวกระโดดจาก v1.6.0 เป็น v2.0.0 ไม่ใช่แค่เรื่องฟีเจอร์ใหม่ๆ เท่านั้น แต่ยังรวมถึงความน่าเชื่อถือด้วย v2.0 ผสานรวมความรู้ด้าน API อย่างลึกซึ้งเข้ากับเครื่องมือวินิจฉัยอัตโนมัติ จึงช่วยลดวงจร "ลองผิดลองถูก" ที่มักทำให้การผสานรวม API ช้าลง

ไม่ว่าคุณจะแก้ไขข้อบกพร่องในการอัปโหลด Conversion หรือสร้างไปป์ไลน์การรายงานที่ซับซ้อน v2.0 ก็มีเครื่องมือที่จะช่วยให้คุณทำงานได้เร็วขึ้นและมั่นใจมากขึ้น

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

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

  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • ในไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้ install.sh หรือ install.ps1 เพื่อติดตั้งส่วนขยายและไลบรารีของไคลเอ็นต์

การอัปเกรดจากเวอร์ชันก่อนหน้า

  • คัดลอกโค้ดที่กำหนดเองจาก saved_code/ และ saved_csv/ ไปยังตำแหน่งที่ปลอดภัย
  • ลบโคลนในเครื่องของ Google Ads API Developer Assistant โดยลบไดเรกทอรีโปรเจ็กต์ รวมถึงไดเรกทอรีย่อยและไฟล์ทั้งหมด
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • ในไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้ install.sh หรือ install.ps1 เพื่อติดตั้งส่วนขยายและไลบรารีของไคลเอ็นต์

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