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

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

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

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

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

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

  3. ที่เก็บ:

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

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

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

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

    ./install.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 หากภาษาเริ่มต้นเป็น Python, Ruby หรือ PHP ภาษาที่คอมไพล์แล้วจะไม่ทำงานเนื่องจาก นโยบายความปลอดภัย

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

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

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

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

ตัวอย่าง Use Case

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

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

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

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