Dengan rilis versi baru, versi yang tidak digunakan lagi diberi tanggal berakhir, dan setelahnya versi tersebut tidak lagi tersedia. Berikut beberapa panduan lain yang perlu diperhatikan:
- Kami berupaya untuk menyediakan maksimal lima versi utama pada satu waktu.
- Versi utama memiliki masa aktif sekitar 12 bulan—versi minor: 10 bulan.
- Anda harus melakukan maksimum dua upgrade per tahun, dan Anda tidak perlu melakukan upgrade dalam urutan yang ketat — misalnya, Anda dapat mengupgrade dari versi (N) langsung ke versi (N+2).
Library klien kami mendukung versi layanan apa pun yang tersedia, sehingga Anda dapat mengupgrade secara bertahap dengan menentukan versi layanan yang digunakan yang berbeda.
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 tanggalnya dapat berubah. Berlanggananlah ke blog untuk mendapatkan pengingat pengumuman penghentian versi API.
| Versi API | Tanggal rilis | Tanggal penghentian | Perubahan yang dapat menyebabkan gangguan & upgrade | Fitur dan info terbaru | Tabel perbedaan proto |
|---|---|---|---|---|---|
| Versi rilis | |||||
| v23 | 28 Januari 2026 | Februari 2027 | Perubahan yang dapat menyebabkan gangguan pada v23 (panduan upgrade) | Fitur dan update v23 | Perbedaan proto v22 versus v23 |
| v23.1 | 25 Februari 2026 | Februari 2027 | Tidak ada (rilis minor) | Fitur dan update v23.1 | Perbedaan proto v22 versus v23 |
| v23.2 | 25 Maret 2025 | Februari 2027 | Tidak ada (rilis minor) | Fitur dan update v23.2 | Perbedaan proto v22 versus v23 |
| v23.3 | 24 Juni 2026 | Februari 2027 | Tidak ada (rilis minor) | Fitur dan update v23.3 | Perbedaan proto v22 versus v23 |
| v24 | 22 April 2026 | Mei 2027 | Perubahan yang dapat menyebabkan gangguan pada v24 (panduan upgrade) | Fitur dan update v24 | Perbedaan proto v23 versus v24 |
| v24.1 | 13 Mei 2026 | Mei 2027 | Tidak ada (rilis minor) | Fitur dan update v24.1 | Perbedaan proto v23 versus v24 |
| v24.2 | 24 Juni 2026 | Juni 2027 | Tidak ada (rilis minor) | Fitur dan update v24.2 | Perbedaan proto v23 versus v24 |
| v25 | 22 Juli 2026 | Agustus 2027 | Perubahan yang dapat menyebabkan gangguan pada v25 (panduan upgrade) | Fitur dan update v25 | Perbedaan proto v24 versus v25 |
| v25.1 | 19 Agustus 2026 | Agustus 2027 | Tidak ada (rilis minor) | Fitur dan update v25.1 | Perbedaan proto v24 versus v25 |
| v25.2 | 23 September 2026 | Agustus 2027 | Tidak ada (rilis minor) | Fitur dan update v25.2 | Perbedaan proto v24 versus v25 |
| v26 (Terbaru) | 14 Oktober 2026 | November 2027 | Perubahan yang dapat menyebabkan gangguan pada v26 (panduan upgrade) | Fitur dan update v26 | Perbedaan proto v25 versus v26 |
| Versi mendatang | |||||
| v26.1 | Oktober 2026 | November 2027 | |||
| v26.2 | November 2026 | November 2027 | |||
| v26.3* | December 2026 | November 2027 | |||
| v27 | Januari 2027 | Februari 2028 | |||
| v27.1 | Februari 2027 | Februari 2028 | |||
| v27.2 | Februari 2027 | Februari 2028 | |||
| v27.3 | Maret 2027 | Februari 2028 | |||
| v27.4 | Maret 2027 | Februari 2028 | |||
| v28 | April 2027 | Mei 2028 | |||
| v28.1 | April 2027 | Mei 2028 | |||
| v28.2 | Mei 2027 | Mei 2028 | |||
| v28.3 | Mei 2027 | Mei 2028 | |||
| v28.4 | Juni 2027 | Mei 2028 | |||
| v28.5 | Juni 2027 | Mei 2028 | |||
| v29 | Juli 2027 | Agustus 2028 | |||
| v29.1 | Juli 2027 | Agustus 2028 | |||
| v29.2 | Agustus 2027 | Agustus 2028 | |||
| v29.3 | Agustus 2027 | Agustus 2028 | |||
| v29.4 | September 2027 | Agustus 2028 | |||
| v29.5 | September 2027 | Agustus 2028 | |||
| v30 | Oktober 2027 | November 2028 | |||
| v30.1 | Oktober 2027 | November 2028 | |||
| v30.2 | November 2027 | November 2028 | |||
| v30.3* | Desember 2027 | November 2028 | |||
* v26.3 dan v30.3 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 oleh project Anda menggunakan Konsol Google Cloud:
- Buka APIs & Services di Konsol Google Cloud.
- Klik Google Ads API di tabel.
- Di subtab METRICS, Anda akan melihat permintaan terbaru yang diplot pada
setiap grafik. Anda dapat melihat metode yang telah Anda kirimi permintaan di tabel Metode. Nama metode mencakup versi Google Ads API, layanan,
dan nama metode, seperti
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - (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 dihentikan,
tetapi referensi versi yang tidak digunakan lagi tidak akan ditandai untuk menunjukkan
bahwa versi tersebut bukan lagi versi terbaru.
Sebaiknya Anda mengupgrade ke versi terbaru sesegera mungkin untuk memanfaatkan fitur baru. |
Anda harus segera mengupgrade dari versi yang tidak digunakan lagi
agar dapat menggunakan Google Ads API.
Kami sangat menyarankan Anda untuk mengupgrade ke versi terbaru, menggunakan panduan upgrade. |
| Waktu | Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, sehingga versi tertentu akan dihentikan penggunaannya setelah sekitar 3 hingga 4 bulan. | Kami berencana menghentikan penggunaan 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 kami. Namun, fitur baru tidak ditambahkan ke versi yang tidak digunakan lagi. |
Endpoint API untuk versi yang dihentikan akan berhenti berfungsi setelah tanggal penghentian. Google Ads API akan menampilkan error jika Anda mencoba mengakses endpoint API versi yang tidak digunakan lagi. |
| 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.
Versi library klien minimum yang tercantum sudah cukup untuk rilis utama Google Ads API (seperti v26). Untuk melihat versi library klien yang diperlukan untuk rilis minor, lihat Log perubahan yang ditautkan.
Java
Google Ads API |
Library klien untuk Java |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
Library klien untuk .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
Library klien untuk PHP |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Library klien untuk Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Library klien untuk Ruby |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Library klien untuk Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
Penghentian penggunaan dan perubahan fitur
Meskipun halaman ini berfokus pada siklus proses tingkat versi API, penghentian fitur individual (seperti penghentian 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 fitur dan perubahan tanpa versi.