Google Ads API mempertahankan beberapa versi utama yang aktif kapan saja, dan suatu versi hanya dianggap tidak digunakan lagi jika ditandai secara eksplisit sebagai tidak digunakan lagi. Kami memublikasikan tanggal rilis dan penghentian lebih awal untuk membantu Anda merencanakan upgrade. Setelah tanggal penghentian versi, versi tersebut tidak lagi tersedia. Berikut beberapa panduan pembuatan versi utama yang perlu diingat:
- Kami berupaya untuk menyediakan maksimal lima versi utama pada satu waktu.
- Versi utama memiliki masa pakai sekitar 12 bulan. Masa aktif versi API minor tidak dilacak secara terpisah. Sebagai gantinya, versi minor memiliki tanggal penghentian yang sama dengan versi utama yang sesuai.
- Setiap versi minor mengupdate versi utama yang sesuai secara bertahap.
- Semua panggilan API ke versi utama tertentu selalu mengarah ke versi minor terbaru yang sesuai. Google Ads API tidak mendukung pemanggilan versi minor tertentu.
- 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).
- Jika Anda baru menggunakan Google Ads API, sebaiknya mulai dengan v26.
Library klien kami mendukung semua versi layanan yang tersedia, sehingga Anda dapat mengupgrade secara bertahap dengan menentukan versi layanan yang digunakan yang berbeda.
Jadwal
Tabel berikut mencantumkan tanggal rilis dan penghentian untuk setiap versi yang tersedia, serta tanggal rilis yang diproyeksikan untuk versi mendatang. Sebaiknya upgrade ke versi terbaru secepat mungkin setelah 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 |
| v26.1 | 28 Oktober 2026 | November 2027 | Tidak ada (rilis minor) | Fitur dan update v26.1 | Perbedaan proto v25 versus v26 |
| v26.2 | 11 November 2026 | November 2027 | Tidak ada (rilis minor) | Fitur dan update v26.2 | Perbedaan proto v25 versus v26 |
| Versi mendatang | |||||
| 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 | Suatu versi dianggap tidak digunakan lagi hanya jika versi tersebut ditandai secara eksplisit sebagai tidak digunakan lagi. Google Ads API memiliki beberapa versi utama yang aktif kapan saja. | 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 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 secepatnya agar dapat menggunakan Google Ads API.
Kami sangat menyarankan agar Anda mengupgrade ke versi terbaru, menggunakan panduan upgrade. |
| Waktu | Tanggal penghentian dipublikasikan terlebih dahulu, dan suatu versi dianggap tidak digunakan lagi hanya jika ditandai secara eksplisit sebagai tidak digunakan lagi. | 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 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 reguler 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.