ย้ายข้อมูลจาก Display & Video 360 API v4 ไปเป็น v5

อัปเดตล่าสุด: 22-10-2026

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

ย้ายข้อมูลแอปพลิเคชัน

การย้ายข้อมูลจาก v4 ไปยัง v5 ต้องอัปเดต URL ปลายทางเพื่อเรียกใช้ v5, อัปเดตแอปพลิเคชันเพื่อพิจารณาการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ และตรวจสอบฟีเจอร์ใหม่ๆ ที่อาจเป็นประโยชน์ต่อการผสานรวม

อัปเดตการเรียก API จาก v4 เป็น v5

หากต้องการใช้ v5 แทน v4 คุณต้องอัปเดตคำขอเพื่อใช้ปลายทาง v5 ใหม่

เช่น หากต้องการเรียกใช้เมธอด advertisers.get ด้วย v4 ให้ใช้ URL ต่อไปนี้

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

สำหรับ v5 ให้อัปเดต URL เป็นดังนี้

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

หากใช้ไลบรารีของไคลเอ็นต์เพื่อส่งคำขอไปยัง API ให้ใช้ไลบรารีของไคลเอ็นต์เวอร์ชันล่าสุดและอัปเดตการกำหนดค่าเพื่อใช้ v5

ทำการเปลี่ยนแปลงที่จำเป็น

Display & Video 360 API v5 มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายอย่าง โปรดอ่านวิธีการต่อไปนี้และทำการเปลี่ยนแปลงที่จำเป็นซึ่งเกี่ยวข้องกับการใช้ Display & Video 360 API ที่มีอยู่

ดูรายการความแตกต่างทั้งหมดระหว่าง Display & Video 360 API v4 กับ v5 ได้ที่บันทึกประจำรุ่น

อัปเดตการดึงข้อมูลและการกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณาเพื่อใช้รหัสและประเภทใหม่

Display & Video 360 API v5 เปลี่ยนวิธีดึงข้อมูลและกำหนดเป้าหมายดีลแหล่งที่มาของพื้นที่โฆษณาและแพ็กเกจการประมูล

ใน v4 ทรัพยากร InventorySource ที่ดึงข้อมูลโดยใช้บริการ inventorySources จะแสดงทั้งดีลแหล่งที่มาของพื้นที่โฆษณาและแพ็กเกจการประมูล ทั้งดีลและแพ็กเกจการประมูลจะได้รับการกำหนดเป้าหมายโดยใช้ TARGETING_TYPE_INVENTORY_SOURCE

ใน v5 ระบบจะจัดการดีลแหล่งที่มาของพื้นที่โฆษณาและแพ็กเกจการประมูลแยกกัน ดังนี้

• ดีลแหล่งที่มาของพื้นที่โฆษณาจะได้รับการกำหนดเป้าหมายโดยใช้ TARGETING_TYPE_INVENTORY_SOURCE_DEAL, ดึงข้อมูลโดยใช้บริการ advertisers.inventorySources และ partners.inventorySources และกำหนดเป้าหมายโดยใช้ฟิลด์ AssignedTargetingOption inventorySourceDetails
• แพ็กเกจการประมูลจะกำหนดเป้าหมายโดยใช้ TARGETING_TYPE_AUCTION_PACKAGE, ดึงข้อมูลโดยใช้บริการ targetingTypes.targetingOptions และกำหนดเป้าหมายโดยใช้ฟิลด์ AssignedTargetingOption auctionPackageDetails

การอัปเดตนี้จะเปลี่ยนรหัสที่ใช้สำหรับดีลและแพ็กเกจการประมูลที่มีอยู่ คุณจึงไม่สามารถใช้รหัสทรัพยากร InventorySource ที่แคชไว้ก่อนหน้านี้หลังจากการย้ายข้อมูล

นอกจากการเปลี่ยนแปลงเหล่านี้แล้ว v5 ยังนำความสามารถในการสร้าง อัปเดต และแก้ไขตัวช่วยเข้าถึงของแหล่งที่มาของพื้นที่โฆษณาออกด้วย

อัปเดตตรรกะการกำหนดกลุ่มเป้าหมายสำหรับแหล่งข้อมูล Demand Gen และ YouTube

Display & Video 360 API v5 อัปเดตตรรกะการกำหนดกลุ่มเป้าหมายสำหรับทรัพยากร Demand Gen และ YouTube เพื่อใช้ตัวเลือกที่กำหนดแต่ละรายการสำหรับรายการกลุ่มเป้าหมายที่กำหนดเป้าหมายแต่ละรายการ

ใน v4 การกำหนดกลุ่มเป้าหมายทั้งหมดจะได้รับการจัดการโดยใช้ TARGETING_TYPE_AUDIENCE_GROUP

ใน v5 การกำหนดกลุ่มเป้าหมายที่กำหนดให้กับกลุ่มโฆษณา Demand Gen และกลุ่มโฆษณา YouTube จะได้รับการจัดการโดยใช้ประเภทการกำหนดเป้าหมายและช่องทรัพยากร AssignedTargetingOption อย่างใดอย่างหนึ่งต่อไปนี้ ทั้งนี้ขึ้นอยู่กับประเภทกลุ่มเป้าหมาย

• TARGETING_TYPE_COMBINED_AUDIENCE โดยใช้ combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST โดยใช้ customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE โดยใช้ firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE โดยใช้ googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE โดยใช้ lookalikeAudienceDetails

รายการโฆษณาจะยังคงใช้ TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption รายการเดียวเพื่อจัดการการกำหนดกลุ่มเป้าหมายสำหรับทุกประเภท

