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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ตอนนี้การกำหนดประเภทการกําหนดเป้าหมายบางประเภทจะใช้ค่า enum แทนรหัสตัวเลือกการกําหนดเป้าหมาย ตัวอย่างเช่น ตอนนี้ระบบกําหนดเป้าหมายอุปกรณ์แท็บเล็ตโดยตรงด้วย Enum DeviceType DEVICE_TYPE_TABLET แทนรหัสตัวเลือกการกําหนดเป้าหมายจากบริการ 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 ต่อไปนี้เลิกใช้งานแล้วใน v2 และจะไม่แสดงใน 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 แบบอ่านอย่างเดียว

ใน v2 คุณจะเรียกข้อมูลรายการโฆษณา 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

วิธีการใหม่ที่ช่วยเพิ่มประสิทธิภาพ

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

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

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

ใน v2 คุณสามารถแก้ไขการตั้งค่าการกําหนดเป้าหมายชุดย่อยสําหรับทรัพยากร 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