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

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

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

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

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

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

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

เวอร์ชัน 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 เราได้ประกาศการเปลี่ยนแปลงที่เกี่ยวข้องในลักษณะการทำงานของ API ของ Display & Video 360 และไฟล์ข้อมูลที่มีโครงสร้าง รวมทั้งการดำเนินการที่แนะนำในบล็อกโพสต์
ทริกเกอร์ที่กำหนดเอง	17 พฤษภาคม 2023	ไทม์ไลน์: 17 พฤษภาคม 2023: รายการโฆษณาที่ใช้ทริกเกอร์ด้วยตนเองจะหยุดแสดงใน Display & Video 360 หากคุณเปิดใช้งานทริกเกอร์ด้วยตนเองที่ลิงก์กับรายการโฆษณาที่ใช้งานอยู่หลังจากวันที่ดังกล่าว รายการโฆษณาจะไม่แสดงโฆษณา 1 สิงหาคม 2023: บริการ advertisers.manualTriggers ใน DV360 API v1 และ v2, ค่า enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER ใน DV360 API v1 และช่อง LineItemFlight.triggerId ใน DV360 API v1 จะหยุดให้บริการ หลังจากวันที่ดังกล่าว คำขอที่ส่งไปยังบริการเหล่านี้หรือกรอกข้อมูลในช่องเหล่านี้จะแสดงผลข้อผิดพลาด การดำเนินการที่แนะนำ หยุดใช้ทริกเกอร์ด้วยตนเองเพื่อเริ่มและหยุดการแสดงรายการโฆษณาทันที หยุดส่งคำขอไปยังบริการ 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 พารามิเตอร์ filter ของคำขอ LIST จะไม่อนุญาตให้ใช้โอเปอเรเตอร์เชิงตรรกะ 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 ในพารามิเตอร์การค้นหา advertisers.insertionOrders.list และ advertisers.lineItems.list filter และ orderBy ตามลำดับอีกต่อไป หลังจากวันที่ดังกล่าว คำขอที่ใช้ช่องเหล่านี้ในพารามิเตอร์การค้นหาของ 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 อีกต่อไปโดยค่าเริ่มต้น