ย้ายข้อมูลจาก 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 เป็นดังนี้

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

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

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

เราจะนำการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบมาใช้ในเวอร์ชัน 2 โปรดตรวจสอบสิ่งต่อไปนี้ ดำเนินการเปลี่ยนแปลงที่จำเป็นที่เกี่ยวข้องกับการใช้งาน ดิสเพลย์และ API ของวิดีโอ 360

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

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

ในเวอร์ชัน 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 service. จัดการการกำหนดเป้าหมายประเภทต่อไปนี้ได้โดยสมบูรณ์ที่การแทรก ระดับการสั่งซื้อ:

• 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