ติดตั้งและใช้ผู้ช่วยนักพัฒนาซอฟต์แวร์ Google Ads API

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

Assistant สร้างขึ้นสำหรับเฟรมเวิร์ก Agent ของ Google Antigravity และ Claude Code (v4.0.0) เป็นปลั๊กอินแบบโมดูลาร์ โดยใช้สัญญา AGENTS.md และ CLAUDE.md คำสั่งเครื่องหมายทับในตัว และทักษะเฉพาะโดเมนเพื่อรักษาบริบทที่ต่อเนื่อง ขอบเขตความปลอดภัยที่แข็งแกร่ง และไปป์ไลน์การตรวจสอบอัตโนมัติ

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

1. การเข้าถึง Google Ads API:

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

2. ซอฟต์แวร์:

   • ติดตั้ง Python 3.10 ขึ้นไปและอยู่ใน PATH ของระบบ Python ใช้สำหรับเรียกใช้โค้ดที่สร้างขึ้นและเรียกใช้ Sidecar การตรวจสอบในเครื่อง
   • แพลตฟอร์ม Host Agent:
     • เครื่องมือบรรทัดคำสั่ง (agy) ของ Google Antigravity หรือ
     • เครื่องมือบรรทัดคำสั่งของ Claude Code (claude ที่มี Node.js 18 ขึ้นไป)
   • ติดตั้ง Git ใน PATH ของระบบ

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

ทำตามขั้นตอนต่อไปนี้เพื่อโคลนที่เก็บ เรียกใช้สคริปต์การติดตั้งเฉพาะแพลตฟอร์ม กำหนดค่าข้อมูลเข้าสู่ระบบ และเปิดใช้งานปลั๊กอิน

1. โคลนที่เก็บ

โคลนที่เก็บไปยังเครื่องในเครื่องและไปที่ไดเรกทอรีโปรเจ็กต์

git clone https://github.com/googleads/google-ads-api-developer-assistant
cd google-ads-api-developer-assistant

2. เรียกใช้สคริปต์การติดตั้ง

เรียกใช้สคริปต์การติดตั้งสำหรับแพลตฟอร์มเป้าหมาย โดยค่าเริ่มต้น ระบบจะรวมไลบรารีของไคลเอ็นต์ Python ไว้ด้วย คุณสามารถเลือกที่จะรวมไลบรารีของไคลเอ็นต์เพิ่มเติม (--php, --ruby, --java, --dotnet หรือ --all)

./install.sh agy
# Or include additional client libraries:
./install.sh agy --java --dotnet

.\install.ps1 -Type agy
# Or include additional client libraries:
.\install.ps1 -Type agy -Java -Dotnet

./install.sh claude
# Or include additional client libraries:
./install.sh claude --php --dotnet

.\install.ps1 -Type claude
# Or include additional client libraries:
.\install.ps1 -Type claude -Php -Dotnet

3. กำหนดค่าข้อมูลเข้าสู่ระบบ

ตรวจสอบว่าไฟล์การกำหนดค่า API (เช่น google-ads.yaml, google_ads_php.ini หรือ google_ads_config.rb) อยู่ในไดเรกทอรี $HOME

(ไม่บังคับ) หากต้องการกำหนดค่ารหัสลูกค้าเริ่มต้น ให้ป้อนหมายเลขรหัสลูกค้าลงใน config/customer_id.txt โดยตรง (เช่น 1234567890) นอกจากนี้ คุณยังตรวจสอบหรือปักหมุดเวอร์ชัน API ที่ใช้งานอยู่ใน config/api_version.txt ได้ด้วย

4. เปิดใช้งานปลั๊กอิน

• Antigravity: รีสตาร์ทเซสชันโฮสต์ Antigravity / agy เพื่อโหลดปลั๊กอิน
• Claude Code: ในเซสชัน Claude Code ที่ใช้งานอยู่ ให้เรียกใช้ /reload-plugins หรือรีสตาร์ท claude

5. โต้ตอบกับ Assistant

คุณสามารถโต้ตอบกับ Assistant โดยใช้พรอมต์ที่เป็นภาษาธรรมดาหรือคำสั่งเครื่องหมายทับเฉพาะในเทอร์มินัลได้โดยตรง

ฟีเจอร์หลัก

