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

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

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

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

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

  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: ```bash ./install.sh agy

หรือจะรวมไลบรารีของไคลเอ็นต์เพิ่มเติมก็ได้

./install.sh agy --java --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type agy

หรือจะรวมไลบรารีของไคลเอ็นต์เพิ่มเติมก็ได้

.\install.ps1 -Type agy -Java -Dotnet ```

Claude Code

Linux / macOS: ```bash ./install.sh claude

หรือจะรวมไลบรารีของไคลเอ็นต์เพิ่มเติมก็ได้

./install.sh claude --php --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type claude

หรือจะรวมไลบรารีของไคลเอ็นต์เพิ่มเติมก็ได้

.\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, แนวทางปฏิบัติแนะนำ หรือแหล่งข้อมูลที่เฉพาะเจาะจง

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

    • "ข้อใดคือประเภทแคมเปญที่พร้อมใช้งาน"
    • "ฉันจะกรองตามวันที่ใน GAQL ได้อย่างไร"
    • "อธิบายความแตกต่างระหว่าง click_view กับ impression_view"
    • "ชุดที่แชร์คืออะไรและฉันจะใช้ชุดที่แชร์ได้อย่างไร"
    • คำสั่งเครื่องหมายทับของโค้ด Claude: /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/ แต่ไม่ดำเนินการโดยตรง โดยผู้ช่วย ตรวจสอบและดำเนินการด้วยตนเองภายนอก ผู้ช่วย

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

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

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

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

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

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

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

    • Linux / macOS: bash ./update.sh agy --context_dir /path/to/your/codebase # Or for Claude Code: ./update.sh claude --context_dir /path/to/your/codebase
    • Windows (PowerShell): powershell .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

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

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

คำสั่งเครื่องหมายทับ วัตถุประสงค์ ตัวอย่าง
/validate-gaql ตรวจสอบไวยากรณ์ ความเข้ากันได้ และกฎของ GAQL /validate-gaql
/inspect-object ตรวจสอบฟิลด์ ประเภท และ Enum ของ Protobuf /inspect-object Campaign
/get-cids แก้ไขลําดับชั้น MCC และ CID ของลูกค้า /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: bash ./update.sh agy # Update Antigravity plugin ./update.sh agy --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type agy .\update.ps1 -Type agy -All

Claude Code

Linux / macOS: bash ./update.sh claude # Update Claude Code plugin ./update.sh claude --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type claude .\update.ps1 -Type claude -All

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

วิธีถอนการติดตั้งปลั๊กอินผู้ช่วย

Antigravity

Linux / macOS: bash rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows (PowerShell): powershell Remove-Item -Recurse -Force "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

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

Claude Code

ในเซสชัน Claude Code ที่ใช้งานอยู่ คุณจะทำสิ่งต่อไปนี้ได้ none /plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

หรือจากเทอร์มินัล ให้ทำดังนี้ bash claude plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

(ไม่บังคับ) นำรีจิสทรีของมาร์เก็ตเพลสในพื้นที่ออก bash claude plugin marketplace remove google-ads-assistant-local

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

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

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

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