Memperkenalkan Google Ads API Developer Assistant v3.0.0

Rabu, 10 Juni 2026

Dengan senang hati kami umumkan rilis v3.0.0 dari Asisten Developer Google Ads API. Rilis utama ini menandai pencapaian penting dalam evolusi Asisten, yang berfokus pada modernisasi arsitektur, peningkatan keandalan, dan desain yang lebih modular.

Dengan rilis ini, kami memigrasikan Asisten ke framework agen Google Antigravity dan beralih ke arsitektur berbasis Keahlian. Perubahan ini membuat Asisten lebih andal, lebih mudah dikelola, dan mengurangi penggunaan token.

Apa yang baru di v3.0.0?

1. Didukung oleh framework Antigravity

Asisten Developer Google Ads API telah dimigrasikan dari gemini-cli ke framework agen Antigravity (v3.0.0). Upgrade framework dasar ini menyediakan lingkungan eksekusi yang lebih terstruktur dan andal. Selain itu, struktur direktori dan file project telah diperbarui agar sepenuhnya siap untuk Antigravity.

Dukungan untuk gemini-cli akan dihentikan pada 18 Juni 2026, seperti yang dijelaskan dalam pengumuman blog Google ini.

2. Arsitektur modular berbasis keterampilan

Kami telah mentransisikan kemampuan inti Asisten ke Keterampilan. Daripada mengandalkan petunjuk yang luas dan tidak terstruktur dalam file konteks, Asisten kini memuat direktori alat khusus yang didukung pengujian (Keahlian) secara dinamis saat diperlukan. Hal ini secara signifikan mengurangi "halusinasi" dan memastikan tugas dijalankan menggunakan prosedur yang tepat dan terverifikasi.

Update penting dalam transisi modular ini meliputi:

  • Validasi GAQL (validate_gaql): Dipindahkan ke keterampilan khusus. Sekarang, fitur ini menyertakan pemeriksaan kueri statis yang ditingkatkan untuk segmen tanggal, filter satu hari click_view, dan batas change_status.
  • Memecahkan masalah konversi (troubleshoot_conversions): Menggantikan conversions_support_package lama. Skill ini menggabungkan semua skrip pemecahan masalah konversi dan ringkasan upload, serta pengujian ke dalam satu direktori skill yang kohesif.
  • Perintah terstruktur (explain dan step_by_step): Dikonversi menjadi keterampilan untuk menerapkan tata letak yang konsisten dan terstruktur untuk penjelasan.
  • Pemetaan akun baru (get_cids_under_mcc): Kemampuan baru untuk mengambil semua akun turunan di Akun Pengelola (MCC).
  • Pemeriksaan objek baru (inspect_object): Kemampuan baru untuk mencari pesan dan Enum Protobuf secara dinamis dan cepat, untuk membantu memastikan Asisten selalu menggunakan struktur yang benar.
  • Filter listingan PMax baru (pmax_listing_filter): Kemampuan baru untuk menstandarkan modifikasi hierarki pengecualian halaman web kelompok listing untuk kampanye Performa Maksimal.

3. Konsistensi & ketelitian yang ditingkatkan

Kami telah memperkenalkan aturan dan persyaratan yang lebih ketat untuk membantu memastikan pembuatan kode dan validasi kueri berkualitas tinggi:

  • Pembuatan versi API eksplisit: Skill penting seperti get_cids_under_mcc, validate_gaql, dan troubleshoot_conversions kini memerlukan argumen api_version eksplisit, sehingga menghilangkan ambiguitas.
  • Aturan GAQL yang ketat:
    • Menambahkan aturan ke AGENTS.md untuk mencegah penggunaan fungsi agregat SQL (seperti SUM, COUNT, dan AVG) dalam kueri GAQL, karena tidak didukung.
    • Menambahkan aturan untuk memeriksa catatan rilis situs Developer Google Ads API terlebih dahulu untuk versi API saat ini guna memastikan Asisten menggunakan dokumentasi terbaru.
    • Konfigurasi yang disederhanakan: AGENTS.md telah disederhanakan sehingga menghasilkan jendela konteks awal yang lebih kecil. Dokumentasi konversi duplikat telah dihapus dan digantikan dengan keterampilan terprogram.

4. Peningkatan Pengalaman Developer (DX)

Kami telah melakukan beberapa peningkatan kualitas untuk membuat loop pengembangan Anda lebih cepat dan lancar:

  • Lingkungan virtual persisten (.venv): Lingkungan virtual tidak lagi dihapus di akhir sesi. Saat memulai, Asisten akan memeriksa versi Python sistem Anda; Asisten hanya akan membangun ulang .venv jika versi Python yang lebih baru tersedia.
  • Smart API version caching: Asisten kini meng-cache versi Google Ads API saat ini dengan TTL 19 jam, sehingga mengurangi waktu startup dengan menghindari pemeriksaan jaringan yang berlebihan.
  • Proses debug yang lebih baik dengan log persisten: Pesan log kini menyertakan stempel tanggal dan waktu. File log ditulis ke direktori .agents/ dan tidak lagi direset pada setiap operasi, sehingga histori untuk pemecahan masalah tetap dipertahankan.

Mengapa Anda harus mengupgrade?

Upgrade ke v3.0.0 terutama berfokus pada keandalan dan struktur. Dengan beralih ke framework Antigravity dan memodularisasi fitur menjadi Skill, kami telah membuat Asisten lebih mudah diprediksi dan efisien dalam penggunaan resource.

Jika Anda menginginkan startup yang lebih cepat, validasi GAQL yang lebih andal, dan pengalaman pemecahan masalah yang lebih efektif, sebaiknya upgrade ke v3.0.0.

Mulai

Penginstalan pertama

  1. Instal Antigravity CLI: Ikuti petunjuk di https://antigravity.google/.
  2. Membuat clone Asisten: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Jalankan Skrip Penginstalan:
    • Linux/macOS: Jalankan ./install.sh (secara default mendukung Python, gunakan flag seperti --php atau --ruby untuk bahasa lain).
    • Windows: Buka PowerShell dan jalankan .\install.ps1.

Mengupgrade dari v2.x

  1. Salin kode atau data kustom dari saved/ ke lokasi yang aman di luar direktori project.
  2. Hapus clone lokal Asisten Anda.
  3. Buat clone repositori:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Jalankan skrip penginstalan (install.sh atau install.ps1) untuk melakukan inisialisasi lingkungan Antigravity baru.

Bob Hancock, Tim Google Ads API

Label: google-ads-api, release