REST Resource: exchanges.auctionPackages

แหล่งข้อมูล: AuctionPackage

ห่อหุ้มแพ็กเกจการประมูลรายการเดียว ผู้ลงโฆษณาใน DV3 สามารถเรียกดูแพ็กเกจการประมูลทั้งหมดใน DV3 ผ่าน UI การค้นพบมาร์เก็ตเพลส และเลือกใช้แพ็กเกจเหล่านี้ได้โดยไม่ต้องดำเนินการใดๆ จากผู้ขาย

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
ช่อง
name

string

ตัวระบุ ชื่อเส้นทางสัมพัทธ์สำหรับแพ็กเกจการประมูลนี้ ควรอยู่ในรูปแบบ "exchanges/{seller_id}/auctionpackages/{auction_package_id} เช่น "exchanges/1234/auctionPackage/5678" เอาต์พุตเท่านั้น
displayName

string

ต้องระบุ ชื่อที่แสดงของแพ็กเกจการประมูลนี้ ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ตัวอักษร ต้องระบุ
status

enum (DiscoveryObjectStatus)

ต้องระบุ สถานะของแพ็กเกจการประมูลนี้ ระบบจะไม่แสดงแพ็กเกจที่มีสถานะหยุดชั่วคราวหรือนำออกต่อผู้ลงโฆษณา DV3 ต้องระบุ
description

string

ต้องระบุ ข้อความคำอธิบายสำหรับแพ็กเกจนี้ ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 2,000 ตัวอักษร ต้องระบุ
format

enum (Format)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทรูปแบบโฆษณาพื้นฐาน ต้องระบุ ไม่อนุญาตให้อัปเดตหลังจากสร้าง
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

ไม่บังคับ รายละเอียดการคาดการณ์สำหรับพื้นที่โฆษณาของแพ็กเกจการประมูลนี้ ผู้ลงโฆษณา DV3 สามารถดูและกรองการแบ่งย่อยเหล่านี้ได้ ไม่บังคับ
externalDealId

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสดีลของ Exchange ที่ใช้ในคำขอเสนอราคา สูงสุด 100 ตัวอักษร อักขระที่อนุญาตคือตัวอักษรและตัวเลขคละกัน ขีดล่าง ขีดกลาง และจุด ต้องระบุ ต้องระบุ ไม่อนุญาตให้อัปเดตหลังจากสร้าง
logoUrl

string

เอาต์พุตเท่านั้น URL ของโลโก้สำหรับแพ็กเกจการประมูลนี้

เอาต์พุตเท่านั้น
floorPrice

object (Money)

ต้องระบุ ราคาขั้นต่ำของแพ็กเกจการประมูลนี้ ต้องระบุ
startTime

string (Timestamp format)

ต้องระบุ เวลาที่ผลิตภัณฑ์นี้เริ่มใช้งาน ต้องก่อนเวลาสิ้นสุด เวลาเริ่มต้นต้องไม่เกิน 1 ปีนับจากปัจจุบัน ต้องระบุ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

ต้องระบุ เวลาที่ผลิตภัณฑ์นี้หยุดใช้งาน ต้องระบุ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
mediumType

enum (MediumType)

ต้องระบุ ประเภทสื่อของแพ็กเกจการประมูล
urgOwners[]

enum (UnderRepresentedGroup)

ไม่บังคับ กลุ่มที่ได้รับการนำเสนอไม่เพียงพอซึ่งเจ้าของเป็นสมาชิก (หากมี)
dv3MarketplaceUri

string

เอาต์พุตเท่านั้น ลิงก์ Dv360 สำหรับแพ็กเกจการประมูลในมาร์เก็ตเพลส

รูปแบบ

รูปแบบโฆษณาสำหรับแพ็กเกจการประมูล

Enum
DEAL_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบดีล ไม่ถูกต้องสำหรับอินพุต
DEAL_FORMAT_DISPLAY รูปแบบ Display
DEAL_FORMAT_VIDEO รูปแบบวิดีโอ
DEAL_FORMAT_AUDIO รูปแบบเสียง

เมธอด

create

 สร้างแพ็กเกจการประมูลใหม่

get

 รับแพ็กเกจการประมูล

list

 แสดงรายการแพ็กเกจการประมูล

patch

 อัปเดตแพ็กเกจการประมูล
อัปโหลดโลโก้สำหรับแพ็กเกจที่ระบุ