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

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

string

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

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

object (Money)

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

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 รูปแบบการแสดงผล
DEAL_FORMAT_VIDEO รูปแบบวิดีโอ
DEAL_FORMAT_AUDIO รูปแบบเสียง

เมธอด

create

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

get

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

list

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

patch

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