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

อัปเดตล่าสุด: 06-12-2022

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

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

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

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

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

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

สำหรับ v2 ให้อัปเดต URL เป็น:

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

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

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

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

อัปเดตการเรียกวิธีการกำหนดเป้าหมาย

• ระบบจะกำหนดประเภทการกำหนดเป้าหมายบางประเภทโดยใช้ค่า enum แทนรหัสตัวเลือกการกำหนดเป้าหมาย เช่น ตอนนี้อุปกรณ์แท็บเล็ตจะกำหนดเป้าหมายโดยตรงด้วย enum ของ DEVICE_TYPE_TABLET DeviceType แทนที่จะเป็นรหัสตัวเลือกการกำหนดเป้าหมายจากบริการ targetingTypes.targetingOptions เวอร์ชันสตริงของ enum เหล่านี้จะแสดงในช่อง assignedTargetingOptionIdAlias ใหม่ในทรัพยากร AssignedTargetingOption และนำมาใช้เมื่อดึงหรือลบการกำหนดเป้าหมายที่มีอยู่ได้ ค่า assignedTargetingOptionId ของทรัพยากร AssignedTargetingOption เหล่านี้ไม่มีการเปลี่ยนแปลง

  อัปเดตการเรียกที่จัดการประเภทการกำหนดเป้าหมายต่อไปนี้เพื่อใช้ค่า enum

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• เมธอด advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions ถูกแทนที่ด้วยเมธอด advertisers.lineItems.bulkEditAssignedTargetingOptions

• เมธอด advertisers.lineItems.bulkListLineItemAssignedTargetingOptions ถูกแทนที่ด้วยเมธอด advertisers.lineItems.bulkListAssignedTargetingOptions

• อัปเดตการเรียกที่จัดการ TARGETING_TYPE_PROXIMITY_LOCATION_LIST เพื่อใช้ขนาดรัศมีและหน่วยระยะทางที่กำหนดไว้แทนค่า enum ของ ProximityRadiusRange

• มีการเปลี่ยนชื่อวิธีการกำหนดเป้าหมายที่ดึงหรือแก้ไขตัวเลือกการกำหนดเป้าหมายในการกำหนดเป้าหมายหลายประเภทภายใต้ทรัพยากรหลักรายเดียว

  อัปเดตการเรียกให้ใช้วิธีการต่อไปนี้เพื่อใช้ชื่อใหม่

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions ถึง advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions ถึง advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions ถึง advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions ถึง advertisers.insertionOrders.listAssignedTargetingOptions
  • partners.bulkEditPartnerAssignedTargetingOptions ถึง partners.editAssignedTargetingOptions

อัปเดตการโทรไปยังบริการ advertisers.lineItems

• นำช่อง inventorySourceIds ออกแล้ว จัดการการมอบหมายแหล่งที่มาของพื้นที่โฆษณาโดยใช้ทรัพยากร AssignedTargetingOption ของ TARGETING_TYPE_INVENTORY_SOURCE

• ค่า enum ของ LineItemWarningMessage ต่อไปนี้ได้เลิกใช้งานแล้วในเวอร์ชัน 2 และจะไม่แสดงใน LineItem.warningMessages อีกต่อไป

  • NO_POSITIVE_AUDIENCE_LIST_TARGETED
  • APP_INSTALL_NO_CONVERSION_PIXEL
  • TARGETING_REVOKED_OR_CLOSED_USER_LIST
  • APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
  • CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
  • NO_CREATIVE_FOR_TARGETED_DEALS
  • TARGETING_DEPRECATED_GEO_TARGET

• ระบบนำช่อง triggerId ออกจากออบเจ็กต์ LineItemFlight และนำค่า LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER ออกจากประเภท enum LineItemFlightDateType v2 ไม่รองรับการตั้งค่ารายการโฆษณาที่จะใช้จ่ายโดยอิงตามการเปิดใช้งานทริกเกอร์ที่กำหนดเอง

อัปเดตการโทรไปยังบริการ customBiddingAlgorithms

ช่อง customBiddingAlgorithmState และ modelReadiness ได้ถูกแทนที่ด้วยช่อง modelDetails ซึ่งมอบสถานะความพร้อมและการระงับของโมเดลอัลกอริทึมที่มีอยู่สำหรับผู้ลงโฆษณาแต่ละรายที่มีสิทธิ์เข้าถึงผ่านรายการออบเจ็กต์ CustomBiddingModelDetails

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

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

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

สิทธิ์การอ่านอย่างเดียวสำหรับรายการโฆษณา YouTube

ในเวอร์ชัน 2 รายการโฆษณา YouTube และการตั้งค่าการกำหนดเป้าหมายจะเรียกใช้ได้โดยใช้บริการ advertisers.lineItems และ advertisers.lineItems.targetingTypes.assignedTargetingOptions ตามลำดับ API ดังกล่าวให้สิทธิ์เข้าถึงแบบอ่านอย่างเดียว ซึ่งหมายความว่าคำขอเขียนที่พยายามดำเนินการไปยังรายการโฆษณาเหล่านี้จะแสดงผลเป็นข้อผิดพลาด รายการโฆษณา YouTube จะมีค่าใดค่าหนึ่งต่อไปนี้ LineItemType

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

วิธีการใหม่ๆ ที่ช่วยเพิ่มประสิทธิภาพให้ดียิ่งขึ้น

ในเวอร์ชัน 2 บริการ advertisers.lineItems มีวิธีใหม่ในการใช้แทนคำขอแบบกลุ่มเพื่อประสิทธิภาพที่ดีขึ้นและลดการใช้โควต้า

• คุณอาจใช้ advertisers.lineItems.bulkUpdate เพื่อกำหนดค่าในช่องเดียวกันสำหรับรายการโฆษณาหลายรายการ ขณะนี้รองรับเฉพาะการอัปเดตช่อง entityStatus เท่านั้น
• คุณใช้ advertisers.lineItems.bulkEditAssignedTargetingOptions เพื่อเพิ่มหรือนำตัวเลือกการกำหนดเป้าหมายที่มอบหมายเดียวกันออกจากรายการโฆษณาต่างๆ ได้
• คุณใช้ advertisers.lineItems.bulkListAssignedTargetingOptions เพื่อแสดงรายการตัวเลือกการกำหนดเป้าหมายที่กำหนดในรายการโฆษณาหลายรายการได้
• คุณใช้ advertisers.lineItems.duplicate เพื่อสร้างรายการซ้ำของรายการโฆษณาที่มีอยู่ภายในใบสั่งซื้อการใส่โฆษณาเดียวกันได้ เพื่อคัดลอกการกำหนดค่าและการตั้งค่าการกำหนดเป้าหมายทั้งหมด

สิทธิ์เขียนได้บางส่วนสำหรับการกำหนดเป้าหมายใบสั่งซื้อการใส่โฆษณา

ในเวอร์ชัน 2 คุณจะแก้ไขการตั้งค่าการกำหนดเป้าหมายย่อยสำหรับทรัพยากร InsertionOrder ได้โดยใช้เมธอด create และ delete ใหม่ในบริการ advertisers.insertionOrders.targetingTypes.assignedTargetingOptions คุณจัดการประเภทการกำหนดเป้าหมายต่อไปนี้ได้โดยสมบูรณ์ที่ระดับใบสั่งซื้อการใส่โฆษณา

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY