Memperkenalkan Google Ads API Developer Assistant v2.0

Kamis, 26 Februari 2026

Update utama ini mengubah Asisten dari alat pembuat kode yang canggih menjadi partner otomatisasi dan pemecahan masalah yang proaktif bagi developer Google Ads. Sejak rilis v1.6.0, kami telah mendengarkan masukan Anda dan berfokus pada bagian pengembangan API yang paling menantang: diagnostik, konsistensi, dan penyiapan.

Apa yang baru di v2.0?

1. Penginstalan & Pemeliharaan yang Lebih Sederhana

Menyiapkan lingkungan pengembangan multibahasa seharusnya tidak merepotkan.

  • Penyiapan Satu Perintah: Gunakan flag --install-deps baru dengan install.sh atau install.ps1 untuk menangani dependensi pip, composer, dan bundler sekaligus.
  • Struktur Direktori Terpadu: Semua kode yang dihasilkan, ekspor CSV, dan laporan diagnostik Anda kini diatur dalam satu direktori saved/ dengan subdirektori untuk setiap jenis output.
  • Update Satu Perintah: Saat versi baru API dan library klien dirilis, Anda harus menjalankan update.sh untuk menggunakan versi terbaru. Anda juga dapat menggunakan update.sh untuk menambahkan library klien tambahan ke konteks Anda.

2. Pemecahan masalah konversi agentic

Tracking konversi offline adalah salah satu fitur Google Ads API yang paling canggih, tetapi juga rumit. Men-debug alasan konversi tidak diatribusikan dapat menjadi proses manual yang memakan waktu.

Di v2.0, kami telah memperkenalkan rangkaian Pemecahan Masalah & Diagnostik Konversi khusus.

  • Skrip Baru: api_examples/collect_conversions_troubleshooting_data.py
  • Perintah Baru: /conversions_support_data

Skrip ini menjalankan laporan standar untuk pemecahan masalah konversi dan memberikan konteks bagi Asisten untuk memecahkan masalah Anda.

Perintah ini paling berguna setelah Asisten menganalisis masalah konversi Anda dan mencoba menyelesaikannya. Jika tidak dapat, dan Anda perlu menghubungi dukungan, perintah ini akan menganalisis setelan pelanggan, tindakan konversi, dan ringkasan upload Anda untuk membuat laporan diagnostik terstruktur berdasarkan analisis yang telah dilakukan. Fitur ini bahkan mengidentifikasi status "tidak responsif" dan tingkat kegagalan yang tinggi secara otomatis, sehingga menghemat waktu Anda dalam memeriksa log. Alat ini menyimpan hasilnya ke file teks yang dapat Anda sertakan dengan permintaan dukungan jika Anda perlu mengajukannya.

3. Dibuat untuk API terbaru (v23)

Versi 2.0 sepenuhnya mendukung Google Ads API v23. Semua contoh interaktif kami telah diperbarui, dan konteks internal Asisten kini dioptimalkan untuk resource dan kolom terbaru, sehingga memastikan kode yang Anda buat siap produksi.

4. Otomatisasi yang Lancar dengan Session Hook

Kami telah menambahkan hook SessionStart dan SessionEnd untuk membuat alur kerja Anda benar-benar lancar.

  • Konfigurasi Otomatis: Asisten kini dapat otomatis menemukan file konfigurasi Anda di direktori $HOME pada awal sesi. Tindakan ini akan menyalinnya ke subdirektori config di direktori project Anda. Python adalah bahasa pilihan Gemini untuk membuat kueri API. Jadi, jika Anda menggunakan bahasa lain, library ini akan membaca file konfigurasi Anda dan membuat google-ads.yaml sementara di konfigurasi untuk kuerinya, tetapi akan terus merespons dalam kode bahasa pilihan Anda.
  • Pembersihan Otomatis: Konfigurasi sementara akan dihapus dengan aman saat Anda keluar, sehingga ruang kerja Anda tetap bersih dan kredensial Anda tetap aman.

5. Validasi GAQL yang lebih cerdas

Membangun kueri GAQL yang kompleks kini makin mudah. Kami telah memperbarui GEMINI.md dan conversions/GEMINI.md dengan aturan validasi yang ketat untuk kasus ekstrem API terbaru, termasuk penanganan segmen tanggal dan persyaratan rentang terbatas yang lebih baik. Asisten kini mendeteksi error logika sebelum Anda menjalankan kueri.

6. Keahlian

Anggap Skill sebagai plugin mini atau "blueprint perilaku". Meskipun konteks umum (seperti file GEMINI.md Anda) memberikan info latar belakang, Skill hanya "dimuat" ke dalam otak AI saat AI tersebut secara khusus perlu melakukan tugas prosedural yang kompleks seperti mendapatkan versi saat ini dari ekstensi ini. Anda tidak menjalankan Skill secara langsung. Gemini akan memutuskan kapan perlu menggunakannya.

Meskipun masih merupakan fitur eksperimental, kami telah menyertakan satu fitur dalam rilis ini untuk melengkapi penggunaan hook kami untuk inisialisasi dan pembersihan sesi.

Mengapa Anda Harus Mengupgrade?

Lompatan dari v1.6.0 ke v2.0.0 bukan sekadar tentang fitur baru, melainkan tentang keandalan. Dengan mengintegrasikan pengetahuan API yang mendalam dengan alat diagnostik otomatis, v2.0 mengurangi loop "uji coba" yang sering memperlambat integrasi API.

Baik Anda men-debug upload konversi maupun membangun pipeline pelaporan yang kompleks, v2.0 memberi Anda alat untuk bekerja lebih cepat dan lebih percaya diri.

Memulai

Penginstalan pertama

Mengupgrade dari versi sebelumnya

  • Salin kode kustom apa pun dari saved_code/ dan saved_csv/ ke lokasi yang aman.
  • Hapus clone lokal Asisten Developer Google Ads API dengan menghapus direktori project Anda serta semua subdirektori dan file.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Di direktori project, jalankan install.sh atau install.ps1 untuk menginstal ekstensi dan library klien.

Bob Hancock, Tim Google Ads API

Label: google-ads-api, release