Penghentian penggunaan dan penghentian layanan

Dengan rilis versi baru, versi yang tidak digunakan lagi diberi tanggal penghentian, dan setelahnya versi tersebut tidak lagi tersedia. Berikut beberapa panduan lain yang perlu diperhatikan:

  • Kami berupaya untuk menyediakan maksimal empat versi utama dalam satu waktu.
  • Versi utama memiliki masa aktif sekitar 12 bulan—versi minor: 10 bulan.
  • Anda harus melakukan maksimal dua upgrade per tahun, dan Anda tidak harus melakukan upgrade dalam urutan berurutan yang ketat—misalnya, Anda dapat melakukan upgrade dari versi (N) langsung ke versi (N+2).
  • Tumpang-tindih antara tanggal saat semua library klien dirilis untuk versi terbaru dan versi yang akan dihentikan setidaknya 20 minggu.

Library klien kami mendukung semua versi layanan yang tersedia, sehingga Anda dapat melakukan upgrade secara bertahap dengan menentukan versi layanan yang digunakan.

Jadwal

Tabel berikut mencantumkan tanggal penghentian dan penonaktifan spesifik untuk setiap versi yang tersedia, serta perkiraan tanggal rilis untuk versi mendatang. Sebaiknya Anda mengupgrade ke versi terbaru secepat mungkin setelah versi terbaru dirilis. Tanggal tentatif berarti penghentian dapat terjadi kapan saja dalam bulan tersebut, dan tanggalnya dapat berubah. Berlangganan ke blog untuk mendapatkan pengingat pengumuman penghentian versi API.

Versi APITanggal rilisTanggal penghentianPanduan upgrade
Versi yang dirilis
v1926 Februari 2025 11 Februari 2026
v19.116 April 2025 11 Februari 2026
v19.26 Agustus 2025 11 Februari 2026
v204 Juni 2025Juni 2026 (tentatif)Mengupgrade dari v19 ke v20
v20.16 Agustus 2025Juni 2026 (tentatif)Mengupgrade dari v19 ke v20
v216 Agustus 2025Agustus 2026 (tentatif)Mengupgrade dari v20 ke v21
v2215 Oktober 2025Oktober 2026 (tentatif)Mengupgrade dari v21 ke v22
v2328 Januari 2026Februari 2027Mengupgrade dari v22 ke v23
Versi mendatang
v23.1 Februari 2026 Februari 2027  
v23.2 25 Maret 2026 Februari 2027  
v24 April 2026 Mei 2027  
v24.1 Mei 2026 Mei 2027  
v24.2 Juni 2026 Mei 2027  
v25 Juli 2026 Agustus 2027  
v25.1 Agustus 2026 Agustus 2027  
v25.2 September 2026 Agustus 2027  
v26 Oktober 2026 November 2027  
v26.1* November 2026 November 2027  

* v26.1 ditetapkan sebagai rilis opsional karena bertepatan dengan musim liburan.

Melihat versi yang digunakan project Anda

Anda dapat melihat daftar metode dan layanan yang baru-baru ini dipanggil project Anda menggunakan Konsol Google Cloud:

  1. Buka APIs & Services di Konsol Google Cloud.
  2. Klik Google Ads API di tabel.
  3. Di subtab METRIK, Anda akan melihat permintaan terbaru yang diplot pada setiap grafik. Anda dapat melihat metode yang Anda kirimkan permintaan di tabel Metode. Nama metode mencakup versi Google Ads API, layanan, dan nama metode, seperti google.ads.googleads.v23.services.GoogleAdsService.Mutate.
  4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian penggunaan dan penghentian layanan

