Penghentian penggunaan dan penghentian

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

• Kami berusaha untuk menyediakan maksimal lima versi utama setiap saat.
• Versi utama memiliki masa aktif sekitar 12 bulan—versi minor: 10 bulan.
• Anda harus melakukan maksimal dua upgrade per tahun, dan Anda tidak harus mengupgrade dalam urutan berurutan yang ketat — misalnya, Anda dapat mengupgrade dari versi (N) langsung ke versi (N+2).

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

Jadwal

Tabel berikut mencantumkan tanggal penghentian spesifik untuk setiap versi yang tersedia, dan tanggal rilis yang diproyeksikan untuk versi mendatang. Sebaiknya upgrade ke versi terbaru secepat mungkin setelah versi terbaru dirilis. Tanggal tentatif berarti penghentian dapat terjadi kapan saja pada bulan tersebut, dan tanggal dapat berubah. Berlanggananlah blog untuk mendapatkan pengingat pengumuman penghentian versi API.

Versi API	Tanggal rilis	Tanggal "dihentikan"	Panduan upgrade
Versi yang dirilis
v21	6 Agustus 2025	Agustus 2026 (tentatif)	Upgrade dari v20 ke v21
v22	15 Oktober 2025	Oktober 2026 (tentatif)	Upgrade dari v21 ke v22
v23	28 Januari 2026	Februari 2027	Upgrade dari v22 ke v23
v23.1	25 Februari 2026	Februari 2027	Upgrade dari v23 ke v23.1
v23.2	25 Maret 2026	Februari 2027	Upgrade dari v23.1 ke v23.2
v24	22 April 2026	Mei 2027	Upgrade dari v23.2 ke v24
v24.1	13 Mei 2026	Mei 2027	Upgrade dari v24 ke v24.1
v24.2	24 Juni 2026	Juni 2027	Upgrade dari v24.1 ke v24.2
Versi mendatang
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 tumpang-tindih 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 METRICS, Anda akan melihat permintaan terbaru yang diplot di setiap grafik. Anda dapat melihat metode yang telah dikirimi permintaan di tabel Methods. Nama metode mencakup versi Google Ads API, layanan, dan nama metode, seperti google.ads.googleads.v24.services.GoogleAdsService.Mutate.
4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian penggunaan dan penghentian

Istilah	Status penghentian penggunaan	Penghentian
Definisi	Versi yang tidak digunakan lagi adalah versi yang bukan versi terbaru. Setelah versi baru dirilis, semua versi sebelumnya akan ditandai tidak digunakan lagi.	Versi yang dihentikan tidak dapat lagi digunakan. Permintaan yang dikirim ke versi ini akan gagal pada atau setelah tanggal penghentian.
Implikasi	Anda masih dapat menggunakan versi yang tidak digunakan lagi hingga dihentikan, tetapi referensi versi yang tidak digunakan lagi akan dihilangkan penyorotannya untuk menunjukkan bahwa versi tersebut bukan lagi versi terbaru. Sebaiknya upgrade ke versi terbaru sesegera mungkin untuk mendapatkan manfaat dari fitur baru.	Anda harus mengupgrade dari versi yang dihentikan segera di agar dapat menggunakan Google Ads API. Sebaiknya upgrade ke versi terbaru, menggunakan panduan upgrade.
Pengaturan waktu	Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, sehingga versi yang diberikan akan tidak digunakan lagi setelah sekitar 3 hingga 4 bulan.	Kami bertujuan untuk menghentikan versi 1 tahun setelah dirilis.
API	Endpoint API untuk versi yang tidak digunakan lagi masih berfungsi seperti biasa. Anda dapat mengakses endpoint API kami menggunakan library klien dan REST. 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 dari 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. Hal ini membantu Anda menghemat ruang saat menggabungkan library klien kami dalam project Anda.	Library klien tidak lagi mendukung versi API yang dihentikan dalam versi library klien baru setelah tanggal penghentian.
Dukungan	Kami memberikan dukungan reguler untuk versi yang tidak digunakan lagi.	Versi yang dihentikan tidak lagi didukung setelah tanggal penghentian date.

Versi library klien yang didukung

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

Versi library klien minimum yang tercantum sudah cukup untuk rilis Google Ads API utama (seperti v24). Untuk melihat versi library klien yang diperlukan untuk rilis minor, lihat Log Perubahan yang ditautkan.

Penghentian penggunaan dan perubahan fitur

Meskipun halaman ini berfokus pada siklus proses tingkat versi API, penghentian penggunaan fitur individual (seperti penghentian penggunaan Kampanye Pintar) dan perubahan alur kerja tanpa versi (seperti persyaratan anggaran kampanye Peningkat Permintaan baru) dilacak secara terpisah.

Untuk memeriksa siklus proses fitur mendatang dan perubahan perilaku di seluruh versi aktif, lihat panduan Penghentian penggunaan fitur dan perubahan tanpa versi.