การเลิกใช้งานประกาศ

หน้านี้แสดงวันที่เลิกใช้งานและหยุดให้บริการสำหรับเวอร์ชัน API และฟีเจอร์แต่ละรายการใน Display & Video 360 API

นอกจากนี้ เราจะประกาศการเลิกใช้งานและวันที่หยุดให้บริการ API ใน บล็อกนักพัฒนาซอฟต์แวร์ Google Ads ด้วย

การเลิกใช้งานเวอร์ชัน

เราจะเผยแพร่ เลิกใช้งาน และหยุดให้บริการเวอร์ชัน Display & Video 360 API เป็นประจำ ขั้นตอนเหล่านี้ มีคำจำกัดความดังนี้

  • รุ่น: เวอร์ชันจะออกจากสถานะอัลฟ่าหรือเบต้าและถือว่าเป็นเวอร์ชัน เสถียร เราอาจยังคงเปิดตัวฟีเจอร์เพิ่มเติมสำหรับเวอร์ชันนี้
  • การเลิกใช้งาน: เราจะหยุดให้บริการเวอร์ชันนี้และประกาศวันที่สิ้นสุดการสนับสนุน (หยุดให้บริการ) ผู้ใช้ต้องย้ายข้อมูลไปยังเวอร์ชันใหม่กว่าก่อนวันที่หยุดให้บริการ และจะไม่มีการเปิดตัวฟีเจอร์เพิ่มเติมสำหรับเวอร์ชันนี้อีกต่อไป
  • หยุดให้บริการ: ระบบไม่รองรับเวอร์ชันนี้อีกต่อไป คำขอที่ส่งไปยังเวอร์ชัน จะแสดงข้อผิดพลาด

ตารางนี้แสดงรายการ API หลักของ Display & Video 360 ที่มีอยู่ทั้งหมด วันที่เผยแพร่ และวันที่เลิกใช้งานและหยุดให้บริการ (หากมีการประกาศ)

เวอร์ชัน API วันที่เผยแพร่ วันที่เลิกใช้งาน วันที่หยุดให้บริการ คำแนะนำในการย้ายข้อมูล
v4 27 มีนาคม 2025
v3 31 ตุลาคม 2023 2 เมษายน 2025 7 ตุลาคม 2025 ย้ายข้อมูลจาก v3 เป็น v4
v2 6 ธันวาคม 2022 15 กุมภาพันธ์ 2024 3 กันยายน 2024 ย้ายข้อมูลจาก v2 ไปยัง v3
v1 9 มีนาคม 2020 13 มีนาคม 2023 14 กันยายน 2023 ย้ายข้อมูลจาก v1 เป็น v2

การเลิกใช้งานฟีเจอร์

โปรดติดตามบล็อกสำหรับนักพัฒนาซอฟต์แวร์ Google Ads เพื่อดูประกาศเกี่ยวกับการเลิกใช้งานฟีเจอร์สำคัญที่กำลังจะเกิดขึ้น

ตารางนี้แสดงการเลิกใช้งานฟีเจอร์ที่ประกาศแล้วทั้งหมดซึ่งส่งผลต่อเวอร์ชันที่ใช้งานจริง โดยระบุวันที่เริ่มต้นที่มีผลและคำอธิบายของการเลิกใช้งานพร้อม การดำเนินการที่แนะนำและลิงก์ไปยังเอกสารประกอบที่เกี่ยวข้อง

ฟีเจอร์ วันที่เริ่มต้นที่มีผล คำอธิบาย
Nielsen ในฐานะผู้ให้บริการบุคคลที่สามที่วัด Brand Lift 13 กรกฎาคม 2026

ตั้งแต่วันที่ 13 กรกฎาคม 2026 เป็นต้นไป คุณจะไม่สามารถกำหนดให้ Nielsen เป็นผู้ให้บริการบุคคลที่สามสำหรับการวัด Brand Lift ได้อีกต่อไป เราจะทำการเปลี่ยนแปลงต่อไปนี้ใน Display & Video 360 API และไฟล์ Structured Data เพื่อรองรับการเปลี่ยนแปลงนี้

ระบบจะนำการใช้ Nielsen ในฐานะผู้ให้บริการวัด Brand Lift ที่มีอยู่ออก

โปรดนำการมอบหมาย Nielsen เป็นผู้ให้บริการวัดการเพิ่มขึ้นของแบรนด์ออกจากการผสานรวมเพื่อไม่ให้บริการหยุดชะงัก