IstilahStatus penghentian penggunaanSenja
Definisi Versi yang tidak digunakan lagi adalah versi yang bukan yang terbaru. Setelah versi baru dirilis, semua versi sebelumnya akan ditandai sebagai tidak digunakan lagi. Versi yang dihentikan tidak dapat digunakan lagi. Permintaan yang dikirim ke versi ini akan gagal pada atau setelah tanggal penghentian.
Implikasi Anda masih dapat menggunakan versi yang tidak digunakan lagi hingga versi tersebut dihentikan, tetapi referensi versi yang tidak digunakan lagi akan dihilangkan penyorotannya untuk menunjukkan bahwa versi tersebut bukan lagi versi terbaru.

Sebaiknya Anda mengupgrade ke versi terbaru sesegera mungkin untuk mendapatkan manfaat dari fitur baru.

 Anda harus mengupgrade dari versi yang dihentikan segera untuk menggunakan Google Ads API.

Sangat disarankan agar Anda mengupgrade ke versi terbaru, menggunakan panduan upgrade.
Waktu Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, sehingga versi yang diberikan akan dihentikan setelah sekitar 3 hingga 4 bulan. Kami berupaya menghentikan penggunaan versi 1 tahun setelah rilisnya.
API Endpoint API untuk versi yang tidak digunakan lagi masih berfungsi seperti biasa.

Anda dapat mengakses endpoint API kami menggunakan library klien, REST, dan sebagainya; namun, fitur baru tidak ditambahkan ke versi yang tidak digunakan lagi.

 Endpoint API untuk versi yang dihentikan berhenti berfungsi setelah tanggal penghentian. Google Ads API akan menampilkan error jika Anda mencoba mengakses endpoint API versi yang dihentikan.
Library klien Untuk tujuan menyediakan library klien yang ringkas, kami akan berhenti menyertakan versi API yang tidak digunakan lagi dalam versi library klien baru setelah tanggal penghentian penggunaan. Hal ini membantu Anda menghemat ruang saat menggabungkan library klien kami dalam project Anda. Library klien tidak lagi mendukung versi API yang dihentikan di versi library klien baru setelah tanggal penghentian.
Dukungan Kami memberikan dukungan rutin untuk versi yang tidak digunakan lagi. Versi yang dihentikan tidak lagi didukung setelah tanggal penghentian.

Versi library klien yang didukung

Tabel ini menunjukkan library klien mana yang berfungsi dengan versi API mana.

Java

Library klien untuk Java
v23 Min: 42.0.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

C#

Library klien untuk .NET
v23 Min: 25.0.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

Library klien untuk PHP
v23 Min: 32.1.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Library klien untuk Python
v23 Min: 29.0.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Library klien untuk Ruby
v23 Min: 37.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Library klien untuk Perl
v23 Min: 30.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Penghentian penggunaan fitur

Pantau blog developer Google Ads secara rutin agar menjadi yang pertama mengetahui penghentian penggunaan fitur mendatang.

Tabel berikut mencantumkan penghentian penggunaan fitur tertentu yang direncanakan untuk Google Ads API. Detail selengkapnya untuk setiap penghentian dapat ditemukan di postingan blog tertaut.

Fitur Deskripsi Tanggal efektif Catatan tambahan
Perubahan pada dukungan atribut sesi dan alamat IP Mulai 2 Februari 2026, Google Ads API tidak akan lagi menerima pengguna baru atribut sesi atau data alamat IP sebagai bagian dari impor konversi. Pengguna lama harus bermigrasi ke Data Manager API. 2 Februari 2026 Lihat postingan blog kami untuk mengetahui detail selengkapnya.
Penghentian penggunaan iklan khusus panggilan telepon Mulai Januari 2026, iklan khusus panggilan telepon baru tidak dapat dibuat. Iklan khusus panggilan telepon yang ada akan berhenti ditayangkan pada Februari 2027 dan dukungan API akan dihapus. Pengiklan sebaiknya menggunakan Iklan Penelusuran Responsif dengan aset panggilan sebagai gantinya. Januari 2026 Lihat postingan blog kami untuk mengetahui detail selengkapnya.