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

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

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

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

  2. ซอฟต์แวร์

    • Python 3.10 ขึ้นไป Python เป็นภาษาเริ่มต้น ดังนั้นคุณต้องติดตั้งภาษาดังกล่าวและอยู่ในเส้นทาง
    • เครื่องมือบรรทัดคำสั่ง Google Antigravity ที่ติดตั้ง
    • jq (ตัวประมวลผล JSON บรรทัดคำสั่ง) สคริปต์การติดตั้งจะพยายามติดตั้งเครื่องมือนี้หากไม่มี

  3. ที่เก็บ

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

  1. ไปที่ไดเรกทอรีโปรเจ็กต์

    cd <full path>/google-ads-api-developer-assistant

    (หมายเหตุ: หากคุณเปิดใช้การผสานรวมเชลล์ Antigravity ไว้ การเข้าสู่ไดเรกทอรีนี้จะเริ่มต้นเซสชัน Assistant โดยอัตโนมัติ)

  2. เรียกใช้สคริปต์การติดตั้ง: สคริปต์นี้จะเริ่มต้นสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และโคลนไลบรารีของไคลเอ็นต์ Google Ads ที่จำเป็น (Python จะติดตั้งไว้โดยค่าเริ่มต้น)

    ./install.sh

    หากใช้ Windows ให้เรียกใช้สคริปต์ install.ps1 PowerShell

  3. กำหนดค่าข้อมูลเข้าสู่ระบบ: ตรวจสอบว่าไฟล์ google-ads.yaml (หรือไฟล์เทียบเท่าในภาษาอื่น) อยู่ในไดเรกทอรีโฮม

  4. โต้ตอบกับ Assistant: หลังจากเซสชันทำงานอยู่ คุณสามารถโต้ตอบกับ Assistant โดยใช้ภาษาธรรมชาติได้โดยตรงในเทอร์มินัล

ฟีเจอร์หลัก

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

    • "ข้อใดคือประเภทแคมเปญที่พร้อมใช้งาน"
    • "ฉันจะกรองตามวันที่ใน GAQL ได้อย่างไร"
    • "อธิบายความแตกต่างระหว่าง click_view กับ impression_view"

  • การสร้างโค้ด: สร้างคําค้นหา GAQL และข้อมูลโค้ด Python ที่เรียกใช้ได้

    • "แสดงแคมเปญที่มี Conversion มากที่สุดในช่วง 30 วันที่ผ่านมา"
    • "รับชื่อกลุ่มโฆษณาที่เปิดใช้ทั้งหมดสำหรับรหัสแคมเปญ 12345"
    • "ค้นหาโฆษณาที่ไม่ได้รับอนุมัติในทุกแคมเปญ" ระบบจะ Lint โค้ดที่สร้างขึ้นโดยอัตโนมัติโดยใช้ ruff และบันทึกไว้ในไดเรกทอรี saved/code/

  • การเรียกใช้ API โดยตรง: เรียกใช้สคริปต์ Python แบบอ่านอย่างเดียวที่สร้างขึ้นภายในสภาพแวดล้อมเสมือนที่แยกไว้ (.venv) โดยตรง และดูผลลัพธ์ที่จัดรูปแบบเป็นตารางในเทอร์มินัล

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

  • การส่งออก CSV: บันทึกผลลัพธ์แบบตารางจากการเรียก API ลงในไฟล์ CSV

    • "บันทึกผลลัพธ์ลงในไฟล์ CSV" ระบบจะบันทึกไฟล์ไว้ในไดเรกทอรี saved/csv/

  • การวินิจฉัยและการแก้ปัญหาขั้นสูง: รับความช่วยเหลือเกี่ยวกับข้อความแสดงข้อผิดพลาด ลักษณะการทำงานที่ไม่คาดคิดของ API หรือปัญหาเกี่ยวกับ Conversion ออฟไลน์

    • "ทำไมฉันจึงไม่เห็นผลลัพธ์สำหรับคําค้นหา"
    • "แก้ปัญหา Conversion สำหรับลูกค้า 123-456-7890" (สร้างรายงานการวินิจฉัยโดยละเอียดใน saved/data/)

  • บริบทเพิ่มเติม: เพิ่มฐานของโค้ดหรือไลบรารีที่กำหนดเองของคุณเพื่อใช้เป็นบริบท

    • ใช้สคริปต์ update.sh พร้อมตัวเลือก --context_path เพื่อลงทะเบียน ไฟล์โปรเจ็กต์ none ./update.sh --context_path /path/to/your/codebase
    • วิธีนี้ช่วยให้ Assistant สามารถรวมตรรกะของแอปพลิเคชันไว้ในการให้เหตุผลเมื่อสร้างคำตอบหรือสร้างโค้ดในภาษาที่คุณต้องการ

ตัวอย่าง Use Case

  • การรายงาน:
    • "แสดงคีย์เวิร์ด 5 อันดับแรกตามค่าใช้จ่ายของเดือนที่แล้วสำหรับลูกค้า 12345678"
  • โครงสร้างบัญชี:
    • "แสดงชื่อแคมเปญและรหัสทั้งหมด"
  • การแก้ปัญหา:
    • "ฉันอัปโหลด Conversion 100 รายการ แต่มีเพียง 78 รายการที่ปรากฏใน UI ฉันจะแก้ไขข้อบกพร่องนี้โดยใช้ API ได้อย่างไร"
  • การเรียนรู้:
    • "/อธิบายว่าชุดที่แชร์คืออะไร"
  • การสร้างโค้ด:
    • "เขียนโค้ดเพื่อสร้างแคมเปญ Performance Max สำหรับ company name"

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

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

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

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