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

ผู้ช่วยนักพัฒนาซอฟต์แวร์ Google Ads API จะนำความเชี่ยวชาญด้านโดเมน 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:

./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 วันที่ผ่านมา"
    • "รับชื่อกลุ่มโฆษณาที่เปิดใช้ทั้งหมดสำหรับลูกค้า 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:

      ./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 แก้ไขลําดับชั้น 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:

./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

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

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

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