REST Resource: exchanges.publishers

ทรัพยากร: ผู้เผยแพร่โฆษณา

ห่อหุ้มผู้เผยแพร่โฆษณารายเดียว

การแสดง JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อเส้นทางสัมพัทธ์สำหรับผู้เผยแพร่โฆษณารายนี้ ควรอยู่ในรูปแบบ "exchanges/{seller_id}/publishers/{publisherId}" เช่น "exchanges/1234/publishers/5678"
externalPublisherId

string

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

สูงสุด 100 อักขระ อักขระที่อนุญาตคือตัวอักษรและตัวเลขคละกัน ขีดล่าง ขีดกลาง และจุด
externalPublisherIds[]

string

ไม่บังคับ รหัสผู้เผยแพร่โฆษณาที่ตลาดซื้อขายโฆษณาให้ไว้ รหัสแต่ละรหัสต้องไม่ซ้ำกันและตรงกับรหัสผู้เผยแพร่โฆษณาที่ส่งในคำขอราคาเสนอ

สูงสุด 10 รายการ สูงสุด 100 อักขระต่อรหัส อักขระที่อนุญาตคือตัวอักษรและตัวเลขคละกัน ขีดล่าง ขีดกลาง และจุด
displayName

string

ต้องระบุ ชื่อที่แสดงของผู้เผยแพร่โฆษณารายนี้ ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 30 อักขระ
status

enum (DiscoveryObjectStatus)

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

enum (MediumCapability)

ต้องระบุ สื่อที่ผู้เผยแพร่โฆษณารายนี้วางแผนที่จะโฮสต์โฆษณา
description

string

ต้องระบุ ข้อความคำอธิบายสำหรับผู้เผยแพร่โฆษณารายนี้ ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 1,000 อักขระ
contactInfo[]

string

ต้องระบุ อีเมลจุดติดต่อสำหรับผู้ลงโฆษณาเพื่อสื่อสารกับผู้เผยแพร่โฆษณา สูงสุด 10 รายชื่อติดต่อ รายชื่อติดต่อแต่ละรายการยาวสูงสุด 100 อักขระ ตัวอย่าง: [US contact - John Smith: john.smith@abc.com]
commitmentCapability[]

enum (CommitmentCapability)

ไม่บังคับ ประเภทการคอมมิตที่ผู้เผยแพร่โฆษณารายนี้รองรับ
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

เอาต์พุตเท่านั้น URL ของโลโก้ของผู้เผยแพร่โฆษณารายนี้
floorPrice

object (Money)

ไม่บังคับ ราคาพื้นของผู้เผยแพร่โฆษณารายนี้ ต้องมีรหัสสกุลเงินเดียวกันกับราคาเพดาน
ceilingPrice

object (Money)

ไม่บังคับ ราคาเพดานของผู้เผยแพร่โฆษณารายนี้ ต้องมีรหัสสกุลเงินเดียวกันกับราคาพื้น
generalCapability

string

ไม่บังคับ คำอธิบายทั่วไปในรูปแบบข้อความอิสระ ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 200 อักขระ คำอธิบายนี้อาจเป็น SOV(ส่วนแบ่งของเสียงในตลาด), CPD, การรับประกันปริมาณ คำอธิบายตัวอย่าง: "CPD, ผลกระทบสูง, การมองเห็นเฉลี่ย 69%"
tvMetadata

object (TVMetadata)

ไม่บังคับ ข้อมูลเมตาสำหรับผู้เผยแพร่โฆษณาที่มีข้อเสนอทีวี ต้องระบุเมื่อความสามารถของสื่อมีทีวี ไม่สามารถใช้ได้เมื่อความสามารถของสื่อไม่มีทีวี
urgOwners[]

enum (UnderRepresentedGroup)

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

MediumCapability

