ติดตั้งและใช้ผู้ช่วยนักพัฒนาซอฟต์แวร์ 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 คำสั่งเครื่องหมายทับในตัว และทักษะเฉพาะด้านเพื่อรักษาบริบทที่ต่อเนื่อง ขอบเขตความปลอดภัยที่แข็งแกร่ง และไปป์ไลน์การตรวจสอบอัตโนมัติ

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

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

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

    • โทเค็นของนักพัฒนา Google Ads API
    • ไฟล์การกำหนดค่า Google Ads ที่กำหนดค่าด้วยโทเค็นของนักพัฒนา ข้อมูลเข้าสู่ระบบ OAuth 2.0 และรหัสลูกค้า ซึ่งอยู่ในไดเรกทอรีโฮม (เช่น google-ads.yaml สำหรับ Python) ดู คู่มือการกำหนดค่าไลบรารีของไคลเอ็นต์
    • ความคุ้นเคยกับแนวคิดและการตรวจสอบสิทธิ์ของ 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, กฎสถาปัตยกรรม หรือทรัพยากรที่เฉพาะเจาะจง 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/)

  • การแมปลำดับชั้นบัญชี 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 คุณจะใช้คำสั่งเครื่องหมายทับในตัวต่อไปนี้ได้ ใน 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

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

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

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 คืออะไร