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[] ในเร็วๆ นี้ รหัสผู้เผยแพร่โฆษณาที่ไม่ซ้ำซึ่ง Exchange ระบุ ต้องตรงกับรหัสผู้เผยแพร่โฆษณาที่ส่งในคำขอราคาเสนอ

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

string

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

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

string

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

enum (DiscoveryObjectStatus)

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

enum (MediumCapability)

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

string

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

string

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

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

เอาต์พุตเท่านั้น URL ของโลโก้ผู้จัดพิมพ์รายนี้
floorPrice

object (Money)

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

object (Money)

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

string

ไม่บังคับ
tvMetadata

object (TVMetadata)

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

enum (UnderRepresentedGroup)

ไม่บังคับ ในกลุ่มที่เจ้าของเป็นสมาชิกอยู่ (หากมี)

MediumCapability

Medium capability enum หน้าเว็บมาร์เก็ตเพลส (ภายในโมดูลพื้นที่โฆษณาของ DV360) ประกอบด้วยส่วนต่างๆ สําหรับพื้นที่โฆษณา "ดิจิทัล: ซึ่งรวมถึงผู้เผยแพร่โฆษณาและแพ็กเกจการประมูลที่ครอบคลุมพื้นที่โฆษณา Display, วิดีโอ (รวมถึง CTV และ OTT) และเสียง" "ทีวี: ส่วนนี้เป็นส่วนที่เพิ่งเปิดตัวใหม่เพื่อค้นหาพื้นที่โฆษณา CTV และ OTT CTV และ OTT มีคำจำกัดความดังนี้ "ทีวีที่เชื่อมต่ออินเทอร์เน็ต (CTV) รวมถึงอุปกรณ์ทั้งหมดที่เป็นไปตามคำอธิบายต่อไปนี้ - อุปกรณ์ที่เชื่อมต่อหรืออุปกรณ์สตรีมมิง: อุปกรณ์ที่เชื่อมต่อกับหน้าจอทีวีเพื่อแสดงสตรีมวิดีโอ (Roku, Apple TV ฯลฯ) - สมาร์ททีวี: ทีวีที่มีการเชื่อมต่ออินเทอร์เน็ต (Samsung Smart TV ฯลฯ) - คอนโซลเกม: คอนโซลเกมที่เชื่อมต่ออินเทอร์เน็ต (Xbox, PlayStation, Wii ฯลฯ) - กล่องรับสัญญาณ: อุปกรณ์ที่แสดงเนื้อหาเคเบิลดั้งเดิมและวิดีโอออนดีมานด์" "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
COMMITMENT_CAPABILITY_UNSPECIFIED ไม่ได้ระบุความสามารถของ Commitment อินพุตไม่ถูกต้อง
COMMITMENT_CAPABILITY_GUARANTEED ผู้เผยแพร่โฆษณามีพื้นที่โฆษณาที่รับประกัน
COMMITMENT_CAPABILITY_NON_GUARANTEED ผู้เผยแพร่โฆษณามีพื้นที่โฆษณาที่ไม่รับประกันการแสดงผล

TVMetadata

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

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

enum (TVDeliveryType)

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

string

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

TVDeliveryType

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

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

เมธอด

create

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

get

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

list

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

patch

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