ย้ายข้อมูลจาก v2 ไปยัง v3

อัปเดตล่าสุด: 2023-10-31

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

การย้ายข้อมูลจาก v2 ไปยัง v3 ต้องมีการอัปเดต URL ปลายทางเพื่อเรียกใช้ v3 และ อัปเดตแอปพลิเคชันเพื่อรองรับการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง

อัปเดตการเรียก API จาก v2 เป็น v3

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

ตัวอย่างเช่น หากต้องการเรียกใช้เมธอด advertisers.get ด้วย v2 คุณจะต้อง ใช้ URL ต่อไปนี้

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

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

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

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

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

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

  • เราได้แทนที่ทรัพยากร YoutubeAdGroup และ YoutubeAdGroupAd ด้วยทรัพยากร AdGroup และ AdGroupAd แหล่งข้อมูลใหม่เหล่านี้มีข้อมูลที่แทบจะเหมือนกับแหล่งข้อมูล v2 แต่ อาจใช้ชื่อฟิลด์หรือประเภท Enum ที่อัปเดตแล้ว ในการผสานรวม ให้แทนที่การใช้ทรัพยากร YoutubeAdGroup หรือ YoutubeAdGroupAd ด้วยทรัพยากร AdGroup และ AdGroupAd แล้วอัปเดตการเรียกใช้บริการ v2 ต่อไปนี้เป็นบริการ v3 ที่เกี่ยวข้อง
  • การอ้างอิงถึงออบเจ็กต์ YoutubeAndPartnersBiddingStrategy ได้ย้ายไปไว้ในฟิลด์ youtubeAndPartnersBid ใหม่ ภายในออบเจ็กต์ BiddingStrategy ทั่วไปแล้ว ระบบนำฟิลด์ biddingStrategyออกจากออบเจ็กต์ YoutubeAndPartnersSettingsแล้ว อัปเดตการผสานรวมเพื่อ เรียกกลยุทธ์การเสนอราคาสำหรับรายการโฆษณาหรือกลุ่มโฆษณา YouTube จากออบเจ็กต์ BiddingStrategy ในฟิลด์ bidStrategy ในแหล่งข้อมูล LineItem หรือ AdGroup
  • เปลี่ยนชื่อฟิลด์ thirdPartyMeasurementSettings เป็น thirdPartyMeasurementConfigs ในออบเจ็กต์ YoutubeAndPartnersSettings และเปลี่ยนชื่อออบเจ็กต์ YoutubeAndPartnersThirdPartyMeasurementSettings เป็น ThirdPartyMeasurementConfigs อัปเดตการผสานรวมเพื่อ เรียกข้อมูลการกำหนดค่าการวัดผลของบุคคลที่สามโดยใช้ฟิลด์และออบเจ็กต์ใหม่

รวมการกำหนดค่าการเรียกเก็บเงินที่จำเป็นเมื่อสร้างผู้ลงโฆษณา

ตอนนี้ billingConfig เป็นช่องที่ต้องระบุในแหล่งข้อมูลAdvertiser อัปเดตคำขอ advertisers.create เพื่อยืนยันว่าได้ตั้งค่าช่องนี้แล้ว คุณสามารถเรียกข้อมูลการเรียกเก็บเงินเริ่มต้นสำหรับพาร์ทเนอร์หลักได้ผ่านฟิลด์Partner ทรัพยากรใหม่ billingConfig

ใช้ช่องใหม่เพื่อควบคุมการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ

ฟิลด์บูลีน enableOptimizedTargeting ใหม่ได้แทนที่ฟิลด์ targetingExpansionLevel ในออบเจ็กต์ TargetingExpansionConfig แล้ว

อัปเดตการผสานรวมใบสั่งซื้อการใส่โฆษณาเพื่อใช้ช่อง KPI ใหม่

ฟิลด์ kpi ใหม่ได้แทนที่ฟิลด์ performanceGoal ใน แหล่งข้อมูล InsertionOrder แล้ว ฟิลด์ใหม่นี้ใช้Kpi ออบเจ็กต์แทนออบเจ็กต์ PerformanceGoal และใช้ฟิลด์และ Enum ใหม่

นำการอ้างอิงถึงบริการและฟิลด์ที่เลิกใช้งานแล้วออก

เราได้นำเอนทิตีต่างๆ ออกใน v3 เพื่อให้สอดคล้องกับการเลิกใช้งานฟีเจอร์ที่ผ่านมา

การเปลี่ยนแปลงเพิ่มเติม

นอกจากเบรกกิ้งเชนจ์ที่ระบุไว้ข้างต้นแล้ว v3 ยังมีฟีเจอร์ใหม่ๆ ด้วย

ฟีเจอร์ที่เพิ่มลงใน v3 หลังจากเปิดตัวครั้งแรกจะอยู่ในหมายเหตุ ประจำรุ่น

การจัดการรายการสถานที่ใกล้เคียง

ใน v3 คุณจะจัดการรายการสถานที่ใกล้เคียงได้อย่างเต็มที่ ซึ่งจะช่วยให้คุณ ใช้บริการ advertisers.locationLists.assignedLocations เพื่อ สร้างและลบสถานที่ที่กำหนดให้กับทรัพยากร TARGETING_LOCATION_TYPE_PROXIMITY LocationList ได้ ระบบจะระบุสถานที่โดยใช้รหัสของทรัพยากร TARGETING_TYPE_POI TargetingOption โดยสามารถ ดึงข้อมูลเหล่านี้ได้โดยใช้ targetingTypes.targetingOptions.search

ความสามารถในการสร้างอัลกอริทึมการเสนอราคาที่กําหนดเองตามกฎ

ใน v3 คุณสามารถสร้างและเรียกอัลกอริทึมการเสนอราคาที่กําหนดเองตามกฎโดยใช้บริการ customBiddingAlgorithms, media และ customBiddingAlgorithms.rules

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