Penghentian penggunaan dan penghentian

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

  • Maksimal, tiga versi utama tersedia dalam satu waktu.
  • Versi utama memiliki masa pakai sekitar 12 bulan—versi minor: 10 bulan.
  • Anda harus melakukan maksimal dua upgrade per tahun, dan Anda tidak memiliki untuk meningkatkan versi dalam urutan yang ketat—misalnya, Anda dapat meningkatkan dari versi (N) langsung ke versi (N+2).
  • Tumpang tindih antara tanggal ketika semua library klien dirilis untuk versi terbaru dan versi yang akan dihentikan setidaknya 20 minggu.

Library klien kami mendukung semua versi sehingga Anda dapat secara bertahap meningkatkan versi dengan menentukan versi berbeda layanan IT perusahaan mereka.

Jadwal

Tabel di bawah mencantumkan tanggal penghentian spesifik untuk masing-masing versi yang tersedia, dan proyeksi tanggal rilis untuk versi mendatang. Rab mendorong Anda untuk meningkatkan ke versi terbaru sesegera mungkin setelah data.

Versi API Tanggal rilis Tanggal penghentian Tanggal matahari terbenam Panduan upgrade
v18 Sep/Okt 2024 Jan/Feb 2025 September 2025
v17.1 7 Agustus 2024 Sep/Okt 2024 Mei 2025
v17 5 Juni 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 Mengupgrade dari v16 ke v17
v15 18 Oktober 2023 21 Februari 2024 25 September 2024 Mengupgrade dari v15 ke v16

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:

  1. Buka API API & Layanan Google Cloud di Konsol Google Cloud.
  2. Klik Google Ads API di tabel.
  3. Pada subtab METRICS, Anda akan melihat permintaan terbaru yang dipetakan di setiap grafik. Anda dapat melihat metode mana yang telah Anda kirim permintaannya di Methods. Nama metode mencakup versi Google Ads API, layanan, dan nama metode, seperti google.ads.googleads.v17.services.GoogleAdsService.Mutate.
  4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian penggunaan dan matahari terbenam

IstilahStatus penghentian penggunaanSenja
Definisi Versi yang tidak digunakan lagi adalah versi yang bukan versi terbaru. Setelah versi baru dirilis, semua versi sebelumnya akan ditandai tidak digunakan lagi. Versi yang dihentikan tidak dapat digunakan lagi. Permintaan dikirim ke alamat ini versi tersebut 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 dihapus sorotan untuk menunjukkan bahwa mereka bukan versi terbaru lagi.

Sebaiknya upgrade ke versi terbaru sesegera mungkin untuk memanfaatkan fitur-fitur baru.

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

Kami sangat menyarankan Anda meningkatkan versi ke versi terbaru versi baru, menggunakan panduan peningkatan versi.

Waktu Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, jadi yang diberikan versi tidak akan digunakan lagi setelah sekitar 3 hingga 4 bulan. Kami berencana menghentikan versi 1 tahun setelah dirilis.
API Endpoint API untuk versi yang tidak digunakan lagi masih berfungsi sebagai seperti biasa.

Anda dapat mengakses endpoint API menggunakan library klien, REST, dan sebagainya nyala; 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 dari versi yang dihentikan.
Library klien Untuk tujuan menyediakan library klien yang ringkas, kami akan menghentikan termasuk versi API yang tidak digunakan lagi dalam versi library klien baru setelah tanggal penghentian penggunaan. Hal ini membantu Anda menghemat ruang saat menggabungkan {i>library<i} klien kita dalam proyek Anda. Library klien tidak lagi mendukung versi API yang dihentikan di semua versi {i>library<i} klien baru setelah tanggal penghentian.
Dukungan Kami memberikan dukungan rutin untuk versi yang tidak digunakan lagi. Versi yang dihentikan tidak lagi didukung setelah penghentian tanggal.

Versi library klien yang didukung

Tabel ini menunjukkan library klien mana yang berfungsi dengan versi API tertentu.

Java

Library klien untuk Java
v17
32.0.0 Min: Max: -
v16
30.0.0 Min: Max: -
v15 Min: 28.0.0
Max: 32.0.0

C#

Library klien untuk .NET
v17
20.1.0 Min: Max: -
v16
18.1.0 Min: Max: -
v15 Min: 17.1.0
Max: 20.1.0

PHP

Library klien untuk PHP
v17
23.1.0 Min: Max: -
v16
22.1.0 Min: Max: -
v15 Min: 21.1.0
Max: 23.1.0

Python

Library klien untuk Python
v17
24.1.0 Min: Max: -
v16
23.1.0 Min: Max: -
v15
22.1.0 Min: Max: -

Ruby

Library klien untuk Ruby
v17
29.0.0 Min: Max: -
v16
27.0.0 Min: Max: -
v15
25.0.0 Min: Max: -

Perl

Library klien untuk Perl
v17
23.0.0 Min: Max: -
v16
21.0.0 Min: Max: -
v15
19.0.0 Min: Max: -

Penghentian penggunaan fitur

Pantau secara rutin blog developer Google Ads menjadi yang pertama mendengar tentang penghentian fitur mendatang.

Tabel di bawah mencantumkan penghentian fitur spesifik yang saat ini yang 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 COMMISSION strategi bidding ke kampanye yang ada akan menghasilkan BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED {i>error<i}. Kampanye yang ada dengan bidding COMMISSION strategi ini akan terus berjalan hingga 31 Oktober 2024. Setelah hari ini kampanye akan berhenti ditayangkan sampai strategi biddingnya diperbarui.