Enum ความสามารถของสื่อ ส่วนหน้าของ Marketplace (ภายในโมดูลพื้นที่โฆษณาของ DV360) มีส่วนต่างๆ สำหรับพื้นที่โฆษณา "ดิจิทัล: ซึ่งรวมถึงผู้เผยแพร่โฆษณาและแพ็กเกจการประมูลที่ครอบคลุมพื้นที่โฆษณา Display, วิดีโอ (รวมถึง CTV และ OTT) และเสียง" "ทีวี: นี่คือส่วนเฉพาะที่เปิดตัวใหม่สำหรับการค้นหาพื้นที่โฆษณา CTV และ OTT เรากำหนด CTV และ OTT ไว้ดังนี้ "ทีวีที่เชื่อมต่ออินเทอร์เน็ต (CTV) รวมถึงอุปกรณ์ทั้งหมดที่เป็นไปตามคำอธิบายต่อไปนี้ - อุปกรณ์ที่เชื่อมต่อหรืออุปกรณ์สตรีมมิง: อุปกรณ์ที่เชื่อมต่อกับหน้าจอทีวีเพื่อแสดงสตรีมวิดีโอ (Roku, Apple TV ฯลฯ) - สมาร์ททีวี: ทีวีที่มีการเชื่อมต่ออินเทอร์เน็ต (Samsung Smart TV ฯลฯ) - คอนโซลเกม: คอนโซลเกมที่เชื่อมต่ออินเทอร์เน็ต (Xbox, PlayStation, Wii ฯลฯ) - Set-top box: อุปกรณ์ที่แสดงเนื้อหาเคเบิลดั้งเดิมและวิดีโอตามคำขอ" "Over the Top (OTT) หมายถึงเนื้อหาวิดีโอคล้ายทีวีที่ผู้ให้บริการวิดีโอส่งผ่านอินเทอร์เน็ตภายนอกเครือข่ายปิดของผู้ให้บริการโทรคมนาคมและเคเบิล" คุณสามารถดูวิดีโอ OTT บนเดสก์ท็อป มือถือ แท็บเล็ต รวมถึงอุปกรณ์ CTV หรือ STB (ตราบใดที่เนื้อหาแสดงผ่าน IP สำหรับอุปกรณ์หลัง) "เสียง: นี่คือส่วนเฉพาะที่เปิดตัวใหม่สำหรับพื้นที่โฆษณาเสียง" "OOH: ผู้เผยแพร่โฆษณาสื่อดิจิทัลนอกบ้าน"

Enum
MEDIUM_CAPABILITY_UNSPECIFIED ไม่ได้ระบุความสามารถของสื่อ อินพุตไม่ถูกต้อง
MEDIUM_CAPABILITY_DIGITAL ความสามารถของสื่อดิจิทัล
MEDIUM_CAPABILITY_TV ความสามารถของสื่อทีวี
MEDIUM_CAPABILITY_AUDIO ความสามารถของสื่อเสียง
MEDIUM_CAPABILITY_OOH ความสามารถของสื่อนอกบ้าน

CommitmentCapability

Enum ความสามารถในการคอมมิต

Enum
COMMITMENT_CAPABILITY_UNSPECIFIED ไม่ได้ระบุความสามารถในการคอมมิต อินพุตไม่ถูกต้อง
COMMITMENT_CAPABILITY_GUARANTEED ผู้เผยแพร่โฆษณามีพื้นที่โฆษณาที่รับประกันการแสดงผล
COMMITMENT_CAPABILITY_NON_GUARANTEED ผู้เผยแพร่โฆษณามีพื้นที่โฆษณาที่ไม่รับประกันการแสดงผล

TVMetadata

ข้อมูลเมตาสำหรับผู้เผยแพร่โฆษณาที่มีข้อเสนอทีวี

การแสดง JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
ช่อง
tvDeliveryType

enum (TVDeliveryType)

ต้องระบุ ประเภทการแสดงโฆษณาทางทีวี
topShows[]

string

ไม่บังคับ รายการชื่อรายการทีวียอดนิยมที่เป็นของผู้เผยแพร่โฆษณา ขนาดสูงสุด 10 รายการ ต้องเข้ารหัส UTF-8

TVDeliveryType

Enum ประเภทการแสดงโฆษณาทางทีวี

Enum
TV_DELIVERY_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทการแสดงโฆษณาทางทีวี อินพุตไม่ถูกต้อง
TV_DELIVERY_TYPE_CTV ประเภทการแสดงโฆษณาทางทีวีที่เชื่อมต่ออินเทอร์เน็ต
TV_DELIVERY_TYPE_LINEAR_TV ประเภทการแสดงโฆษณาทางทีวีแบบดั้งเดิม

เมธอด

create

 สร้างผู้เผยแพร่โฆษณารายใหม่

get

 รับผู้เผยแพร่โฆษณา

list

 แสดงรายการผู้เผยแพร่โฆษณา

patch

 อัปเดตผู้เผยแพร่โฆษณา
อัปโหลดโลโก้ผู้เผยแพร่โฆษณา