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

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

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

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

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

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

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

เวอร์ชัน 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 เพื่อดูประกาศเกี่ยวกับการเลิกใช้งานฟีเจอร์ที่สำคัญที่จะเกิดขึ้น

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

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

ในวันที่ 23 กุมภาพันธ์ 2026 Display &Video 360 จะหยุดให้บริการการกำหนดเป้าหมายของแคมเปญและใบสั่งซื้อการใส่โฆษณา เราจะทำการเปลี่ยนแปลง Display &Video 360 API และไฟล์ข้อมูลที่มีโครงสร้าง (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 ในทรัพยากร Advertiser ของ Display & Video 360 API หากฟิลด์นี้ตั้งค่าเป็น 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
  • ย้ายข้อมูลไปใช้ไฟล์ข้อมูลที่มีโครงสร้าง v9 และตั้งค่าคอลัมน์ Contains EU Political Ads สำหรับรายการโฆษณาใหม่เป็น Yes หรือ No เมื่ออัปโหลด ดูคำแนะนำในการย้ายข้อมูล v9 เพื่อดูวิธีการแบบทีละขั้นตอน
  • ก่อนที่จะอัปเดตการกำหนดเป้าหมายตามภูมิศาสตร์สำหรับรายการโฆษณาที่มีอยู่โดยใช้ Display &Video 360 API หรือ SDF ให้อัปเดตรายการโฆษณาเพื่อประกาศ
การตั้งค่าหมวดหมู่เนื้อหาสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์ 12 มิถุนายน 2025

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

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

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

โปรดทำดังนี้เพื่อไม่ให้การทำงานหยุดชะงัก
  • ใน API: ตรวจสอบว่า InsertionOrder หลักของรายการโฆษณามีการตั้งค่า bidStrategy.maximizeSpendAutoBid หรือ bidStrategy.performanceGoalAutoBid หรือไม่ หากมีการตั้งค่าไว้ อย่าพยายามอัปเดตฟิลด์งบประมาณ LineItem โดยใช้ advertisers.lineItems.patch
  • ใน SDF: ตรวจสอบว่ารายการ SDF สำหรับใบสั่งซื้อการใส่โฆษณาหลักของรายการโฆษณามี ใบสั่งซื้อการใส่โฆษณา มีคอลัมน์ Insertion Order Optimization ตั้งค่าเป็น TRUE หรือไม่ หากมีการตั้งค่าไว้ อย่าพยายามอัปเดตคอลัมน์ Budget Type หรือ Budget Amount สำหรับรายการ SDF ของ รายการโฆษณา
ข้อจำกัดของเว็บไซต์สำหรับไฟล์ข้อมูลที่มีโครงสร้าง 12 มิถุนายน 2025

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

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

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

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

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

โปรดทำดังนี้เพื่อไม่ให้การทำงานหยุดชะงัก

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

ในวันที่ 22 เมษายน 2025 คุณจะสร้างรายการโฆษณาสำหรับแคมเปญวิดีโอเพื่อกระตุ้นการกระทำโดยใช้ไฟล์ข้อมูลที่มีโครงสร้างไม่ได้อีกต่อไป เนื่องจากเรากำลังอัปเกรดเป็น 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 เวอร์ชันที่หยุดให้บริการ โปรดดูการเลิกใช้งานที่เก็บถาวร