อัปเดตล่าสุด: 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
ออกจากประเภท enumLineItemFlightDateType
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