การรับค่าเริ่มต้นของชื่อและโลโก้ธุรกิจ 13 กรกฎาคม 2026

ตั้งแต่วันที่ 13 กรกฎาคม 2026 เป็นต้นไป โฆษณาที่ปรับเปลี่ยนตามบริบทของ YouTube จะเริ่มรองรับชิ้นงานชื่อและโลโก้ธุรกิจ และโฆษณา Demand Gen และโฆษณาที่ปรับเปลี่ยนตามบริบทของ YouTube ทั้งหมดที่ไม่มีชิ้นงานชื่อและโลโก้ธุรกิจที่ตั้งค่าไว้จะรับค่าเริ่มต้นที่ตั้งไว้ในระดับผู้ลงโฆษณา ในขณะเดียวกัน การเปลี่ยนแปลงนี้จะทําให้เกิดการเปลี่ยนแปลงต่อไปนี้ในลักษณะการทํางานของ Display & Video 360 API และไฟล์ Structured Data

  • ระบบจะไม่กำหนดให้ต้องระบุฟิลด์ businessName, logo และ logoImages ในแหล่งข้อมูล ad_details Demand Gen AdGroupAd อีกต่อไป หากมีการกำหนดค่าเริ่มต้นให้กับผู้ลงโฆษณาหลัก หากไม่ได้ระบุ โฆษณาจะรับค่าเริ่มต้นระดับผู้ลงโฆษณา
  • ตั้งค่าคอลัมน์ Business Name และ Logo Asset IDs ใน SDF ของโฆษณาได้สําหรับโฆษณาที่มีประเภทใดประเภทหนึ่งต่อไปนี้ "ที่ปรับเปลี่ยนตามพื้นที่โฆษณา" "ผลิตภัณฑ์ Demand Gen" "วิดีโอ Demand Gen" "รูปภาพ Demand Gen" และ "ภาพสไลด์ Demand Gen" หากไม่ได้ตั้งค่าคอลัมน์เหล่านี้สำหรับรายการโฆษณาที่เกี่ยวข้อง และมีการกำหนดค่าเริ่มต้นให้กับผู้ลงโฆษณาระดับบนสุด โฆษณาจะรับค่าเริ่มต้นระดับผู้ลงโฆษณาเมื่อบันทึก
  • ไม่จำเป็นต้องใช้คอลัมน์ Business Name และ Logo Asset IDs ใน SDF ของโฆษณาสำหรับโฆษณา Demand Gen อีกต่อไป หากผู้ลงโฆษณาระดับบนสุดได้กำหนดค่าเริ่มต้นไว้

หากตั้งค่าเริ่มต้นไว้ที่ระดับผู้ลงโฆษณา โฆษณาทั้งหมดภายใต้ผู้ลงโฆษณารายนั้นจะมีค่าชื่อและโลโก้ธุรกิจที่กำหนด หากต้องการปล่อยให้ค่าชิ้นงานชื่อและโลโก้ธุรกิจไม่ได้ตั้งค่าสําหรับโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณาของ YouTube อย่าตั้งค่าเริ่มต้นสําหรับผู้ลงโฆษณา

การจัดการการกำหนดเป้าหมายแคมเปญและใบสั่งซื้อการใส่โฆษณาใน Display & Video 360 API และไฟล์ Structured Data 23 กุมภาพันธ์ 2026

ในวันที่ 23 กุมภาพันธ์ 2026 Display & Video 360 จะหยุดให้บริการการกำหนดเป้าหมายใบสั่งซื้อการใส่โฆษณาและแคมเปญ เราจะทำการเปลี่ยนแปลง Display & Video 360 API และไฟล์ Structured Data (SDF) ให้สอดคล้องกับการเปลี่ยนแปลงนี้ ใน Display & Video 360 API วิธีการบางส่วนจะหยุดให้บริการและแสดงข้อผิดพลาดหากมีการเรียกใช้ ใน SDF คอลัมน์การกำหนดเป้าหมายในไฟล์ใบสั่งซื้อการใส่โฆษณาและแคมเปญจะไม่ได้รับการป้อนข้อมูลเมื่อดาวน์โหลด และจะต้องว่างเปล่าเมื่ออัปโหลด เราขอแนะนำให้ผู้ใช้กำหนดเป้าหมายให้กับรายการโฆษณาโดยตรงเมื่อสร้างรายการโฆษณา

