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 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 | Panduan upgrade |
|---|---|---|---|
| Versi rilis | |||
| v22 | 15 Oktober 2025 | Oktober 2026 | Mengupgrade dari v21 ke v22 |
| v23 | 28 Januari 2026 | Februari 2027 | Mengupgrade 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 | Mengupgrade 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 | Mengupgrade 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 | Mengupgrade dari v25.1 ke v25.2 |
| Versi mendatang | |||
| v26 | Oktober 2026 | November 2027 | |
| 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 bertepatan 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 Anda kirimi permintaan di tabel
Metode. Nama metode mencakup versi Google Ads API, layanan,
dan nama metode, seperti
google.ads.googleads.v25.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 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 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 memanfaatkan 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 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 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 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 minor, lihat Log perubahan yang ditautkan.
Java
Google Ads API |
Library klien untuk Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
Library klien untuk .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
Library klien untuk PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Library klien untuk Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Library klien untuk Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Library klien untuk Perl |
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.