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

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

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

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

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

  1. สิทธิ์เข้าถึง Google Ads API:

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

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

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

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) ได้

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

Claude Code

Linux / macOS:

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

Windows (PowerShell):

.\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 วันที่ผ่านมา"
    • "Get all enabled ad group names for customer 123-456-7890."
    • "เขียนโค้ดเพื่อสร้างแคมเปญ Performance Max" ระบบจะบันทึกโค้ดที่สร้างขึ้นไว้ในไดเรกทอรี saved/code/

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

    • 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/ แต่ผู้ช่วยจะไม่ดำเนินการโดยตรง ตรวจสอบและดำเนินการด้วยตนเองนอกผู้ช่วย

  • การวินิจฉัยขั้นสูงและการแก้ปัญหา 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"

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

    • 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 ตามที่อธิบายไว้ในฟีเจอร์หลัก

คำสั่งเครื่องหมายทับ วัตถุประสงค์ ตัวอย่าง
/validate-gaql ตรวจสอบไวยากรณ์ ความเข้ากันได้ และกฎของ GAQL /validate-gaql
/inspect-object ตรวจสอบฟิลด์ ประเภท และ Enum ของ Protobuf /inspect-object Campaign
/get-cids แก้ไขลำดับชั้นของบัญชีดูแลจัดการและรหัสลูกค้า /get-cids 1234567890
/troubleshoot-conversions เรียกใช้การวินิจฉัยการอัปโหลด Conversion ออฟไลน์ /troubleshoot-conversions
/pmax-filter สร้างตัวกรองและการยกเว้นข้อมูล PMax /pmax-filter
/explain แสดงคำอธิบายที่มีโครงสร้าง 4 ส่วน /explain shared set
/step-by-step กำหนดแผนการดำเนินงานแบบหลายระยะ /step-by-step upload conversions
/assistant-tutorial เรียกใช้คำแนะนำแบบอินเทอร์แอกทีฟ 11 ขั้นตอน /assistant-tutorial

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

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

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

Claude Code

Linux / macOS:

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

Windows (PowerShell):

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

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

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

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

จากนั้นรีสตาร์ทเซสชันโฮสต์ Antigravity

Claude Code

ในเซสชัน Claude Code ที่ใช้งานอยู่ ให้ทำดังนี้

/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

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

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

เรายินดีรับฟังความคิดเห็นจากคุณ ดูหลักเกณฑ์ได้ที่ไฟล์ CONTRIBUTING.md ในที่เก็บ GitHub

ขั้นตอนถัดไป

ก่อนหน้า
Google Ads API Developer Assistant คืออะไร