Asisten Developer Google Ads API

Asisten Developer Google Ads API adalah ekstensi canggih untuk Gemini CLI yang dirancang untuk mempercepat alur kerja Google Ads API Anda. Asisten memungkinkan Anda berinteraksi dengan Google Ads API menggunakan bahasa alami, sehingga memudahkan Anda mengajukan pertanyaan, membuat kode, mengambil data, dan memecahkan masalah secara langsung dalam terminal Anda.

Manfaat

  • Meningkatkan produktivitas: Mengurangi waktu yang dihabiskan untuk menelusuri dokumentasi dan menulis kode boilerplate.
  • Menyederhanakan tugas yang kompleks: Buat kode Bahasa Kueri Google Ads (GAQL) dan library klien dari perintah bahasa Inggris sederhana.
  • Pelajari API: Pahami konsep API dan lihat cara permintaan bahasa alami diterjemahkan menjadi kode yang dapat dieksekusi.
  • Penelusuran bug interaktif: Dapatkan bantuan untuk memahami error dan panduan langkah demi langkah tentang pemecahan masalah.
  • Alur kerja yang disederhanakan: Pertahankan loop pengembangan dan pengujian Anda dalam command line.

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal-hal berikut:

  1. Akses Google Ads API:

  2. Software:

    • Python 3.10 atau yang lebih baru. Python adalah bahasa default, jadi Anda harus menginstal dan menyertakannya di jalur Anda.
    • Gemini CLI telah diinstal.
    • jq (pemroses JSON command line). Skrip penyiapan akan mencoba menginstalnya jika tidak ada.

  3. Repositori:

    • Clone lokal repositori google-ads-api-developer-assistant dari GitHub:

Mulai

  1. Buka direktori project:

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

  2. Jalankan skrip penyiapan: Skrip ini mengonfigurasi Gemini CLI untuk menggunakan file konteks dan alat yang diperlukan asisten.GEMINI.md

    ./setup.sh

    Jika Anda menggunakan Windows, jalankan skrip PowerShell setup.ps1.

  3. Mulai Gemini CLI:

    gemini

  4. Berinteraksi dengan Asisten: Anda kini dapat mengajukan pertanyaan atau memberikan perintah dalam bahasa alami.

Fitur utama

  • Tanya jawab bahasa alami: Ajukan pertanyaan tentang fitur Google Ads API, praktik terbaik, atau resource tertentu.

    • "Apa saja jenis kampanye yang tersedia?"
    • "Bagaimana cara memfilter menurut tanggal di GAQL?"
    • "Jelaskan perbedaan antara click_view dan impression_view."

  • Pembuatan kode: Buat kueri GAQL dan cuplikan kode Python yang dapat dieksekusi.

    • "Tampilkan kampanye dengan konversi terbanyak dalam 30 hari terakhir."
    • "Dapatkan semua nama grup iklan yang diaktifkan untuk ID kampanye 12345."
    • "Temukan iklan yang tidak disetujui di semua kampanye." Kode yang dihasilkan disimpan di direktori saved_code/.

  • Eksekusi API langsung: Jalankan skrip Python hanya baca yang dihasilkan langsung dari Gemini CLI dan lihat hasil yang diformat di terminal Anda. Setelah Asisten membuat kode, Anda akan menerima perintah di layar:

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>

Masukkan run, dan skrip akan dijalankan dalam konteks Asisten.

  • Ekspor CSV: Simpan hasil tabular dari panggilan API ke file CSV.

    • "Simpan hasil ke file CSV." File disimpan di direktori saved_csv/.

  • Bantuan pemecahan masalah: Dapatkan bantuan terkait pesan error atau perilaku API yang tidak terduga.

    • "Saya mendapatkan error 'AuthenticationError.OAUTH_TOKEN_INVALID', apa yang harus saya lakukan?"
    • "Mengapa saya tidak melihat hasil apa pun untuk kueri saya?"

Contoh kasus penggunaan

  • Pelaporan:
    • "Get me the top 5 keywords by cost for last month for customer 12345678." (Berikan 5 kata kunci teratas menurut biaya untuk bulan lalu bagi pelanggan 12345678).
  • Struktur akun:
    • "Cantumkan semua nama kampanye dan ID-nya."
  • Pemecahan masalah:
    • "Saya mengupload 100 konversi, tetapi hanya 78 yang muncul di UI. Bagaimana cara men-debugnya menggunakan API?"
  • Pembelajaran:
    • "Pandu saya cara membuat kampanye Performa Maksimal menggunakan API."

Komunitas dan dukungan

Pedoman kontribusi

Kami menerima kontribusi. Lihat file CONTRIBUTING.md di repositori GitHub untuk mengetahui panduannya.