Penghentian dan penghentian total

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 sekaligus.
• 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 spesifik untuk setiap versi yang tersedia, dan 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 API	Tanggal rilis	Tanggal penghentian	Tanggal penghentian	Panduan upgrade
v21	6 Agustus 2025			Mengupgrade dari v20 ke v21
v20.1	6 Agustus 2025		Juni 2026 (tentatif)	Mengupgrade dari v19 ke v20
v20	4 Juni 2025		Juni 2026 (tentatif)	Mengupgrade dari v19 ke v20
v19.2	6 Agustus 2025		Februari 2026 (tentatif)	Mengupgrade dari v18 ke v19
v19.1	16 April 2025		Februari 2026 (tentatif)	Mengupgrade dari v18 ke v19
v19	26 Februari 2025		Februari 2026 (tentatif)	Mengupgrade dari v18 ke v19
v18	16 Oktober 2024	Juni 2025	20 Agustus 2025

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.v21.services.GoogleAdsService.Mutate.
4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian penggunaan dan penghentian layanan

Istilah	Status penghentian penggunaan	Senja
Definisi	Versi yang tidak digunakan lagi adalah versi yang bukan versi 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 tidak lagi ditandai 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 melakukan upgrade 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 berencana 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. Poin Penting: Versi API yang tidak digunakan lagi masih tersedia di versi library klien yang dirilis sebelumnya. Anda masih dapat mendownload dan menggunakannya hingga versi API dihentikan.	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

Google Ads API	Library klien untuk Java
v21	Min: 39.0.0 Max: -
v20	Min: 38.0.0 Max: -
v19	Min: 36.0.0 Max: -

C#

Google Ads API	Library klien untuk .NET
v21	Min: 24.0.0 Max: -
v20	Min: 23.0.0 Max: -
v19	Min: 22.1.0 Max: -
v18	Min: 21.1.0 Max: 23.0.0

PHP

Google Ads API	Library klien untuk PHP
v21	Min: 31.0.0 Max: -
v20	Min: 28.0.0 Max: -
v19	Min: 26.1.0 Max: -
v18	Min: 25.0.0 Max: 30.0.0

Python

Google Ads API	Library klien untuk Python
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 25.2.0 Max: -

Ruby

Google Ads API	Library klien untuk Ruby
v21	Min: 35.0.0 Max: -
v20	Min: 34.0.0 Max: -
v19	Min: 32.0.0 Max: -
v18	Min: 31.0.0 Max: -

Perl

Google Ads API	Library klien untuk Perl
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 26.0.0 Max: -
v18	Min: 25.0.1 Max: 28.0.0

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
Lingkungan konversi yang memengaruhi performa kampanye Aplikasi	Mulai 30 September 2025, kami akan mulai meluncurkan perubahan secara bertahap pada model bidding, sehingga model tersebut dapat menggunakan data lingkungan konversi yang disertakan dalam konversi yang diimpor untuk mengoptimalkan performa kampanye.	3 Oktober 2025	Lihat postingan blog kami untuk mengetahui detail selengkapnya.
Konversi dapat mencakup nilai `gclid` dan `gbraid`.	Mulai 3 Oktober 2025, konversi yang diimpor tidak akan lagi menampilkan error `VALUE_MUST_BE_UNSET` jika kolom `gclid` dan `gbraid` disetel.	3 Oktober 2025	Lihat postingan blog kami untuk mengetahui detail selengkapnya.