เมธอด Display & Video 360 API ต่อไปนี้จะแสดงข้อผิดพลาด 404 หากมีการเรียกใช้

รายการ SDF ของแคมเปญที่มีค่าที่กำหนดให้กับคอลัมน์ต่อไปนี้จะอัปโหลดไม่สำเร็จ

  • 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

รายการ SDF ของใบสั่งซื้อที่มีค่าที่กำหนดให้กับคอลัมน์ต่อไปนี้จะอัปโหลดไม่สำเร็จ

  • 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
ประกาศว่ารายการโฆษณาแสดงโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่ 8 กันยายน 2025

ตั้งแต่วันที่ 8 กันยายน 2025 เป็นต้นไป คุณจะต้องประกาศว่ารายการโฆษณาจะแสดงโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่เมื่อสร้างรายการโฆษณาใหม่โดยใช้ Display & Video 360 API หรือ SDF คุณสามารถประกาศดังกล่าวได้ด้วยวิธีต่อไปนี้

หากผู้ลงโฆษณาหลักไม่มีรายการโฆษณาที่แสดงโฆษณาทางการเมืองในสหภาพยุโรป คุณสามารถประกาศที่ระดับผู้ลงโฆษณาโดยใช้ฟิลด์ containsEuPoliticalAds ใน API ของ Display & Video 360 Advertiser หากตั้งค่าฟิลด์นี้เป็น DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ระบบจะกำหนดค่าเดียวกันให้กับรายการโฆษณาใหม่ทั้งหมดภายใต้ผู้ลงโฆษณารายนั้น หากไม่ได้ระบุไว้เป็นอย่างอื่น และจะอัปเดตรายการโฆษณาที่มีอยู่ทั้งหมดภายใต้ผู้ลงโฆษณารายนั้นให้ใช้ค่าเดียวกัน หากยังไม่ได้ตั้งค่า คุณอัปเดตการประกาศของรายการโฆษณาได้ทุกเมื่อหลังจากสร้างโดยใช้ UI, API หรือ SDF

หากคุณประกาศที่ระดับผู้ลงโฆษณาไม่ได้ หรือประกาศว่าโฆษณาทางการเมืองในสหภาพยุโรปอาจแสดงภายใต้ผู้ลงโฆษณาของคุณ โปรดอัปเดตการผสานรวม Display & Video 360 API และ SDF ก่อนวันที่ 8 กันยายน 2025 เพื่อไม่ให้บริการหยุดชะงัก

  • ตั้งค่าฟิลด์ containsEuPoliticalAds ในทรัพยากร LineItem ใหม่เมื่อส่งคำขอ advertisers.lineItems.create
  • ตั้งค่าฟิลด์ containsEuPoliticalAds ในเนื้อหาคำขอของคำขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault
  • ย้ายข้อมูลไปใช้ไฟล์ข้อมูลที่มีโครงสร้างเวอร์ชัน 9 และตั้งค่าคอลัมน์ Contains EU Political Ads สำหรับรายการโฆษณาใหม่เป็น Yes หรือ No เมื่ออัปโหลด ดูวิธีการแบบทีละขั้นตอนได้ในคำแนะนำในการย้ายข้อมูลเป็น v9
  • ก่อนที่จะอัปเดตการกำหนดเป้าหมายตามภูมิศาสตร์สำหรับรายการโฆษณาที่มีอยู่โดยใช้ Display & Video 360 API หรือ SDF ให้อัปเดตรายการโฆษณาเพื่อประกาศ
การตั้งค่าหมวดหมู่เนื้อหาสำหรับรายการโฆษณาของ YouTube และพาร์ทเนอร์ 12 มิถุนายน 2025

ในวันที่ 12 มิถุนายน 2025 คุณจะแก้ไขการกำหนดค่าหมวดหมู่เนื้อหาสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์แต่ละรายการไม่ได้อีกต่อไป ซึ่งเป็นส่วนหนึ่งของการอัปเดตประสบการณ์การใช้งานความเหมาะสมกับแบรนด์ แต่จะควบคุมการตั้งค่าหมวดหมู่เนื้อหาที่ระดับผู้ลงโฆษณาเท่านั้น เราจะทำการเปลี่ยนแปลงต่อไปนี้ใน Display & Video 360 API และไฟล์ Structured Data เพื่อรองรับการเปลี่ยนแปลงนี้

  • เราจะไม่ปรับปรุงฟิลด์ contentCategory ในออบเจ็กต์ YoutubeAndPartnersSettings ของแหล่งข้อมูล LineItem ของ YouTube และพาร์ทเนอร์อีกต่อไป และจะถูกนำออกทั้งหมดในอนาคต
  • คอลัมน์ TrueView Content Filter ใน SDF ของรายการโฆษณาจะเขียนไม่ได้อีกต่อไป
