Mengumumkan Penghentian

Halaman ini mencantumkan tanggal penghentian penggunaan dan penghentian untuk versi API dan fitur individual di Display & Video 360 API.

Penghentian penggunaan dan tanggal penghentian untuk API juga akan diumumkan di blog developer Google Ads.

Penghentian Versi

Versi Display & Video 360 API dirilis, dihentikan, dan dihentikan secara rutin. Langkah-langkah ini didefinisikan sebagai berikut:

• Rilis: Versi keluar dari status alfa atau beta dan dianggap stabil. Penambahan fitur mungkin masih dirilis untuk versi tersebut.
• Penghentian penggunaan: Versi ini akan dihentikan dan tanggal akhir dukungan (penghentian) akan diumumkan. Pengguna harus bermigrasi ke versi yang lebih baru sebelum tanggal penghentian. Penambahan fitur tidak akan lagi dirilis untuk versi tersebut.
• Dihentikan: Versi ini tidak lagi didukung. Permintaan yang dibuat ke versi tersebut akan menampilkan error.

Tabel ini mencantumkan semua versi inti Display & Video 360 API yang ada, tanggal rilisnya, serta tanggal penghentian penggunaan dan penghentiannya, jika diumumkan.

Versi API	Tanggal Rilis	Tanggal Penghentian	Tanggal Penghentian	Panduan Migrasi
v4	27 Maret 2025
v3	31 Oktober 2023	2 April 2025	7 Oktober 2025	Bermigrasi dari v3 ke v4
v2	6 Desember 2022	15 Februari 2024	3 September 2024	Bermigrasi dari v2 ke v3
v1	9 Maret 2020	13 Maret 2023	14 September 2023	Bermigrasi dari v1 ke v2

Penghentian Penggunaan Fitur

Ikuti blog developer Google Ads kami untuk mengetahui pengumuman penghentian penggunaan fitur penting mendatang.

Tabel ini mencantumkan semua penghentian fitur yang diumumkan yang memengaruhi versi aktif, yang memberikan tanggal mulai berlaku awal dan deskripsi penghentian dengan tindakan yang disarankan dan link ke dokumentasi yang relevan:

