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

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

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

ฟีเจอร์	วันที่เริ่มต้นที่มีผล	คำอธิบาย
การจัดการการกำหนดเป้าหมายแคมเปญและใบสั่งซื้อการใส่โฆษณาใน 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 หากมีการเรียกใช้ 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 รายการ 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 ในทรัพยากร LineItem ของ Display & Video 360 API คุณยังประกาศนี้ได้โดยใช้ฟิลด์ใหม่ในคำขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault ใช้คอลัมน์ Contains EU Political Ads ในประเภทไฟล์รายการโฆษณา SDF v9 หากผู้ลงโฆษณาหลักไม่มีรายการโฆษณาที่แสดงโฆษณาทางการเมืองในสหภาพยุโรป คุณสามารถประกาศที่ระดับผู้ลงโฆษณาโดยใช้ฟิลด์ 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 เป็นต้นไป คุณจะอัปเดตการตั้งค่างบประมาณสำหรับรายการโฆษณาที่มีใบสั่งซื้อเพื่อการแทรกที่เป็นระดับบนสุดซึ่งตั้งค่าให้เพิ่มประสิทธิภาพโดยใช้กลยุทธ์การเสนอราคาอัตโนมัติไม่ได้อีกต่อไป หากไม่ต้องการให้บริการหยุดชะงัก ให้ทำดังนี้ ใน API: ตรวจสอบว่าInsertionOrderหลักของรายการโฆษณามีการตั้งค่า bidStrategy.maximizeSpendAutoBid หรือ bidStrategy.performanceGoalAutoBid หรือไม่ หากเป็นเช่นนั้น อย่าพยายามอัปเดตช่องงบประมาณ LineItem โดยใช้ advertisers.lineItems.patch ใน SDF: ตรวจสอบว่ารายการ SDF สำหรับใบสั่งซื้อการใส่โฆษณาหลักของรายการโฆษณามีการตั้งค่าคอลัมน์ Insertion Order Optimization เป็น TRUE หรือไม่ หากเป็นเช่นนั้น อย่าพยายามอัปเดตคอลัมน์ Budget Type หรือ Budget Amount สำหรับรายการ SDF ของรายการโฆษณา
ข้อจำกัดของเว็บไซต์สำหรับไฟล์ Structured Data	12 มิถุนายน 2025	ตั้งแต่วันที่ 12 มิถุนายน 2025 เป็นต้นไป เราจะนำข้อจำกัดที่มีอยู่สำหรับ URL ที่กำหนดเป้าหมายในรายการ SDF ซึ่งจำกัดไม่ให้รวมเว็บไซต์ใหม่กว่าออก แต่ SDF จะจับคู่ลักษณะการทำงานของ API และ UI และอนุญาตให้กำหนดเป้าหมาย URL ตราบใดที่ 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 คำขอ advertisers.lineItems.create ที่พยายามตั้งค่าฟิลด์ floodlightActivityConfigs ของออบเจ็กต์ ConversionCountingConfig และฟิลด์ customBiddingAlgorithmId ของออบเจ็กต์ MaximizeSpendBidStrategy หรือ PerformanceGoalBidStrategy ที่ไม่ได้ใช้กิจกรรม Floodlight ที่ตรงกันจะแสดงข้อผิดพลาด 400 คำขอ advertisers.lineItems.patch ที่พยายามอัปเดตฟิลด์ floodlightActivityConfigs ของออบเจ็กต์ ConversionCountingConfig ขณะที่ตั้งค่าฟิลด์ customBiddingAlgorithmId ของออบเจ็กต์ MaximizeSpendBidStrategy หรือ PerformanceGoalBidStrategy จะแสดงข้อผิดพลาด 400 รายการในไฟล์ข้อมูลที่มีโครงสร้างของรายการโฆษณาที่พยายามอัปเดตคอลัมน์ "รหัสกิจกรรม Floodlight ของ Conversion" เมื่อตั้งค่าคอลัมน์ "รหัสอัลกอริทึม" จะอัปเดตไม่สำเร็จเมื่ออัปโหลดไฟล์ คำขอ customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create สำหรับแหล่งข้อมูล CustomBiddingAlgorithm ที่กำหนดให้กับรายการโฆษณาจะแสดงข้อผิดพลาด โปรดอัปเดตการผสานรวมเป็น ตรวจสอบว่าได้กําหนดกิจกรรม Floodlight ที่เกี่ยวข้องให้กับรายการโฆษณาแล้วก่อนหรือในเวลาเดียวกับการกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเอง ระบบจะยกเลิกการกำหนดอัลกอริทึมการเสนอราคาที่กำหนดเองที่มีอยู่จากรายการโฆษณาทั้งหมดก่อนที่จะพยายามอัปเดต

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

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