หากไม่ต้องการให้บริการหยุดชะงัก ให้ทำดังนี้
  • เรียกข้อมูลฟิลด์ effectiveContentCategory แทนฟิลด์ contentCategory เมื่อตรวจสอบรายการโฆษณาของ YouTube และพาร์ทเนอร์ใน API
  • หยุดแก้ไขคอลัมน์ TrueView Content Filter เมื่ออัปเดตรายการ SDF line item ปล่อยให้คอลัมน์ว่างไว้เมื่อสร้างรายการโฆษณาใหม่
การอัปเดตงบประมาณรายการโฆษณาด้วยการเพิ่มประสิทธิภาพใบสั่งซื้อการใส่โฆษณา 12 มิถุนายน 2025

ตั้งแต่วันที่ 12 มิถุนายน 2025 เป็นต้นไป คุณจะอัปเดตการตั้งค่างบประมาณสำหรับรายการโฆษณาที่มีใบสั่งซื้อเพื่อการใส่โฆษณาหลักซึ่งตั้งค่าให้เพิ่มประสิทธิภาพโดยใช้กลยุทธ์การเสนอราคาอัตโนมัติไม่ได้อีกต่อไป

หากไม่ต้องการให้บริการหยุดชะงัก ให้ทำดังนี้
ข้อจำกัดของเว็บไซต์สำหรับไฟล์ Structured Data 12 มิถุนายน 2025

ตั้งแต่วันที่ 12 มิถุนายน 2025 เป็นต้นไป เราจะนำข้อจำกัดที่มีอยู่สำหรับ URL ที่กำหนดเป้าหมายในรายการ SDF ซึ่งจำกัดไม่ให้รวมเว็บไซต์ใหม่กว่าไว้ แต่ SDF จะจับคู่ลักษณะการทำงานของ API และ UI และอนุญาตให้กำหนดเป้าหมาย URL ตราบใดที่มีการจัดรูปแบบอย่างถูกต้อง

ซึ่งเกี่ยวข้องกับคอลัมน์ Site Targeting - Include และ Site Targeting - Exclude ในไฟล์ใบสั่งซื้อการใส่โฆษณาและรายการโฆษณา
คอลัมน์ "ตัวคูณราคาเสนอ" ในไฟล์ Structured Data ของรายการโฆษณา 1 พฤษภาคม 2025

ในวันที่ 1 พฤษภาคม 2025 รายการในไฟล์ข้อมูลที่มีโครงสร้างของรายการโฆษณาที่พยายามตั้งค่าคอลัมน์ "ตัวคูณราคาเสนอ" จะสร้างหรืออัปเดตทรัพยากรเมื่ออัปโหลดไฟล์ไม่สำเร็จ

กำหนดให้มีแหล่งที่มาของพื้นที่โฆษณาพาร์ทเนอร์วิดีโอสำหรับรายการโฆษณา Demand Gen ในไฟล์ Structured Data 22 เมษายน 2025

ตั้งแต่วันที่ 22 เมษายน 2025 เป็นต้นไป คุณจะต้องระบุค่า "พาร์ทเนอร์วิดีโอ" ในคอลัมน์ TrueView Inventory Source Targeting ของรายการรายการโฆษณาที่มีค่าคอลัมน์ Type เป็น "Demand Gen" เมื่อการบังคับใช้เริ่มขึ้น ระบบจะป้อนค่าแทนสำหรับรายการโฆษณาที่มีอยู่และรวมไว้เมื่อดาวน์โหลดไฟล์ Structured Data ใหม่