Fitur	Tanggal Mulai Berlaku Awal	Deskripsi
Nilai nama dan logo bisnis diperlukan untuk iklan responsif YouTube Tanggal Mulai Berlaku Awal diperbarui	Januari 2027	Pada Januari 2027, aset nama dan logo bisnis akan diwajibkan untuk iklan responsif YouTube jika nilai default tidak ditetapkan untuk pengiklan. Akibatnya, kolom Business Name dan Logo Asset IDs di SDF Iklan harus ditetapkan untuk iklan jenis "Responsif" jika nilai default tidak ditetapkan ke pengiklan induk. Jika nilai default ditetapkan dan kolom dibiarkan kosong, iklan akan mewarisi nilai default tingkat pengiklan setelah disimpan.
Penghentian penggunaan pengecualian kategori sensitif	1 Oktober 2026	Mulai 1 Oktober 2026, Anda tidak dapat lagi mengecualikan sebagian besar kategori sensitif saat menetapkan penargetan item baris. Untuk mengakomodasi perubahan ini, perubahan berikut akan dilakukan pada Display & Video 360 API dan File Data Terstruktur: Nilai enum SensitiveCategory berikut akan dihentikan dan tidak lagi diterima di kolom excludedSensitiveCategory pada objek SensitiveCategoryAssignedTargetingOptionDetails saat menetapkan penargetan jenis TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_ADULT SENSITIVE_CATEGORY_ALCOHOL SENSITIVE_CATEGORY_DEROGATORY SENSITIVE_CATEGORY_DOWNLOADS_SHARING SENSITIVE_CATEGORY_DRUGS SENSITIVE_CATEGORY_GAMBLING SENSITIVE_CATEGORY_POLITICS SENSITIVE_CATEGORY_PROFANITY SENSITIVE_CATEGORY_RELIGION SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES SENSITIVE_CATEGORY_SHOCKING SENSITIVE_CATEGORY_SUGGESTIVE SENSITIVE_CATEGORY_TOBACCO SENSITIVE_CATEGORY_TRAGEDY SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS SENSITIVE_CATEGORY_VIOLENCE SENSITIVE_CATEGORY_WEAPONS Kolom Brand Safety Sensitivity Setting di SDF Item Baris tidak akan lagi mengizinkan opsi "Gunakan kustom". Kolom Brand Safety Custom Settings di SDF Item Baris tidak akan didukung lagi dan akan diisi dengan nilai kosong saat didownload.
Penghentian pengecualian label konten digital	1 Oktober 2026	Mulai 1 Oktober 2026, Anda tidak akan dapat lagi mengecualikan label konten digital tertentu menggunakan penargetan. Untuk mengakomodasi perubahan ini, perubahan berikut akan dilakukan pada Display & Video 360 API dan File Data Terstruktur: Nilai enum ContentRatingTier berikut akan dihentikan dan tidak lagi diterima di kolom excludedContentRatingTier pada objek DigitalContentLabelAssignedTargetingOptionDetails saat menetapkan penargetan jenis TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_FAMILIES CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_UNSPECIFIED Kolom Digital Content Labels - Exclude di SDF Item Baris hanya akan mengizinkan penetapan opsi "?", jika tidak, kolom tersebut harus kosong. Upaya untuk menetapkan nilai lain akan menghasilkan error saat upload.
Nielsen sebagai vendor pihak ketiga yang mengukur Brand Lift	13 Juli 2026	Mulai 13 Juli 2026, Nielsen tidak dapat lagi ditetapkan sebagai vendor pihak ketiga untuk mengukur brand lift. Untuk mengakomodasi perubahan ini, perubahan berikut akan dilakukan pada Display & Video 360 API dan File Data Terstruktur: Nilai enum ThirdPartyVendor THIRD_PARTY_VENDOR_NIELSEN tidak akan lagi diterima di resource LineItem di bawah kolom objek ThirdPartyMeasurementConfigs brandLiftVendorConfigs.vendor. Kolom TrueView Third-Party Brand Lift Vendor di SDF Item Baris tidak akan lagi mengizinkan opsi "Nielsen". Penggunaan Nielsen sebagai vendor brand lift yang ada akan dihapus. Untuk menghindari gangguan layanan, hapus penetapan Nielsen sebagai vendor brand lift dari integrasi Anda.
Pewarisan nama dan logo bisnis default	13 Juli 2026	Mulai 13 Juli 2026, iklan responsif YouTube akan mulai mendukung aset nama dan logo bisnis, dan semua iklan responsif YouTube dan Peningkat Permintaan yang tidak memiliki aset nama dan logo bisnis akan mewarisi nilai default yang ditetapkan di tingkat pengiklan. Pada saat yang sama, perubahan ini akan menyebabkan perubahan berikut pada perilaku Display & Video 360 API dan File Data Terstruktur: Kolom businessName, logo, dan logoImages di resource AdGroupAd Peningkat Permintaan ad_details tidak akan diperlukan lagi jika nilai default ditetapkan ke pengiklan induk. Jika tidak diberikan, iklan akan mewarisi setelan default tingkat pengiklan. Kolom Business Name dan Logo Asset IDs di SDF Iklan akan dapat ditetapkan untuk iklan dengan salah satu jenis berikut: "Responsif", "Produk Peningkat Permintaan", "Video Peningkat Permintaan", "Gambar Peningkat Permintaan", dan "Carousel Peningkat Permintaan". Jika kolom ini tidak ditetapkan untuk entri iklan yang relevan, dan nilai default ditetapkan ke pengiklan induk, iklan akan mewarisi nilai default tingkat pengiklan setelah disimpan. Kolom Business Name dan Logo Asset IDs di SDF Iklan tidak lagi diperlukan untuk iklan Peningkat Permintaan jika pengiklan induknya telah menetapkan nilai default. Jika nilai default ditetapkan di tingkat pengiklan, semua iklan di pengiklan tersebut akan memiliki nilai nama dan logo bisnis yang ditetapkan. Jika Anda tidak ingin menetapkan nilai aset nama dan logo bisnis untuk iklan responsif YouTube, jangan tetapkan nilai default untuk pengiklan Anda.
Pengelolaan penargetan pesanan pemasangan iklan dan kampanye di Display & Video 360 API dan File Data Terstruktur	23 Februari 2026	Pada 23 Februari 2026, Display & Video 360 akan menghentikan penargetan pesanan pemasangan iklan dan kampanye. Perubahan akan dilakukan pada Display & Video 360 API dan File Data Terstruktur (SDF) agar selaras dengan perubahan ini. Di Display & Video 360 API, sebagian metode akan dihentikan dan menampilkan error jika dipanggil. Di SDF, kolom penargetan dalam file Perjanjian Pemasangan Iklan dan Kampanye tidak akan lagi diisi saat didownload dan harus kosong saat diupload. Sebaiknya pengguna menetapkan penargetan langsung ke item baris saat pembuatan item baris. Metode Display & Video 360 API berikut akan menampilkan error 404 jika dipanggil: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault Entri SDF Kampanye yang memiliki nilai yang ditetapkan ke kolom berikut akan gagal saat diupload: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting Entri SDF Pesanan Pemasangan Iklan yang memiliki nilai yang ditetapkan ke kolom berikut akan gagal saat diupload: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
Menyatakan apakah item baris menayangkan iklan politik Uni Eropa	8 September 2025	Mulai 8 September 2025, Anda akan diwajibkan untuk menyatakan apakah item baris akan menayangkan iklan politik Uni Eropa atau tidak saat membuat item baris baru menggunakan Display & Video 360 API atau SDF. Pernyataan ini dapat dibuat dengan cara berikut: Menggunakan kolom containsEuPoliticalAds di resource LineItem Display & Video 360 API. Anda juga dapat membuat pernyataan ini menggunakan kolom baru dalam permintaan advertisers.lineItems.duplicate dan advertisers.lineItems.generateDefault. Menggunakan kolom Contains EU Political Ads dalam jenis file Item Baris SDF v9. Jika pengiklan induk Anda tidak akan berisi item baris yang menayangkan iklan politik Uni Eropa, Anda dapat mendeklarasikannya di tingkat pengiklan menggunakan kolom containsEuPoliticalAds di resource Advertiser Display & Video 360 API. Jika kolom ini ditetapkan ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, semua item baris baru di pengiklan akan diberi nilai yang sama jika tidak ditentukan lain dan semua item baris yang ada di pengiklan akan diperbarui untuk menggunakan nilai yang sama jika nilai belum ditetapkan. Pernyataan item baris dapat diperbarui kapan saja setelah dibuat menggunakan UI, API, atau SDF. Jika Anda tidak dapat mendeklarasikan di tingkat pengiklan atau telah mendeklarasikan bahwa iklan politik Uni Eropa dapat ditayangkan di pengiklan Anda, perbarui integrasi Display & Video 360 API dan SDF Anda sebelum 8 September 2025 untuk menghindari gangguan layanan: Tetapkan kolom containsEuPoliticalAds di resource LineItem baru saat membuat permintaan advertisers.lineItems.create. Tetapkan kolom containsEuPoliticalAds di isi permintaan dari setiap permintaan advertisers.lineItems.duplicate dan advertisers.lineItems.generateDefault. Lakukan migrasi untuk menggunakan File Data Terstruktur v9 dan tetapkan kolom Contains EU Political Ads untuk item baris baru ke Yes atau No saat upload. Lihat panduan migrasi v9 kami untuk mengetahui petunjuk langkah demi langkah. Sebelum memperbarui penargetan geografi untuk item baris yang ada menggunakan Display & Video 360 API atau SDF, perbarui item baris untuk memberikan pernyataan.
Setelan Kategori Konten untuk Item Baris YouTube & partner	12 Juni 2025	Pada 12 Juni 2025, konfigurasi kategori konten untuk setiap item baris YouTube & partner tidak akan dapat lagi diubah sebagai bagian dari pembaruan pada pengalaman kesesuaian merek. Sebagai gantinya, setelan kategori konten hanya akan dikontrol di tingkat pengiklan. Untuk mengakomodasi perubahan ini, perubahan berikut akan dilakukan pada Display & Video 360 API dan File Data Terstruktur: Kolom contentCategory di objek YoutubeAndPartnersSettings dari resource LineItem YouTube & partner tidak akan diperbarui lagi. Fitur ini akan dihapus sepenuhnya di lain waktu. Kolom TrueView Content Filter di SDF Item Baris tidak akan dapat ditulis lagi. Agar layanan tidak terganggu: Ambil kolom effectiveContentCategory, bukan kolom contentCategory, saat meninjau item baris YouTube & partner di API. Berhenti mengubah kolom TrueView Content Filter saat memperbarui entri item baris SDF. Biarkan kolom kosong saat membuat item baris baru.
Pembaruan anggaran item baris dengan pengoptimalan pesanan pemasangan iklan	12 Juni 2025	Mulai 12 Juni 2025, Anda tidak akan dapat lagi memperbarui setelan anggaran untuk item baris dengan pesanan pemasangan iklan induk yang ditetapkan untuk dioptimalkan menggunakan strategi bidding otomatis. Untuk menghindari gangguan layanan: Di API: Periksa apakah InsertionOrder induk item baris telah menetapkan bidStrategy.maximizeSpendAutoBid atau bidStrategy.performanceGoalAutoBid. Jika demikian, jangan mencoba memperbarui kolom anggaran LineItem menggunakan advertisers.lineItems.patch. Di SDF: Periksa apakah entri SDF untuk pesanan pemasangan iklan induk item baris memiliki kolom Insertion Order Optimization yang ditetapkan ke TRUE. Jika demikian, jangan mencoba memperbarui kolom Budget Type atau Budget Amount untuk entri SDF item baris.
Batasan situs untuk File Data Terstruktur	12 Juni 2025	Mulai 12 Juni 2025, kami akan menghapus batasan yang ada untuk Penargetan URL dalam entri SDF yang membatasi penyertaan situs yang lebih baru. Sebagai gantinya, SDF akan mencocokkan perilaku API dan UI serta mengizinkan penargetan URL selama diformat dengan benar. Hal ini relevan dengan kolom Site Targeting - Include dan Site Targeting - Exclude dalam file Pesanan Pemasangan Iklan dan Item Baris.
Kolom "Bid Multipliers" di File Data Terstruktur Item Baris	1 Mei 2025	Pada 1 Mei 2025, entri dalam File Data Terstruktur Item Baris yang mencoba menetapkan kolom "Bid Multipliers" akan gagal membuat atau memperbarui resource saat file diupload.
Memerlukan sumber inventaris partner video untuk item baris Peningkat Permintaan di File Data Terstruktur	22 April 2025	Mulai 22 April 2025, Anda akan diwajibkan untuk menyertakan nilai "partner video" di kolom TrueView Inventory Source Targeting pada entri item baris yang memiliki nilai kolom Type "Peningkat Permintaan". Setelah penegakan ini dimulai, nilai akan diisi ulang untuk item baris yang ada dan disertakan saat mendownload File Data Terstruktur baru. Untuk menghindari gangguan layanan: Perbarui integrasi Anda untuk menyertakan nilai "Partner Video" di semua entri item baris Peningkat Permintaan. Perbarui integrasi Anda untuk mengelola sumber inventaris Peningkat Permintaan di tingkat Grup Iklan menggunakan kolom Grup Iklan SDF v8.1 Demand Gen Inventory Source Strategy dan Demand Gen Enabled Inventory Sources.
Kampanye tindakan Video di File Data Terstruktur	22 April 2025	Pada 22 April 2025, Anda tidak akan dapat lagi membuat Item baris untuk kampanye tindakan Video menggunakan File Data Terstruktur, karena item baris tersebut akan diupgrade ke Peningkat Permintaan. Entri Item baris yang mencoba diupload dengan nilai kolom Subtype "Action" dan nilai kolom Type "TrueView" akan gagal. Untuk menghindari gangguan layanan, perbarui integrasi Anda agar menggunakan Peningkat Permintaan, bukan kampanye tindakan Video.
Durasi keanggotaan tanpa batas untuk audiens pihak pertama	7 April 2025	Pada 7 April 2025, resource FirstAndThirdPartyAudience tidak akan lagi mengizinkan durasi keanggotaan audiens tanpa batas. Permintaan firstAndThirdPartyAudiences.create dan firstAndThirdPartyAudiences.patch yang menetapkan nilai kolom membershipDurationDays ke 10.000 akan menampilkan error 400. Audiens yang ada dengan nilai kolom membershipDurationDays sebesar 10.000 akan diperbarui menjadi 540 dan durasi keanggotaan baru akan diterapkan secara retroaktif ke keanggotaan yang ada. Tindakan ini akan mengakhiri semua keanggotaan yang berusia lebih dari 540 hari. Untuk menghindari gangguan layanan: Pastikan integrasi Anda tidak menetapkan nilai kolom membershipDurationDays audiens baru atau yang sudah ada ke 10.000. Perbarui keanggotaan audiens Customer Match yang ada menggunakan firstAndThirdPartyAudiences.editCustomerMatchMembers. Perbarui keanggotaan audiens Customer Match Anda secara rutin untuk memastikan ukuran daftar audiens Anda tidak mengecil secara tidak sengaja. Di v4, perubahan ini tercermin dalam resource FirstPartyAndPartnerAudience.
Algoritme bidding kustom dan aktivitas Floodlight tidak cocok	1 April 2025	Pada 1 April 2025: Permintaan advertisers.lineItems.create yang mencoba menetapkan kolom floodlightActivityConfigs dari objek ConversionCountingConfig dan kolom customBiddingAlgorithmId dari objek MaximizeSpendBidStrategy atau PerformanceGoalBidStrategy yang tidak menggunakan aktivitas Floodlight yang cocok akan menampilkan error 400. Permintaan advertisers.lineItems.patch yang mencoba memperbarui kolom floodlightActivityConfigs dari objek ConversionCountingConfig saat kolom customBiddingAlgorithmId dari objek MaximizeSpendBidStrategy atau PerformanceGoalBidStrategy ditetapkan akan menampilkan error 400. Entri dalam File Data Terstruktur Item Baris yang mencoba memperbarui kolom "ID Aktivitas Floodlight Konversi" saat kolom "ID Algoritma" ditetapkan akan gagal diperbarui saat file diupload. Permintaan customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create untuk resource CustomBiddingAlgorithm yang ditetapkan ke item baris akan menampilkan error. Untuk menghindari gangguan layanan, perbarui integrasi Anda ke: Pastikan aktivitas Floodlight yang relevan ditetapkan ke item baris sebelum atau bersamaan dengan penetapan algoritma bidding kustom. Algoritma bidding kustom yang ada akan dibatalkan penetapannya dari semua item baris sebelum mencoba diperbarui.

Penghentian penggunaan fitur sebelumnya

Untuk membaca penghentian penggunaan yang diumumkan yang memengaruhi versi Display & Video 360 API yang tidak digunakan lagi, lihat penghentian penggunaan yang diarsipkan.