• ถามและตอบด้วยภาษาธรรมดาและคำแนะนำเชิงแนวคิด: ถามคำถามเกี่ยวกับ ฟีเจอร์ Google Ads API, กฎสถาปัตยกรรม, แนวทางปฏิบัติแนะนำ หรือ แหล่งข้อมูลเฉพาะ Assistant จะอิงคำตอบตามคำจำกัดความ API อย่างเป็นทางการแทนที่จะอาศัยการฝึก LLM ทั่วไปเพียงอย่างเดียว

  • "แคมเปญประเภทใดบ้างที่ใช้ได้"
  • "ฉันจะกรองตามวันที่ใน GAQL ได้อย่างไร"
  • "อธิบายความแตกต่างระหว่าง click_view กับ impression_view"
  • "ชุดที่แชร์คืออะไรและฉันจะใช้ชุดที่แชร์ได้อย่างไร"
  • คำสั่งเครื่องหมายทับของ Claude Code: /explain, /step-by-step, /assistant-tutorial

• การสร้างโค้ดไลบรารีของไคลเอ็นต์แบบอิงตามข้อมูล: สร้างโค้ดที่ผ่านการทดสอบและเป็นไปตามหลักการเขียนโปรแกรมโดยใช้ไลบรารีของไคลเอ็นต์ Google Ads อย่างเป็นทางการ (Python, Java, PHP, .NET และ Ruby)

  • "แสดงแคมเปญที่มี Conversion มากที่สุดในช่วง 30 วันที่ผ่านมา"
  • "รับชื่อกลุ่มโฆษณาที่เปิดใช้ทั้งหมดสำหรับลูกค้า 123-456-7890"
  • "เขียนโค้ดเพื่อสร้างแคมเปญ Performance Max" ระบบจะบันทึกโค้ดที่สร้างขึ้นในไดเรกทอรี saved/code/

• การตรวจสอบคําค้นหา GAQL แบบเป็นโปรแกรม: เรียกใช้และตรวจสอบคําค้นหาที่ซับซ้อนโดยอัตโนมัติตามข้อมูลเมตาของ API, ความเข้ากันได้ของฟิลด์, กฎการแสดงผลเป็น 0 และการแบ่งส่วนวันที่ก่อนการดำเนินการ

  • Claude Code: /validate-gaql
  • ภาษาธรรมดา: validate: SELECT campaign.id FROM campaign

• การตรวจสอบออบเจ็กต์และสคีมา Protobuf: ตรวจสอบโครงสร้างทรัพยากร ฟิลด์ที่ซ้อนกัน ประเภทข้อมูล และค่า Enum แบบไดนามิกสำหรับ API เวอร์ชันที่ใช้งานอยู่โดยไม่มีค่าใช้จ่ายข้อมูลเมตาระยะไกล

  • Claude Code: /inspect-object <resource_or_enum>
  • ภาษาธรรมดา: "ตรวจสอบทรัพยากรแคมเปญ"

• การรายงานเฉพาะกิจแบบสดและการส่งออก CSV: ขอข้อมูลประสิทธิภาพเป็นภาษาอังกฤษธรรมดา Assistant จะสร้าง ตรวจสอบ และเรียกใช้คําค้นหา GAQL กับบัญชีของคุณโดยตรง โดยจะสตรีมตารางที่จัดรูปแบบแบบสดไปยังเทอร์มินัล

  • "แสดงคีย์เวิร์ด 5 อันดับแรกตามค่าใช้จ่ายของเดือนที่แล้วสำหรับลูกค้า 123-456-7890"
  • "บันทึกผลลัพธ์เป็นไฟล์ CSV" (ส่งออกไปยัง saved/csv/)

• การดำเนินการ API โดยตรงและความปลอดภัยในการเปลี่ยนแปลง: เรียกใช้สคริปต์แบบอ่านอย่างเดียวที่สร้างขึ้นภายในสภาพแวดล้อมเสมือนที่มีการจัดการโดยตรง

  • บอก Assistant ว่า "เรียกใช้โค้ด" หรือ "เรียกใช้สคริปต์"
  • ความปลอดภัยในการเปลี่ยนแปลง: เพื่อความปลอดภัย ระบบจะสร้างการดำเนินการเปลี่ยนแปลง (สร้าง อัปเดต ลบ) ไปยัง saved/code/ แต่ Assistant จะไม่ เรียกใช้การดำเนินการเหล่านี้โดยตรง โปรดตรวจสอบและเรียกใช้การดำเนินการเหล่านี้ด้วยตนเองนอก Assistant