วิธีหลีกเลี่ยงไม่ให้บริการหยุดชะงัก

  • อัปเดตการผสานรวมเพื่อให้มีค่า "พาร์ทเนอร์วิดีโอ" ในรายการโฆษณา Demand Gen ทั้งหมด
  • อัปเดตการผสานรวมเพื่อจัดการแหล่งที่มาของพื้นที่โฆษณา Demand Gen ที่ระดับกลุ่มโฆษณาโดยใช้คอลัมน์กลุ่มโฆษณา SDF v8.1 Demand Gen Inventory Source Strategy และ Demand Gen Enabled Inventory Sources
แคมเปญวิดีโอเพื่อกระตุ้นการกระทำในไฟล์ข้อมูลที่มีโครงสร้าง 22 เมษายน 2025

ตั้งแต่วันที่ 22 เมษายน 2025 เป็นต้นไป คุณจะสร้างรายการโฆษณาสำหรับแคมเปญวิดีโอเพื่อกระตุ้นการกระทำโดยใช้ไฟล์ Structured Data ไม่ได้อีกต่อไป เนื่องจากเราจะอัปเกรดเป็น Demand Gen รายการรายการโฆษณาที่พยายามอัปโหลดโดยมีค่าคอลัมน์ Subtype เป็น "Action" และค่าคอลัมน์ Type เป็น "TrueView" จะล้มเหลว

โปรดอัปเดตการผสานรวมให้ใช้ Demand Gen แทนแคมเปญวิดีโอเพื่อกระตุ้นการกระทำเพื่อไม่ให้บริการหยุดชะงัก

ระยะเวลาการเป็นสมาชิกไม่จำกัดสำหรับกลุ่มเป้าหมายบุคคลที่หนึ่ง 7 เมษายน 2025

ในวันที่ 7 เมษายน 2025 FirstAndThirdPartyAudience จะไม่อนุญาตให้ระยะเวลาการเป็นสมาชิกกลุ่มเป้าหมายเป็นแบบไม่มีกำหนดอีกต่อไป คำขอ firstAndThirdPartyAudiences.create และ firstAndThirdPartyAudiences.patch ที่ตั้งค่าฟิลด์ membershipDurationDays เป็น 10,000 จะแสดงข้อผิดพลาด 400 ระบบจะอัปเดตกลุ่มเป้าหมายที่มีอยู่ซึ่งมีค่าฟิลด์ membershipDurationDays เป็น 10,000 ให้เป็น 540 และจะใช้ระยะเวลาการเป็นสมาชิกใหม่กับการเป็นสมาชิกที่มีอยู่ย้อนหลัง ซึ่งจะเป็นการสิ้นสุดการเป็นสมาชิกทั้งหมดที่เก่ากว่า 540 วัน

วิธีหลีกเลี่ยงไม่ให้บริการหยุดชะงัก

  • ตรวจสอบว่าการผสานรวมไม่ได้ตั้งค่าฟิลด์ membershipDurationDays ของกลุ่มเป้าหมายใหม่หรือที่มีอยู่เป็น 10,000
  • รีเฟรชการเป็นสมาชิกของกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้าที่มีอยู่โดยใช้ firstAndThirdPartyAudiences.editCustomerMatchMembers
  • รีเฟรชการเป็นสมาชิกกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้าเป็นประจำเพื่อให้แน่ใจว่าขนาดรายการกลุ่มเป้าหมายจะไม่เล็กลงโดยไม่ตั้งใจ

ใน v4 การเปลี่ยนแปลงนี้จะแสดงในทรัพยากร FirstPartyAndPartnerAudience

อัลกอริทึมการเสนอราคาที่กําหนดเองและกิจกรรม Floodlight ไม่ตรงกัน 1 เมษายน 2025

ในวันที่ 1 เมษายน 2025

โปรดอัปเดตการผสานรวมเป็น

  • ตรวจสอบว่าได้กําหนดกิจกรรม Floodlight ที่เกี่ยวข้องให้กับรายการโฆษณาก่อนหรือในเวลาเดียวกับการกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเอง
  • ระบบจะยกเลิกการกำหนดอัลกอริทึมการเสนอราคาที่กำหนดเองที่มีอยู่จากรายการโฆษณาทั้งหมดก่อนที่จะพยายามอัปเดต

การเลิกใช้งานฟีเจอร์ก่อนหน้า

หากต้องการอ่านเกี่ยวกับการเลิกใช้งานที่ประกาศไว้ซึ่งส่งผลต่อ Display & Video 360 API เวอร์ชันที่เลิกใช้งานแล้ว โปรดดูการเลิกใช้งานที่เก็บถาวร