Penghentian penggunaan dan penghentian

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 lima 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).

Library klien kami mendukung semua versi layanan yang tersedia, sehingga Anda dapat melakukan upgrade secara bertahap dengan menentukan berbagai 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 blog untuk mendapatkan pengingat pengumuman penghentian versi API.

Versi APITanggal rilisTanggal penghentianPanduan upgrade
Versi yang dirilis
v2215 Oktober 2025Oktober 2026 (tentatif)Upgrade dari v21 ke v22
v2328 Januari 2026Februari 2027Mengupgrade dari v22 ke v23
v23.1 25 Februari 2026 Februari 2027 Mengupgrade dari v23 ke v23.1
v23.2 25 Maret 2025 Februari 2027 Mengupgrade 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 Mengupgrade dari v24 ke v24.1
v24.2 24 Juni 2026 Juni 2027 Upgrade dari v24.1 ke v24.2
v25 22 Juli 2026 Agustus 2027 Upgrade dari v24.2 ke v25
v25.1 19 Agustus 2026 Agustus 2027 Mengupgrade dari v25 ke v25.1
v25.2 23 September 2026 Agustus 2027 Upgrade dari v25.1 ke v25.2
Versi mendatang
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 dalam tabel.
  3. Di subtab METRIK, Anda akan melihat permintaan terbaru yang diplot pada setiap grafik. Anda dapat melihat metode yang Anda gunakan untuk mengirim permintaan di tabel Metode. Nama metode mencakup versi Google Ads API, layanan, dan nama metode, seperti google.ads.googleads.v25.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 melakukan upgrade ke versi terbaru sesegera mungkin untuk mendapatkan manfaat dari fitur baru.

 Anda harus mengupgrade dari versi yang dihentikan segera agar dapat 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 dan REST kami. 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 kompatibel dengan versi API tertentu.

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

Java

Log perubahan

Library klien untuk Java
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -

C#

Log perubahan

Library klien untuk .NET
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -

PHP

Log perubahan

Library klien untuk PHP
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -

Python

Log perubahan

Library klien untuk Python
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: 32.0.0

Ruby

Log perubahan

Library klien untuk Ruby
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -

Perl

Log perubahan

Library klien untuk Perl
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -

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.