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

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

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

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

อัปเดตการเรียก API จากเวอร์ชัน 2 เป็นเวอร์ชัน 3

หากต้องการใช้ 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 โปรดตรวจสอบสิ่งต่อไปนี้ ดำเนินการเปลี่ยนแปลงที่จำเป็นที่เกี่ยวข้องกับการใช้งาน ดิสเพลย์และ API ของวิดีโอ 360

  • ทรัพยากร 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 ใหม่

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

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

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

นอกจากการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบข้างต้น v3 ยังมีการเพิ่ม ใหม่ๆ

คุณลักษณะที่เพิ่มไปยัง v3 หลังจากการเปิดตัวครั้งแรกสามารถพบได้ในรุ่นของเรา หมายเหตุ

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

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

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

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

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