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

หมายเหตุ: เครื่องมือนี้เป็นโปรเจ็กต์โอเพนซอร์สและไม่ใช่ผลิตภัณฑ์อย่างเป็นทางการของ Google

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

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

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

   • โทเค็นของนักพัฒนา Google Ads API
   • ไฟล์การกำหนดค่า Google Ads ที่กำหนดค่าด้วยโทเค็นของนักพัฒนา ข้อมูลเข้าสู่ระบบ OAuth 2.0 และรหัสลูกค้า ซึ่งโดยปกติจะอยู่ในไดเรกทอรีแรก ดู คู่มือการกำหนดค่าไลบรารีของไคลเอ็นต์
   • ความคุ้นเคยกับแนวคิดและการตรวจสอบสิทธิ์ของ 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 และเครื่องมือที่จำเป็นของ Assistant

   ./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' ฉันควรทำอย่างไร"
  • "ทำไมฉันจึงไม่เห็นผลลัพธ์สำหรับคำค้นหา"

• บริบทเพิ่มเติม: เพิ่มฐานของโค้ดเพื่อใช้เป็นบริบท

  • ตั้งแต่เวอร์ชัน 2.3.0 ให้ใช้แฟล็ก context_dir เพื่อรวมไฟล์โปรเจ็กต์ ./update.sh --context_dir /path/to/your/codebase ซึ่งจะช่วยให้ Assistant สามารถรวมตรรกะของแอปพลิเคชันไว้ในการให้เหตุผลเมื่อสร้าง คำตอบ
  • ฟีเจอร์นี้ช่วยให้ Assistant สร้างตัวอย่างโค้ดที่บันทึกไว้ในภาษาที่คุณเลือกได้ แม้ว่าจะไม่มีไลบรารีของไคลเอ็นต์อย่างเป็นทางการก็ตาม
  • ก่อนขอเอาต์พุตโค้ด ให้บอก Assistant ว่า: write saved code examples in <language of your application>

ตัวอย่าง Use Case

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

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

• ปัญหาใน GitHub: รายงานข้อบกพร่อง เสนอแนะฟีเจอร์ หรือขอความช่วยเหลือใน แท็บ Issues ในที่เก็บ
• Discord: เข้าร่วมการสนทนาในแชแนล #ads-api-ai-tools ใน เซิร์ฟเวอร์ Discord ของชุมชนการโฆษณาและการวัดผลของ Google
• ความคิดเห็น: แชร์ความคิดเห็นผ่าน แบบฟอร์มสำรวจนี้

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

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