Layar & Video 360 API v2 dihentikan. Gunakan Display & Video 360 API v3 sebagai gantinya. Untuk petunjuk migrasi v2 ke v3, lihat panduan migrasi kami.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengumumkan Penghentian

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

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

Penghentian Versi

Layar & Versi Video 360 API dirilis, tidak digunakan lagi, dan dihentikan secara berkala. Ini langkah-langkahnya didefinisikan sebagai berikut:

Rilis: Versi keluar dari status alfa atau beta dan dipertimbangkan stabil. Penambahan fitur mungkin masih dirilis untuk versi ini.
Penghentian penggunaan: Versi ini akan dihentikan dan dukungan telah berakhir (sunset) tanggal diumumkan. Pengguna harus bermigrasi ke versi yang lebih baru sebelum penghentian tanggal. Penambahan fitur tidak akan dirilis lagi untuk versi ini.
Sunset: Versi ini tidak lagi didukung. Permintaan yang dibuat pada versi menghasilkan {i>error<i}.

Tabel di bawah ini mencantumkan semua kampanye Display & Versi Video 360 API, rilisnya tanggal penghentian serta tanggal penghentian dan tanggal penghentian, jika diumumkan.

Versi API	Tanggal Rilis	Tanggal Penghentian Penggunaan	Tanggal Terbenam	Panduan Migrasi
v3	31 Oktober 2023
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 Fitur

Ikuti blog developer Google Ads kami untuk mengetahui pengumuman tentang penghentian penggunaan fitur signifikan yang akan datang.

Tabel di bawah ini mencantumkan semua penghentian fitur yang diumumkan, yang memberikan tanggal mulai berlaku dan deskripsi penghentian penggunaan dengan tindakan yang disarankan serta tautan ke dokumentasi yang relevan:

