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

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

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

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

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

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

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

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

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

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

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

ฟีเจอร์	วันที่มีผลเริ่มต้น	คำอธิบาย
การขยายการกำหนดเป้าหมาย	25 มีนาคม 2023	การเปลี่ยนฟีเจอร์การขยายการกําหนดเป้าหมายเป็นการกําหนดเป้าหมายแบบเพิ่มประสิทธิภาพ ซึ่งจะทยอยเปิดตัวตั้งแต่วันที่ 25 มีนาคม 2023 ถึงต้นเดือนพฤษภาคม 2023 เราได้ประกาศการเปลี่ยนแปลงที่เกี่ยวข้องกับลักษณะการทํางานของ Display & Video 360 API และไฟล์ Structured Data รวมถึงการดําเนินการที่แนะนําไว้ในบล็อกโพสต์
ทริกเกอร์ที่กําหนดเอง	17 พฤษภาคม 2023	ลำดับเวลา: 17 พฤษภาคม 2023: รายการโฆษณาที่ใช้ทริกเกอร์ที่กําหนดเองจะหยุดแสดงใน Display & Video 360 หากคุณเปิดใช้งานทริกเกอร์ที่กําหนดเองซึ่งลิงก์กับรายการโฆษณาที่ใช้งานอยู่หลังจากวันที่ดังกล่าว รายการโฆษณาจะไม่แสดงโฆษณา 1 สิงหาคม 2023: บริการ advertisers.manualTriggers ใน DV360 API เวอร์ชัน 1 และ 2, ค่า LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER enum ใน DV360 API เวอร์ชัน 1 และช่อง LineItemFlight.triggerId ใน DV360 API เวอร์ชัน 1 จะหยุดให้บริการ หลังจากวันที่ดังกล่าว คำขอที่ส่งไปยังบริการหรือช่องเหล่านี้จะแสดงข้อผิดพลาด การดำเนินการที่แนะนำ: หยุดใช้ทริกเกอร์ที่กําหนดเองเพื่อเริ่มและหยุดการแสดงรายการโฆษณาทันที หยุดส่งคำขอไปยังบริการ advertisers.manualTriggers อัปเดตช่อง flight.flightDateType และ flight.triggerId สำหรับรายการโฆษณาทั้งหมดโดยใช้ทริกเกอร์ที่กำหนดเอง
ประเภทแอปที่ติดตั้งและอุปกรณ์เคลื่อนที่ใหม่ GoogleAudience	20 พฤษภาคม 2023	ลำดับเวลา: 20 พฤษภาคม 2023: คุณจะไม่สามารถกําหนดทรัพยากร GoogleAudience ที่มี GoogleAudienceType เป็น GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS หรือ GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES ให้กับการกําหนดเป้าหมายกลุ่มเป้าหมายของรายการโฆษณาหรือคําสั่งซื้อการแทรกได้อีกต่อไป คําขอมอบหมายกลุ่มเป้าหมายเหล่านี้ให้กับการกำหนดกลุ่มเป้าหมายของรายการโฆษณาจะแสดงข้อผิดพลาด ซึ่งรวมถึงคําขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault หากรายการโฆษณาที่สร้างขึ้นจะมีกลุ่มเป้าหมายที่เลิกใช้งานแล้วในการกําหนดกลุ่มเป้าหมาย 8 มิถุนายน 2023: ระบบจะนำกลุ่มเป้าหมายที่ได้รับผลกระทบออกจากการกำหนดเป้าหมายรายการโฆษณาและคำสั่งซื้อการแทรกโฆษณาทั้งหมด และจากกลุ่มเป้าหมายแบบรวมทั้งหมด หากรายการโฆษณาแสดงโฆษณาไม่ได้เมื่อนํากลุ่มเป้าหมายเหล่านี้ออก ระบบจะหยุดรายการโฆษณาชั่วคราว คุณจะเรียกข้อมูลกลุ่มเป้าหมายเหล่านี้โดยใช้บริการ googleAudiences ไม่ได้อีกต่อไปนับจากวันที่ดังกล่าว งานแนะนํา เราขอแนะนําให้คุณหยุดใช้กลุ่มเป้าหมายที่ได้รับผลกระทบทันทีเมื่อทำการอัปเดตการกําหนดเป้าหมายรายการโฆษณาในอนาคต นํากลุ่มเป้าหมายที่ได้รับผลกระทบทั้งหมดออกจากการกําหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาที่มีอยู่ อ่านเกี่ยวกับการอัปเดตการกำหนดกลุ่มเป้าหมายในคู่มือกลุ่มเป้าหมาย
ประเภทตามกิจกรรมและความถี่สูงสุด FirstAndThirdPartyAudience	20 พฤษภาคม 2023	ลำดับเวลา: 20 พฤษภาคม 2023: คุณจะไม่สามารถกําหนดทรัพยากร FirstAndThirdPartyAudience ที่มี AudienceType เป็น ACTIVITY_BASED หรือ FREQUENCY_CAP ให้กับการกําหนดเป้าหมายกลุ่มเป้าหมายของรายการโฆษณาหรือคําสั่งซื้อการแทรกได้อีกต่อไป คําขอมอบหมายกลุ่มเป้าหมายเหล่านี้ให้กับการกําหนดกลุ่มเป้าหมายของรายการโฆษณาจะแสดงข้อผิดพลาด ซึ่งรวมถึงคําขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault หากรายการโฆษณาที่สร้างขึ้นจะมีกลุ่มเป้าหมายที่เลิกใช้งานแล้วในการกําหนดกลุ่มเป้าหมาย 8 มิถุนายน 2023: ระบบจะนำกลุ่มเป้าหมายที่ได้รับผลกระทบออกจากการกำหนดเป้าหมายรายการโฆษณาและคำสั่งซื้อการแทรกโฆษณาทั้งหมด และจากกลุ่มเป้าหมายแบบรวมทั้งหมด หากรายการโฆษณาแสดงโฆษณาไม่ได้เมื่อนํากลุ่มเป้าหมายเหล่านี้ออก ระบบจะหยุดรายการโฆษณาชั่วคราว คุณจะเรียกข้อมูลกลุ่มเป้าหมายเหล่านี้โดยใช้บริการ firstAndThirdPartyAudiences ไม่ได้อีกต่อไปนับจากวันที่ดังกล่าว งานแนะนํา เราขอแนะนําให้คุณหยุดใช้กลุ่มเป้าหมายที่ได้รับผลกระทบทันทีเมื่อทำการอัปเดตการกําหนดเป้าหมายรายการโฆษณาในอนาคต นํากลุ่มเป้าหมายที่ได้รับผลกระทบทั้งหมดออกจากการกําหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาที่มีอยู่ อ่านเกี่ยวกับการอัปเดตการกำหนดกลุ่มเป้าหมายในคู่มือกลุ่มเป้าหมาย
ขีดจํากัดโควต้า API ที่มีอยู่	30 พฤษภาคม 2023	ในวันที่ 30 พฤษภาคม 2023 เราจะแทนที่ขีดจำกัดการใช้งานที่มีอยู่ด้วยโครงสร้างโควต้าแบบผสมซึ่งจะดำเนินการดังต่อไปนี้ ยกเลิกโควต้าคำขอต่อวันต่อโปรเจ็กต์ กำหนดโควต้าคำขอต่อนาทีต่อผู้ลงโฆษณาต่อโปรเจ็กต์สำหรับวิธีการที่มีคุณสมบัติตรงตามข้อกำหนด ขีดจํากัดใหม่เหล่านี้จะช่วยให้การใช้งาน API มีความยืดหยุ่นมากขึ้นและช่วยให้คําขอของผู้ลงโฆษณาทํางานแบบขนานกันได้ รายละเอียดของการเปลี่ยนแปลงนี้อยู่ในเอกสารเกี่ยวกับขีดจำกัดโควต้าที่มีอยู่
การใช้โอเปอเรเตอร์ OR ระหว่างข้อจํากัดของช่องต่างๆ ในตัวกรอง LIST อัปเดตวันที่มีผลเริ่มต้น	21 มิถุนายน 2023	ในวันที่ 21 มิถุนายน 2023 พารามิเตอร์LISTคําขอ filter จะไม่อนุญาตให้ใช้โอเปอเรเตอร์ตรรกะ OR ระหว่างข้อจํากัดของช่องต่างๆ อีกต่อไป ตัวอย่างเช่น ทรัพยากรที่ระบุด้วยสตริงตัวกรอง lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" จะต้องดึงข้อมูลโดยใช้คําขอ LIST 2 รายการที่มีสตริงตัวกรองต่อไปนี้แทน lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อจำกัดของโอเปอเรเตอร์เชิงตรรกะได้ในคู่มือวิธีการกรองคำขอ LIST โปรดตรวจสอบพารามิเตอร์การค้นหา filter ของคําเรียก LIST ที่มีอยู่ทั้งหมด และยืนยันว่าพารามิเตอร์ดังกล่าวใช้โอเปอเรเตอร์ตรรกะ OR อย่างถูกต้องก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก
ความสามารถในการกรองหรือจัดลำดับคำขอรายการตามฟิลด์ budget.budget_segments.date_range.end_date และ flight.dateRange.endDate วันที่มีผลเริ่มต้นอัปเดตแล้ว	21 มิถุนายน 2023	ในวันที่ 21 มิถุนายน 2023 ระบบจะไม่ยอมรับฟิลด์ budget.budget_segments.date_range.end_date และ flight.dateRange.endDate ในพารามิเตอร์การค้นหา filter และ orderBy ของ advertisers.insertionOrders.list และ advertisers.lineItems.list อีกต่อไป หลังจากวันที่ดังกล่าว คําขอที่ใช้ฟิลด์เหล่านี้ในพารามิเตอร์การค้นหา filter และ orderBy จะแสดงข้อผิดพลาด โปรดนําตัวกรองและตรรกะการจัดเรียงทั้งหมดออกโดยใช้ 2 ช่องนี้ก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก
ความสามารถในการกรองคำขอ advertisers.lineItems.list ตามช่องเพิ่มเติม 4 ช่อง	21 มิถุนายน 2023	ในวันที่ 21 มิถุนายน 2023 advertisers.lineItems.list จะไม่รองรับการกรองตามฟิลด์ต่อไปนี้อีกต่อไป flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages โปรดนําตรรกะตัวกรองทั้งหมดออกโดยใช้ช่อง 4 ช่องนี้ก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก
การซื้อที่อิงตามผลลัพธ์	1 สิงหาคม 2023	ในวันที่ 1 สิงหาคม 2023 ระบบจะเก็บคำสั่งซื้อที่แทรกโดยใช้การซื้อตามผลลัพธ์ซึ่งกำหนดโดยค่าในช่อง billableOutcome เป็น BILLABLE_OUTCOME_PAY_PER_CLICK หรือ BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION และรายการโฆษณาย่อยของคำสั่งซื้อดังกล่าว การเปลี่ยนแปลงนี้จะส่งผลต่อคำขอต่อไปนี้ การพยายามใช้ advertisers.insertionOrders.create เพื่อสร้างใบสั่งซื้อการใส่โฆษณาโดยใช้การซื้อที่อิงตามผลลัพธ์จะแสดงข้อผิดพลาด 400 การพยายามใช้ advertisers.lineItems.create, advertisers.lineItems.duplicate หรือ advertisers.lineItems.generateDefault เพื่อสร้างรายการโฆษณาในใบสั่งซื้อการใส่โฆษณาโดยใช้การซื้อที่อิงตามผลลัพธ์จะแสดงข้อผิดพลาด 400 เนื่องจากทรัพยากรที่เก็บถาวรจะไม่รวมอยู่ในคําขอ LIST โดยค่าเริ่มต้น ระบบจะไม่แสดงทรัพยากรที่ได้รับผลกระทบจากเมธอด advertisers.insertionOrders.list และ advertisers.lineItems.list อีกต่อไปโดยค่าเริ่มต้น
ช่อง publisherReviewStatuses ในแหล่งข้อมูลครีเอทีฟโฆษณา	26 มิถุนายน 2024	ตั้งแต่วันที่ 26 มิถุนายน 2024 เป็นต้นไป ช่อง publisherReviewStatuses จะหยุดให้บริการและจะว่างเปล่าเมื่อดึงข้อมูลทรัพยากร Creative
การกำหนดเป้าหมายตามเนื้อหาสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์	30 กันยายน 2024	ในวันที่ 30 กันยายน 2024 ค่าต่อไปนี้สำหรับประเภทการกำหนดเป้าหมายที่ระบุไว้จะหยุดให้บริการสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์ 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 CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO ระบบจะนำตัวเลือกการกำหนดเป้าหมายที่กำลังจะหยุดให้บริการออกจากการกำหนดเป้าหมายรายการโฆษณาที่มีอยู่โดยอัตโนมัติ ค่าเหล่านี้จะยังคงใช้งานได้ในการกําหนดเป้าหมายระดับผู้ลงโฆษณา โปรดนําการกําหนดเป้าหมายนี้ออกจากรายการโฆษณา YouTube และพาร์ทเนอร์ที่มีอยู่ก่อนวันที่หยุดให้บริการ เพื่อไม่ให้บริการหยุดชะงัก
กลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สามของ Oracle	30 กันยายน 2024	แหล่งที่มาของทรัพยากร FirstAndThirdPartyAudience จาก Oracle จะหยุดให้บริการในวันที่ 30 กันยายน 2024 เมื่อหยุดให้บริการ กลุ่มเป้าหมายเหล่านี้จะถูกนําออกจากการกำหนดเป้าหมายทรัพยากรที่มีอยู่และกลุ่มเป้าหมายแบบรวม หากรายการโฆษณากําหนดเป้าหมายเป็นกลุ่มเป้าหมายที่กำลังจะหยุดให้บริการเท่านั้น หรือกําหนดเป้าหมายเชิงลบเป็นกลุ่มเป้าหมายที่กำลังจะหยุดให้บริการ ระบบจะหยุดรายการโฆษณานั้นชั่วคราวโดยอัตโนมัติ โปรดระบุและนํากลุ่มเป้าหมาย Oracle ออกจากการกําหนดเป้าหมายตามกลุ่มเป้าหมายของบรรทัดรายการที่มีอยู่และกลุ่มเป้าหมายแบบรวมก่อนวันที่หยุดให้บริการ
การกำหนดเป้าหมายรายการโฆษณาที่เพิ่มประสิทธิภาพสำหรับกลยุทธ์การเสนอราคาชุดย่อย	30 กันยายน 2024	ในวันที่ 30 กันยายน 2024 ทรัพยากร LineItem ที่ใช้กลยุทธ์การเสนอราคาชุดย่อยจะใช้ร่วมกับการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพไม่ได้อีกต่อไป การเปลี่ยนแปลงนี้จะทำให้ระบบอัปเดตทรัพยากร LineItem ที่มีการตั้งค่า targetingExpansion.enableOptimizedTargeting เป็น True และ bidStrategy.maximizeSpendAutoBid.performanceGoalType เป็น BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN หรือ BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED หรือ bidStrategy.performanceGoalAutoBid.performanceGoalType เป็น BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM เป็นการตั้งค่า targetingExpansion.enableOptimizedTargeting เป็น False โปรดอัปเดตและยืนยันว่ารายการโฆษณาที่ใช้กลยุทธ์การเสนอราคาเหล่านี้ไม่ได้เปิดการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพไว้ เพื่อไม่ให้บริการหยุดชะงัก
เที่ยวบินโดยเร็วที่สุด Pacing สำหรับใบสั่งซื้อการใส่โฆษณา	5 พฤศจิกายน 2024	ในวันที่ 5 พฤศจิกายน 2024 PACING_TYPE_ASAP จะใช้ร่วมกับ PACING_PERIOD_FLIGHT ไม่ได้อีกต่อไปเมื่อตั้งค่าช่องคำสั่งการแทรก pacing ระบบจะอัปเดต pacingType ของคำสั่งซื้อที่แทรกที่มีอยู่ทั้งหมดที่ใช้การกำหนดค่านี้เป็น PACING_TYPE_AHEAD โปรดอัปเดต pacing ของคําสั่งซื้อการแทรกที่มีอยู่โดยใช้ PACING_TYPE_ASAP และ PACING_PERIOD_FLIGHT เพื่อไม่ให้บริการหยุดชะงัก
ระยะเวลาการเป็นสมาชิกแบบไม่จำกัดสําหรับกลุ่มเป้าหมายบุคคลที่หนึ่ง	7 เมษายน 2025	ในวันที่ 7 เมษายน 2025 แหล่งข้อมูล FirstAndThirdPartyAudience จะไม่อนุญาตให้สมาชิกกลุ่มเป้าหมายมีระยะเวลาการเป็นสมาชิกแบบไม่จำกัดอีกต่อไป คำขอ firstAndThirdPartyAudiences.create และ firstAndThirdPartyAudiences.patch การตั้งค่าค่าในช่อง membershipDurationDays เป็น 10,000 จะแสดงข้อผิดพลาด 400 กลุ่มเป้าหมายที่มีอยู่ซึ่งมีค่าในช่อง membershipDurationDays เป็น 10,000 จะอัปเดตเป็น 540 และระยะเวลาการเป็นสมาชิกใหม่จะมีผลย้อนหลังกับการเป็นสมาชิกที่มีอยู่ ซึ่งจะเป็นการทำให้การเป็นสมาชิกทั้งหมดที่มีอายุมากกว่า 540 วันหมดอายุ วิธีหลีกเลี่ยงการหยุดชะงักของบริการ ยืนยันว่าการผสานรวมไม่ได้ตั้งค่าฟิลด์ membershipDurationDays ของกลุ่มเป้าหมายใหม่หรือที่มีอยู่เป็น 10,000 รีเฟรชการเป็นสมาชิกของกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้าที่มีอยู่โดยใช้ firstAndThirdPartyAudiences.editCustomerMatchMembers รีเฟรชการเป็นสมาชิกกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าเป็นประจำเพื่อให้แน่ใจว่าขนาดรายการกลุ่มเป้าหมายจะไม่ลดลงโดยไม่ตั้งใจ