Penghentian penggunaan dan penghentian

Dengan rilis versi baru, versi yang tidak digunakan lagi akan diberi tanggal penghentian, dan setelahnya versi tersebut tidak akan lagi tersedia. Berikut beberapa panduan lain yang perlu diperhatikan:

  • Maksimal, tiga versi utama tersedia pada 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 perlu mengupgrade dalam urutan berurutan yang ketat—misalnya, Anda dapat mengupgrade dari versi (N) langsung ke versi (N+2).
  • Tumpang-tindih antara tanggal saat semua library klien dirilis untuk versi terbaru dan versi yang akan dihentikan setidaknya 20 minggu.

Library klien kami mendukung semua versi layanan yang tersedia, sehingga Anda dapat melakukan upgrade secara bertahap dengan menentukan versi layanan yang digunakan yang berbeda.

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 sesegera mungkin setelah rilis.

Versi API Tanggal rilis Tanggal penghentian Tanggal penghentian Panduan upgrade
v18 16 Oktober 2024 Februari 2025 24 September 2025
v17.1 7 Agustus 2024 16 Oktober 2024 4 Juni 2025 Mengupgrade dari v17 ke v18
v17 5 Juni 2024 16 Oktober 2024 4 Juni 2025 Mengupgrade dari v17 ke v18
v16.1 24 April 2024 5 Juni 2024 5 Februari 2025 Mengupgrade dari v16 ke v17
v16 21 Februari 2024 5 Juni 2024 5 Februari 2025 Mengupgrade dari v16 ke v17

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 di tabel.
  3. Di subtab METRICS, Anda akan melihat permintaan terbaru diplot pada setiap grafik. Anda dapat melihat metode yang telah Anda kirimkan permintaan di tabel Methods. Nama metode menyertakan versi Google Ads API, layanan, dan nama metode, seperti google.ads.googleads.v18.services.GoogleAdsService.Mutate.
  4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian dan penghentian total

IstilahStatus penghentian penggunaanSenja
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 lagi untuk menunjukkan bahwa versi tersebut bukan versi terbaru lagi.

Sebaiknya upgrade ke versi terbaru sesegera mungkin untuk mendapatkan manfaat dari fitur baru.

 Anda harus segera mengupgrade dari versi yang dihentikan untuk menggunakan Google Ads API.

Sebaiknya upgrade ke versi terbaru menggunakan panduan upgrade.
Waktu Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, sehingga versi tertentu tidak akan digunakan lagi 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, REST, dan sebagainya; 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 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 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 menunjukkan library klien yang berfungsi dengan versi API tertentu.

Java

Library klien untuk Java
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -

C#

Library klien untuk .NET
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -

PHP

Library klien untuk PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Library klien untuk Python
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Library klien untuk Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Library klien untuk Perl
v18 Min: 25.0.0
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

Penghentian penggunaan fitur

Pantau blog developer Google Ads secara rutin agar Anda menjadi yang pertama mengetahui penghentian fitur mendatang.

Tabel berikut mencantumkan penghentian penggunaan fitur tertentu yang direncanakan untuk Google Ads API. Detail selengkapnya untuk setiap penghentian dapat ditemukan di postingan blog tertaut.

Fitur Deskripsi Tanggal efektif Catatan tambahan
Perubahan mendatang pada ukuran halaman di Google Ads API Saat v16 dihentikan, Anda tidak akan dapat lagi menetapkan kolom page_size saat membuat permintaan GoogleAdsService.Search. Februari 2025 Saat v16 dihentikan, semua permintaan GoogleAdsService.Search akan mengasumsikan ukuran halaman tetap sebesar 10.000 baris.
Strategi bidding Enhanced CPC Google Ads API tidak lagi mendukung penetapan eCPC sebagai strategi bidding untuk kampanye Penelusuran dan Display. Oktober 2024 Permintaan untuk menetapkan kolom enhanced_cpc_enabled ke TRUE dalam strategi bidding akan menghasilkan error BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Kampanye yang ada dengan strategi bidding eCPC akan terus berjalan hingga 15 Maret 2025. Setelah tanggal ini, kampanye tersebut akan otomatis dimigrasikan ke Biaya Per Klik (CPC) Manual.