Dengan dirilisnya versi baru, versi yang tidak digunakan lagi akan diberi tanggal penghentian, setelah itu versi tersebut tidak lagi tersedia. Berikut beberapa panduan lainnya yang perlu diperhatikan:
- Maksimal tiga versi utama tersedia dalam satu waktu.
- Versi utama memiliki masa aktif sekitar 12 bulan—versi minor: 10 bulan.
- Anda harus melakukan maksimal dua upgrade per tahun, dan tidak perlu melakukan upgrade dalam urutan yang ketat dan berurutan—misalnya, Anda dapat melakukan upgrade dari versi (N) langsung ke versi (N+2).
- Tumpang tindih antara tanggal rilis semua library klien untuk versi terbaru dan versi yang akan dihentikan setidaknya 20 minggu.
Library klien kami mendukung versi layanan yang tersedia, sehingga Anda dapat melakukan upgrade secara bertahap dengan menentukan berbagai versi layanan yang digunakan.
Jadwal
Tabel di bawah mencantumkan tanggal spesifik penghentian penggunaan dan penghentian untuk setiap versi yang tersedia, serta proyeksi tanggal rilis untuk versi mendatang. Sebaiknya Anda mengupgrade ke versi terbaru secepat mungkin setelah dirilis.
Versi API | Tanggal rilis | Tanggal penghentian | Tanggal penghentian | Panduan upgrade |
---|---|---|---|---|
v18 | Sep/Okt 2024 | Jan/Feb 2025 | September 2025 | |
v17.1 | Juli/Agu 2024 | Sep/Okt 2024 | Mei 2025 | |
v17 | Mei/Jun 2024 | Sep/Okt 2024 | Mei 2025 | |
v16.1 | 24 April 2024 | Mei/Jun 2024 | Januari 2025 | |
v16 | 21 Februari 2024 | Mei/Jun 2024 | Januari 2025 | |
v15 | 18 Oktober 2023 | 21 Februari 2024 | 25 September 2024 | Mengupgrade dari v15 ke v16 |
v14.1 | 9 Agustus 2023 | 18 Oktober 2023 | 5 Juni 2024 | |
v14 | 7 Juni 2023 | 18 Oktober 2023 | 5 Juni 2024 | Mengupgrade dari v14 ke v15 |
Melihat versi yang digunakan project Anda
Anda dapat melihat daftar metode dan layanan yang baru-baru ini dipanggil project Anda menggunakan Google Cloud Console:
- Buka APIs & Services di Google Cloud Console.
- Klik Google Ads API pada tabel.
- Pada subtab METRIK, Anda akan melihat permintaan terbaru yang dipetakan pada setiap grafik. Anda dapat melihat metode yang telah Anda kirim permintaannya di tabel Methods. Nama metode berisi versi Google Ads API, layanan, dan nama metode, seperti
google.ads.googleads.v16.services.GoogleAdsService.Mutate
. - (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.
Perbedaan antara penghentian penggunaan dan penghentian
Masa Berlaku | 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 tetap dapat menggunakan versi yang tidak digunakan lagi sampai versi tersebut sudah dihentikan,
tetapi referensi versi yang tidak digunakan lagi akan dihapus sorotannya untuk menunjukkan
bahwa versi tersebut bukan lagi versi terbaru.
Sebaiknya Anda segera melakukan upgrade ke versi terbaru agar dapat memanfaatkan fitur-fitur baru. |
Anda harus segera mengupgrade dari versi yang dihentikan 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 yang diberikan tidak akan digunakan lagi setelah sekitar 3 hingga 4 bulan. | Kami berencana 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, REST, dan sebagainya; tetapi, fitur baru tidak ditambahkan ke versi yang tidak digunakan lagi. |
Endpoint API untuk versi penghentian akan 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 penggunaan. Hal ini membantu menghemat ruang saat Anda menyertakan library klien kami dalam project. | Library klien tidak lagi mendukung versi API penghentian di versi library klien baru setelah tanggal penghentian. |
Dukungan | Kami memberikan dukungan rutin untuk versi yang tidak digunakan lagi. | Versi penghentian tidak lagi didukung setelah tanggal penghentian. |
Versi library klien yang didukung
Tabel ini menunjukkan library klien mana yang berfungsi dengan versi API tertentu.
Java
Google Ads API |
Library klien untuk Java |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
Library klien untuk .NET |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
Library klien untuk PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
Library klien untuk Python |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
Library klien untuk Ruby |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
Library klien untuk Perl |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: 21.0.0 |
Penghentian penggunaan fitur
Pantau blog developer Google Ads secara rutin untuk menjadi yang pertama mengetahui penghentian fitur yang akan datang.
Tabel di bawah mencantumkan penghentian fitur spesifik yang saat ini direncanakan untuk Google Ads API. Detail selengkapnya untuk setiap penghentian penggunaan dapat ditemukan di postingan blog yang ditautkan.
Fitur | Deskripsi | Tanggal efektif | Catatan tambahan |
---|---|---|---|
Strategi Bidding Komisi |
Google Ads API
tidak lagi mendukung pembuatan kampanye Hotel dengan COMMISSION
strategi bidding
.
|
30 April 2024 |
Permintaan untuk membuat kampanye Hotel baru atau menerapkan strategi bidding COMMISSION ke kampanye yang ada akan menyebabkan error BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Kampanye yang sudah ada dengan strategi bidding COMMISSION
akan terus berjalan hingga 31 Oktober 2024. Setelah hari ini,
kampanye akan berhenti ditayangkan hingga strategi biddingnya diperbarui.
|