ผู้ช่วยนักพัฒนาซอฟต์แวร์ Google Ads API

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

ข้อดี

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

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

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

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

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

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

  3. ที่เก็บ:

    • สำเนาที่โคลนในเครื่องของที่เก็บ google-ads-api-developer-assistant จาก GitHub

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

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

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

  2. เรียกใช้สคริปต์การตั้งค่า: สคริปต์นี้จะกำหนดค่า Gemini CLI ให้ใช้GEMINI.md ไฟล์บริบทและเครื่องมือที่จำเป็นของผู้ช่วย

    ./setup.sh

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

  3. เริ่มใช้ Gemini CLI:

    gemini

  4. โต้ตอบกับ Assistant: ตอนนี้คุณสามารถถามคำถามหรือออกคำสั่งด้วยภาษาง่ายๆ ได้แล้ว

ฟีเจอร์หลัก

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

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

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

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

  • การเรียกใช้ API โดยตรง: เรียกใช้สคริปต์ Python แบบอ่านอย่างเดียวที่สร้างขึ้นโดยตรง จาก Gemini CLI และดูผลลัพธ์ที่จัดรูปแบบในเทอร์มินัล หลังจากที่ Assistant สร้างโค้ดแล้ว คุณจะได้รับข้อความแจ้งบนหน้าจอ

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

ป้อน run แล้วสคริปต์จะทำงานในบริบทของ Assistant

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

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

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

    • "ฉันได้รับข้อผิดพลาด 'AuthenticationError.OAUTH_TOKEN_INVALID' ฉันควรทำอย่างไร"
    • "ทำไมฉันไม่เห็นผลลัพธ์สำหรับคำค้นหาของฉัน"

ตัวอย่าง Use Case

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

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

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

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