ย้ายข้อมูลจากเวอร์ชัน 3 ไปยังเวอร์ชัน 4

อัปเดตล่าสุด: 2025-07-31

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

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

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

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

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

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

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

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

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

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

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

อัปเดตการเรียกเกี่ยวกับแหล่งข้อมูลกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สาม รวมถึงการกำหนดเป้าหมายที่เกี่ยวข้อง

ระบบได้แทนที่ทรัพยากร FirstAndThirdPartyAudience ด้วยทรัพยากร FirstPartyAndPartnerAudience แล้ว

การเปลี่ยนแปลงนี้กำหนดให้คุณต้องอัปเดตสิ่งต่อไปนี้

  • การอ้างอิงถึงทรัพยากร FirstAndThirdPartyAudience เพื่อใช้ทรัพยากรใหม่ FirstPartyAndPartnerAudience
  • คำขอที่มีอยู่ไปยังเมธอดในบริการ v3 firstAndThirdPartyAudiences ไปยังบริการ v4 ใหม่ firstPartyAndPartnerAudiences
  • คาดการณ์ขนาดหน้าเริ่มต้นสำหรับคำขอ firstPartyAndPartnerAudiences.list จาก 100 ถึง 5,000 รายการ
  • การอ้างอิงฟิลด์ firstAndThirdPartyAudienceType ของ v3 ไปยังฟิลด์ firstPartyAndPartnerAudienceType ใหม่ของ v4 โดยใช้ ประเภทแจกแจง FirstPartyAndPartnerAudienceType ใหม่ โดยมี ค่าเก่าที่สอดคล้องกับค่าใหม่ต่อไปนี้
    • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY ถึง TYPE_FIRST_PARTY
    • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY ถึง TYPE_PARTNER

  • การอ้างอิงถึงค่า enum AudienceType LICENSED เพื่อใช้ค่าใหม่ที่เฉพาะเจาะจงมากขึ้นต่อไปนี้แทน

    • THIRD_PARTY
    • COMMERCE
    • LINEAR

  • การอ้างอิงถึงทรัพยากร AssignedTargetingOption ของ TargetingType TARGETING_TYPE_AUDIENCE_GROUP เพื่อแทนที่ ฟิลด์ v3 ใน AudienceGroupAssignedTargetingOptionDetails ด้วย ฟิลด์ v4 ใหม่ต่อไปนี้

อัปเดตคำขอการกำหนดเป้าหมายรายการแบบกลุ่มของกลุ่มโฆษณาที่มีอยู่

เปลี่ยนชื่อ advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions เป็น advertisers.adGroups.bulkListAssignedTargetingOptions แล้ว อัปเดตคำขอที่มีอยู่ให้ใช้ชื่อเมธอดใหม่

ระบุวัตถุประสงค์การเพิ่มประสิทธิภาพเมื่อสร้างใบสั่งซื้อการใส่โฆษณา

ตอนนี้ optimizationObjective เป็นช่องที่ต้องระบุในแหล่งข้อมูลInsertionOrder อัปเดตคำขอ advertisers.insertionOrders.createเพื่อยืนยันว่าได้ตั้งค่าฟิลด์นี้แล้ว

นำการอ้างอิงฟิลด์ทรัพยากรครีเอทีฟโฆษณา publisherReviewStatuses ออก

เราได้นำฟิลด์ publisherReviewStatuses ออกจากออบเจ็กต์ ReviewStatusInfo ภายใต้แหล่งข้อมูล Creative หลังจากเลิกใช้งานในเดือนมิถุนายน 2024