Penghentian penggunaan dan penghentian

Dengan rilis versi baru, versi yang tidak digunakan lagi diberi tanggal penghentian, setelah itu versi tersebut tidak akan tersedia lagi. 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 tidak perlu melakukan upgrade dengan urutan yang ketat. Misalnya, Anda dapat melakukan upgrade 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 berbagai versi layanan yang digunakan.

Jadwal

Tabel di bawah mencantumkan tanggal penghentian spesifik untuk setiap versi yang tersedia, dan tanggal rilis yang diproyeksikan untuk versi mendatang. Sebaiknya Anda melakukan upgrade ke versi terbaru secepat mungkin setelah dirilis.

Versi API Tanggal rilis Tanggal penghentian Tanggal matahari terbenam 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 oleh project Anda menggunakan Konsol Google Cloud:

  1. Buka APIs & Services di Konsol Google Cloud.
  2. Klik Google Ads API di tabel.
  3. Pada subtab METRIK, Anda akan melihat permintaan terbaru yang dipetakan di 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.v17.services.GoogleAdsService.Mutate.
  4. (Opsional) Pilih jangka waktu yang ingin Anda lihat untuk permintaan Anda.

Perbedaan antara penghentian penggunaan dan matahari terbenam

Masa BerlakuStatus 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 ditandai untuk menunjukkan bahwa versi tersebut bukan versi terbaru lagi.

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

Anda harus segera melakukan upgrade dari versi yang dihentikan agar dapat menggunakan Google Ads API.

Kami sangat merekomendasikan Anda melakukan upgrade ke versi terbaru menggunakan panduan upgrade.

Waktu Rata-rata, kami merilis versi baru setiap 3 hingga 4 bulan, sehingga versi tersebut 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 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 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. Hal ini membantu Anda menghemat ruang saat menerapkan 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 berfungsi dengan versi API tertentu.

Java

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#

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

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

Python

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

Ruby

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

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 menerima kabar tentang penghentian fitur yang akan datang.

Tabel di bawah mencantumkan penghentian fitur tertentu 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 strategi bidding COMMISSION . 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.