อัปเกรดเป็น Data Manager API สำหรับการจัดการกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

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

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

หากต้องการจัดการกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าต่อไป ให้อัปเกรดเวิร์กโฟลว์เพื่อใช้ Data Manager API

เพิ่มการรองรับการดึงข้อมูลใบสั่งซื้อการใส่โฆษณาสำหรับสื่อดิจิทัลนอกบ้าน

Display & Video 360 API v5 เพิ่มการรองรับการดึงข้อมูลใบสั่งซื้อการใส่โฆษณาสำหรับสื่อดิจิทัลนอกบ้าน

หากผู้ลงโฆษณาใช้การโฆษณาสื่อดิจิทัลนอกบ้าน ให้อัปเกรดการผสานรวมที่เรียกใช้ advertisers.insertionOrders.list เพื่อเตรียมพร้อมสำหรับการรวมทรัพยากร InsertionOrder ที่มีค่าฟิลด์ insertionOrderType เป็น OUT_OF_HOME

ใน v5 รายการโฆษณาภายใต้ใบสั่งซื้อการใส่โฆษณาสื่อดิจิทัลนอกบ้านจะยังคงเรียกข้อมูลได้เหมือนใน v4

อัปเดตการอ้างอิงจาก Adloox เป็น Peer39

ใน v5 ช่องและค่า enum ที่อ้างอิงการผสานรวมความเหมาะสมกับแบรนด์ของบุคคลที่สามใน Display & Video 360 กับ Adloox (หรือที่เรียกว่า Scope3) ได้รับการอัปเดตเป็น Peer39 ดังนี้

• ThirdPartyVerifierAssignedTargetingOptionDetails ช่อง adloox ถูกแทนที่ด้วย peer39
• ค่า enum PARTNER_COST_TYPE_ADLOOX และ PARTNER_COST_TYPE_ADLOOX_PREBID ของ PartnerCostType ถูกแทนที่ด้วย PARTNER_COST_TYPE_PEER39 และ PARTNER_COST_TYPE_PEER39_PREBID

อัปเดตช่องสำหรับรายการโฆษณา กลุ่มโฆษณา และโฆษณา YouTube

ใน v5 มีการนำช่องต่างๆ ในทรัพยากร LineItem, AdGroup และ AdGroupAd ออกหรืออัปเดต อัปเดตตรรกะการดึงข้อมูลทรัพยากรเพื่อรองรับการเปลี่ยนแปลงเหล่านี้

ในแหล่งข้อมูล LineItem ให้ทำดังนี้

• relatedVideoIds ช่อง YoutubeAndPartnersSettings ถูกแทนที่ด้วย relatedVideos

ในแหล่งข้อมูล LineItem และ AdGroup ให้ทำดังนี้

• TargetingExpansionConfig นำช่อง audienceExpansionSeedListExcluded และ audienceExpansionLevel ออกแล้ว

ในแหล่งข้อมูล AdGroupAd ให้ทำดังนี้

• เพิ่มช่อง containsSyntheticMedia แล้ว
• ฟิลด์ trackingUrl ในออบเจ็กต์ AudioAd, CommonInStreamAttribute และ VideoPerformanceAd ถูกแยกออกเป็น 2 ฟิลด์ ได้แก่ trackingUrl และ userSpecifiedTrackingUrl เพื่อแยกความแตกต่างระหว่าง URL ที่ใช้สำหรับการติดตามกับ URL ติดตามที่ผู้ใช้ระบุ

นำการอ้างอิงถึงค่า enum ที่เลิกใช้งานแล้วออก

ใน v5 ระบบได้นำค่า enum ที่เลิกใช้งานก่อนหน้านี้ออกอย่างสมบูรณ์แล้ว แม้ว่าการใช้ค่าเหล่านี้ในคำขอไปยัง API จะส่งผลให้เกิดข้อผิดพลาดใน v4 แต่การเปลี่ยนแปลงนี้จะนำการอ้างอิงค่าเหล่านี้ออกจากไลบรารีของไคลเอ็นต์ v5 การอ้างอิงค่าที่เลิกใช้งานเหล่านี้ในโค้ดอาจทำให้เกิดข้อผิดพลาดเมื่ออัปเกรดเป็น v5

ประเภท Enum ที่มีค่าที่ได้รับผลกระทบ ได้แก่ ContentRatingTier, GoogleAudienceType, SdfVersion และ SensitiveCategory ดูรายการค่า enum ทั้งหมดที่ถูกนำออกได้ในบันทึกประจำรุ่น

ตรวจสอบฟีเจอร์ใหม่

นอกจากการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบแล้ว v5 ยังเปิดตัวฟีเจอร์ใหม่ต่อไปนี้ด้วย

• การจัดการการกำหนดเป้าหมายการยกเว้นวิดีโอและช่อง YouTube อย่างเต็มรูปแบบที่ระดับผู้ลงโฆษณาภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_YOUTUBE_VIDEO และ TARGETING_TYPE_YOUTUBE_CHANNEL ใน v4 การกำหนดเป้าหมายนี้เป็นแบบอ่านอย่างเดียว
• ความสามารถในการสร้างแหล่งข้อมูลสื่อดิจิทัลนอกบ้าน InsertionOrder
• การรองรับกลุ่มโฆษณาที่ใช้ครีเอทีฟโฆษณาที่กำหนดเพื่อสร้างโฆษณาผ่านการเพิ่มช่อง AdGroup adSource และ creativeAssignments และช่อง AdGroupAd parentCreativeId
• ความสามารถในการสร้างและเรียกข้อมูลทรัพยากร LookalikeAudience
• ช่อง containsSyntheticMedia ใหม่ในทรัพยากร AdGroupAd