• การวินิจฉัยขั้นสูงและการแก้ปัญหา Conversion: ตรวจสอบความล้มเหลวในการอัปโหลด Conversion ออฟไลน์ ตรวจสอบไฟล์ที่จะอัปโหลดล่วงหน้า และสร้างรายงานการวินิจฉัยโดยละเอียด

  • Claude Code: /troubleshoot-conversions
  • ภาษาธรรมดา: "แก้ปัญหา Conversion สำหรับลูกค้า 123-456-7890" (ระบบจะบันทึกรายงานไว้ใน saved/data/)

• การแมปโครงสร้างลำดับชั้นของบัญชีดูแลจัดการ: ดึงข้อมูลรหัสลูกค้าของบัญชีย่อยและแมปโครงสร้างลำดับชั้นของบัญชีภายใต้บัญชีดูแลจัดการ

  • Claude Code: /get-cids <manager_cid>
  • ภาษาธรรมชาติ: "รับรหัสลูกค้าทั้งหมดของผู้ใช้บริการของลูกค้าภายใต้ผู้จัดการ 123-456-7890"

• ตัวกรองและการยกเว้นรายชื่อของ Performance Max: สร้างแผนผังพาร์ติชันผลิตภัณฑ์และการยกเว้น URL ของหน้าเว็บสำหรับกลุ่มชิ้นงาน

  • Claude Code: /pmax-filter
  • ภาษาธรรมชาติ: "สร้างตัวกรอง "ยกเว้น" หน้าเว็บสำหรับแคมเปญ PMax"

• บริบทฐานของโค้ดเพิ่มเติม: ลงทะเบียนตรรกะของแอปพลิเคชันและสถาปัตยกรรมที่กำหนดเองในการให้เหตุผลของ Assistant

  • Linux / macOS:

    ./update.sh agy --context_dir /path/to/your/codebase
    # Or for Claude Code:
    ./update.sh claude --context_dir /path/to/your/codebase
    

  • Windows (PowerShell):

    .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase
    

ข้อมูลอ้างอิงคำสั่งเครื่องหมายทับของ Claude Code

เมื่อใช้ Claude Code คุณจะใช้คำสั่งเครื่องหมายทับในตัวต่อไปนี้ได้ ใน Google Antigravity ให้เรียกใช้ความสามารถเดียวกันนี้โดยใช้พรอมต์ที่เป็นภาษาธรรมดา หรือชื่อเครื่องมือทักษะ เช่น validate_gaql และ inspect_object ตาม ที่อธิบายไว้ใน ฟีเจอร์หลัก:

การบำรุงรักษาและการอัปเดต

วิธีอัปเดตที่เก็บ การติดตั้งปลั๊กอิน และไลบรารีของไคลเอ็นต์

./update.sh agy          # Update Antigravity plugin
./update.sh agy --all    # Include all client libraries

.\update.ps1 -Type agy
.\update.ps1 -Type agy -All

./update.sh claude       # Update Claude Code plugin
./update.sh claude --all # Include all client libraries

.\update.ps1 -Type claude
.\update.ps1 -Type claude -All

การถอนการติดตั้ง

วิธีถอนการติดตั้งปลั๊กอิน Assistant

rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Remove-Item -Recurse -Force `
  "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

/plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

claude plugin uninstall \
  google-ads-api-developer-assistant@google-ads-assistant-local

claude plugin marketplace remove google-ads-assistant-local

ชุมชนและการสนับสนุน

• ปัญหาบน GitHub: รายงานข้อบกพร่อง เสนอแนะฟีเจอร์ หรือขอความช่วยเหลือใน แท็บ Issues ในที่เก็บ
• Discord: เข้าร่วมการสนทนาในแชแนล #ads-api-ai-tools ใน เซิร์ฟเวอร์ Discord ของชุมชนการโฆษณาและการวัดผลของ Google server
• ความคิดเห็น: แชร์ความคิดเห็นผ่าน แบบฟอร์มสำรวจนี้

หลักเกณฑ์การมีส่วนร่วม

ยินดีรับการมีส่วนร่วม โปรดดูไฟล์ CONTRIBUTING.md ใน ที่เก็บ GitHub เพื่อดูหลักเกณฑ์