Fitur	Tanggal Mulai Berlaku Awal	Deskripsi
Perluasan Penargetan	25 Maret 2023	Penggantian fitur perluasan penargetan dengan penargetan yang dioptimalkan, diluncurkan secara bertahap dari 25 Maret 2023 hingga awal Mei 2023. Perubahan yang relevan pada kampanye Display & Perilaku Video 360 API dan File Data Terstruktur serta tindakan yang disarankan telah diumumkan dalam postingan blog.
Pemicu Manual	17 Mei 2023	Linimasa: 17 Mei 2023: Item baris yang menggunakan pemicu manual akan berhenti ditayangkan di Display & Video 360 Jika Anda mengaktifkan pemicu manual yang ditautkan ke item baris aktif setelah tanggal ini, item baris tersebut tidak akan menayangkan iklan. 1 Agustus 2023: Layanan `advertisers.manualTriggers` di DV360 API v1 dan v2, nilai enum `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER` di DV360 API v1, dan kolom `LineItemFlight.triggerId` di DV360 API v1 akan dihentikan. Setelah tanggal ini, permintaan yang dibuat ke layanan ini atau ke kolom ini akan menampilkan error. Tindakan yang disarankan: Segera hentikan penggunaan pemicu manual untuk memulai dan menghentikan penayangan item baris. Berhenti membuat permintaan ke layanan `advertisers.manualTriggers`. Perbarui kolom `flight.flightDateType` dan `flight.triggerId` untuk semua item baris yang menggunakan pemicu manual.
Aplikasi Terinstal dan Perangkat Seluler Baru `GoogleAudience` Jenis	20 Mei 2023	Linimasa: 20 Mei 2023: Anda tidak dapat lagi menetapkan resource `GoogleAudience` dengan `GoogleAudienceType` dari `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` atau `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` ke penargetan audiens pesanan pemasangan iklan atau item baris. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. Ini mencakup permintaan `advertisers.lineItems.duplicate` dan `advertisers.lineItems.generateDefault`, jika item baris yang dibuat akan menyertakan audiens yang tidak digunakan lagi dalam penargetan audiensnya. 8 Juni 2023: Audiens yang terpengaruh akan dihapus dari semua penargetan item baris dan pesanan pemasangan iklan serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, item baris tersebut akan dijeda. Pada tanggal tersebut, audiens tersebut juga tidak akan dapat diambil lagi menggunakan layanan `googleAudiences`. Tugas yang Direkomendasikan: Sebaiknya segera berhenti menggunakan audiens yang terpengaruh saat melakukan perubahan mendatang pada penargetan item baris Anda. Hapus semua audiens yang terpengaruh dari penargetan item baris dan pesanan pemasangan iklan yang sudah ada. Baca cara memperbarui penargetan audiens di panduan Target Audiens.
Jenis `FirstAndThirdPartyAudience` Berbasis Aktivitas dan Batas Frekuensi	20 Mei 2023	Linimasa: 20 Mei 2023: Anda tidak dapat lagi menetapkan resource `FirstAndThirdPartyAudience` dengan `AudienceType` dari `ACTIVITY_BASED` atau `FREQUENCY_CAP` ke penargetan audiens pesanan pemasangan iklan atau item baris. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. Ini mencakup permintaan `advertisers.lineItems.duplicate` dan `advertisers.lineItems.generateDefault`, jika item baris yang dibuat akan menyertakan audiens yang tidak digunakan lagi dalam penargetan audiensnya. 8 Juni 2023: Audiens yang terpengaruh akan dihapus dari semua penargetan item baris dan pesanan pemasangan iklan serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, item baris tersebut akan dijeda. Pada tanggal tersebut, audiens tersebut juga tidak akan dapat diambil lagi menggunakan layanan `firstAndThirdPartyAudiences`. Tugas yang Direkomendasikan: Sebaiknya segera berhenti menggunakan audiens yang terpengaruh saat melakukan perubahan mendatang pada penargetan item baris Anda. Hapus semua audiens yang terpengaruh dari penargetan item baris dan pesanan pemasangan iklan yang sudah ada. Baca cara memperbarui penargetan audiens di panduan Target Audiens.
Batas Kuota API yang Ada	30 Mei 2023	Pada 30 Mei 2023, batas penggunaan yang ada akan diganti dengan struktur kuota hybrid yang melakukan hal berikut: Meniadakan permintaan per hari per kuota project. Menetapkan permintaan per menit per pengiklan per project untuk metode yang memenuhi syarat. Batas baru ini akan memungkinkan fleksibilitas yang lebih besar dalam penggunaan API dan memungkinkan paralelisasi permintaan di seluruh pengiklan. Detail tentang perubahan ini dapat ditemukan dalam dokumentasi batas kuota yang sudah ada.
Penggunaan operator `OR` di antara batasan berbagai kolom dalam filter `LIST` Tanggal Mulai Berlaku Awal diperbarui	21 Juni 2023	Pada 21 Juni 2023, parameter `filter` permintaan `LIST` tidak akan lagi mengizinkan operator logika `OR` untuk digunakan di antara batasan kolom yang berbeda. Misalnya, resource yang diidentifikasi dengan string filter `lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123"` harus diambil menggunakan dua permintaan `LIST` dengan string filter berikut: `lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` `insertionOrderId="123"` Lihat panduan cara memfilter permintaan `LIST` untuk mengetahui detail selengkapnya tentang batasan operator logika. Tinjau parameter kueri `filter` dari semua panggilan `LIST` Anda yang ada dan pastikan parameter tersebut menggunakan operator logika ATAU dengan benar sebelum 21 Juni 2023 untuk menghindari gangguan layanan.
Kemampuan untuk memfilter atau mengurutkan permintaan daftar menurut kolom `budget.budget_segments.date_range.end_date` dan `flight.dateRange.endDate` Tanggal Mulai Berlaku Awal diperbarui	21 Juni 2023	Pada 21 Juni 2023, `budget.budget_segments.date_range.end_date` dan `flight.dateRange.endDate` tidak akan lagi diterima kolom dalam parameter kueri `advertisers.insertionOrders.list` serta `advertisers.lineItems.list` `filter` dan `orderBy`. Setelah tanggal ini, permintaan yang menggunakan kolom ini dalam parameter kueri `filter` dan `orderBy` akan menampilkan error. Hapus semua filter dan logika urutan menggunakan kedua kolom ini sebelum 21 Juni 2023 untuk menghindari gangguan layanan.
Kemampuan untuk memfilter permintaan `advertisers.lineItems.list` menurut empat kolom tambahan	21 Juni 2023	Pada 21 Juni 2023, `advertisers.lineItems.list` tidak lagi mendukung pemfilteran berdasarkan kolom berikut: `flight.triggerId` `targetedChannelId` `targetedNegativeKeywordListId` `warningMessages` Hapus semua logika filter menggunakan keempat kolom ini sebelum 21 Juni 2023 untuk menghindari gangguan layanan.
Pembelian berbasis hasil	1 Agustus 2023	Pada 1 Agustus 2023, pesanan pemasangan iklan yang menggunakan pembelian berbasis hasil, ditentukan oleh nilai kolom `billableOutcome` sebesar `BILLABLE_OUTCOME_PAY_PER_CLICK` atau `BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION`, dan item baris turunannya akan diarsipkan. Perubahan ini akan memengaruhi permintaan berikut: Mencoba menggunakan `advertisers.insertionOrders.create` untuk membuat pesanan pemasangan iklan menggunakan pembelian berbasis hasil akan menampilkan error `400` Mencoba menggunakan `advertisers.lineItems.create`, `advertisers.lineItems.duplicate`, atau `advertisers.lineItems.generateDefault` untuk membuat item baris pada pesanan pemasangan iklan menggunakan pembelian berbasis hasil akan menampilkan error `400` Mengingat bahwa resource yang diarsipkan tidak disertakan dalam permintaan `LIST` secara default, resource yang terpengaruh tidak akan lagi ditampilkan oleh metode `advertisers.insertionOrders.list` dan `advertisers.lineItems.list` secara default.
Kolom `publisherReviewStatuses` di referensi materi iklan	26 Juni 2024	Mulai 26 Juni 2024, kolom `publisherReviewStatuses` akan dihentikan dan akan kosong saat mengambil resource `Creative`.
Sebagian penargetan konten untuk YouTube & Item baris Partners	30 September 2024	Pada 30 September 2024, nilai berikut untuk nilai yang diidentifikasi jenis penargetan akan dihentikan untuk YouTube & Item baris Partners: `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`: `CONTENT_RATING_TIER_UNRATED` `CONTENT_RATING_TIER_GENERAL` `CONTENT_RATING_TIER_PARENTAL_GUIDANCE` `CONTENT_RATING_TIER_TEENS` `CONTENT_RATING_TIER_MATURE` `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`: `SENSITIVE_CATEGORY_EMBEDDED_VIDEO` `SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO` Opsi penargetan penghentian penggunaan akan otomatis dihapus dari penargetan item baris yang sudah ada. Untuk menghindari gangguan layanan, hapus penargetan ini dari channel YouTube & Item baris Partner sebelum tanggal penghentian.
Audiens pihak pertama dan ketiga Oracle	30 September 2024	Pada 30 September 2024, sumber resource `FirstAndThirdPartyAudience` dari Oracle akan dihentikan. Setelah penghentian, audiens ini akan dihapus dari semua penargetan resource dan audiens gabungan yang ada. Jika item baris hanya menargetkan audiens yang dihentikan atau secara negatif menargetkan audiens yang dihentikan, pembaruan ini akan otomatis menjeda item baris tersebut. Untuk menghindari gangguan layanan, identifikasi dan hapus audiens Oracle dari penargetan audiens item baris dan audiens gabungan yang sudah ada sebelum tanggal penghentian.
Penargetan yang dioptimalkan untuk item baris untuk sebagian strategi bidding	30 September 2024	Mulai 30 September 2024, resource `LineItem` yang menggunakan sebagian strategi bidding tidak akan lagi kompatibel dengan penargetan yang dioptimalkan. Dengan perubahan ini, resource `LineItem` dengan `targetingExpansion.enableOptimizedTargeting` yang disetel ke `True` dan `bidStrategy.maximizeSpendAutoBid.performanceGoalType` disetel ke `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA`, `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN`, atau `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` atau `bidStrategy.performanceGoalAutoBid.performanceGoalType` yang disetel ke `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` akan diperbarui untuk menyetel `targetingExpansion.enableOptimizedTargeting` ke `False`. Untuk menghindari gangguan layanan, perbarui dan pastikan bahwa item baris Anda yang menggunakan strategi bidding ini tidak mengaktifkan penargetan yang dioptimalkan.
Penerbangan SEGERA `Pacing` untuk pesanan pemasangan iklan	5 November 2024	Pada 5 November 2024, `PACING_TYPE_ASAP` tidak akan lagi kompatibel dengan `PACING_PERIOD_FLIGHT` saat menetapkan kolom pesanan pemasangan iklan `pacing`. `pacingType` untuk semua pesanan pemasangan iklan yang sudah ada dengan konfigurasi ini akan diperbarui menjadi `PACING_TYPE_AHEAD`. Untuk menghindari gangguan layanan, perbarui `pacing` pesanan pemasangan iklan yang ada menggunakan `PACING_TYPE_ASAP` dan `PACING_PERIOD_FLIGHT`.