REST Resource: exchanges.publishers

Tài nguyên: Nhà xuất bản

Đóng gói một nhà xuất bản duy nhất.

Biểu diễn dưới dạng 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)
  ]
}
Trường
name

string

Chỉ có đầu ra. Tên tuyến đường tương đối cho nhà xuất bản này. Phải có dạng: "exchanges/{seller_id}/publishers/{publisherId} Ví dụ: "exchanges/1234/publishers/5678".
externalPublisherId

string

Bắt buộc. [KHÔNG DÙNG NỮA] Trường này sẽ sớm được thay thế bằng externalPublisherIds[]. Mã nhận dạng duy nhất của nhà xuất bản do Sàn giao dịch cung cấp. Phải khớp với mã nhà xuất bản được gửi trong yêu cầu giá thầu.

Tối đa 100 ký tự. Các ký tự được phép là chữ và số, dấu gạch dưới, dấu gạch ngang và dấu chấm.
externalPublisherIds[]

string

Không bắt buộc. Mã nhận dạng nhà xuất bản do sàn giao dịch cung cấp. Mỗi mã nhận dạng phải là duy nhất và khớp với mã nhận dạng nhà xuất bản được gửi trong yêu cầu đặt giá thầu.

Tối đa 10 lần. Tối đa 100 ký tự cho mỗi mã nhận dạng. Các ký tự được phép là chữ và số, dấu gạch dưới, dấu gạch ngang và dấu chấm.
displayName

string

Bắt buộc. Tên hiển thị của nhà xuất bản này. Phải được mã hoá UTF-8 với kích thước tối đa là 30 ký tự.
status

enum (DiscoveryObjectStatus)

Bắt buộc. Trạng thái của nhà xuất bản này. Nhà xuất bản có trạng thái PAUSED (TẠM DỪNG) hoặc REMOVED (ĐÃ XOÁ) sẽ không xuất hiện với nhà quảng cáo DV3.
mediumCapability

enum (MediumCapability)

Bắt buộc. Phương tiện mà nhà xuất bản này dự định lưu trữ quảng cáo của họ.
description

string

Bắt buộc. Văn bản mô tả cho nhà xuất bản này. Phải được mã hoá UTF-8 với kích thước tối đa là 1.000 ký tự.
contactInfo[]

string

Bắt buộc. Email của đầu mối liên hệ để nhà quảng cáo liên lạc với nhà xuất bản. Tối đa 10 người liên hệ. Mỗi thông tin liên hệ tối đa 100 ký tự. Ví dụ: [Người liên hệ ở Hoa Kỳ – John Smith: john.smith@abc.com].
commitmentCapability[]

enum (CommitmentCapability)

Không bắt buộc. Các loại cam kết mà nhà xuất bản này hỗ trợ.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Bắt buộc. Bảng chi tiết dự báo về khoảng không quảng cáo của nhà xuất bản này. Nhà quảng cáo DV3 có thể xem và lọc theo các thông tin chi tiết này. Bạn phải cung cấp bảng chi tiết về dự báo theo miền.
logoUrl

string

Chỉ có đầu ra. URL của biểu trưng của nhà xuất bản này.
floorPrice

object (Money)

Không bắt buộc. Giá sàn của nhà xuất bản này. Phải có cùng mã đơn vị tiền tệ với giá trần.
ceilingPrice

object (Money)

Không bắt buộc. Giá trần của nhà xuất bản này. Phải có cùng mã đơn vị tiền tệ với giá sàn.
generalCapability

string

Không bắt buộc. Mô tả chung ở dạng văn bản tự do. Phải được mã hoá UTF-8 với kích thước tối đa là 200 ký tự. Nội dung mô tả này có thể là SOV(Thị phần khoảng không quảng cáo), CPD, cam kết về số lượng. Ví dụ về nội dung mô tả: "CPD, Mức tác động cao, 69% khả năng hiển thị trung bình"
tvMetadata

object (TVMetadata)

Không bắt buộc. Siêu dữ liệu dành cho nhà xuất bản có nội dung truyền hình. Bắt buộc khi khả năng phương tiện có chứa TV. Không áp dụng khi phương tiện có khả năng không chứa TV.
urgOwners[]

enum (UnderRepresentedGroup)

Không bắt buộc. Các nhóm chưa được đại diện mà chủ sở hữu là thành viên (nếu có).

MediumCapability

Liệt kê các chức năng của phương tiện. Giao diện người dùng của Marketplace (trong Mô-đun khoảng không quảng cáo của DV360) có nhiều mục cho khoảng không quảng cáo. "Kỹ thuật số: Danh mục này bao gồm các nhà xuất bản và gói đấu giá trên khoảng không quảng cáo Hiển thị, Video (bao gồm cả CTV và OTT) và Âm thanh." "TV: Đây là mục chuyên biệt mới ra mắt của chúng tôi để khám phá khoảng không quảng cáo trên CTV và OTT. CTV và OTT được định nghĩa như sau: "TV kết nối Internet (CTV) bao gồm tất cả các thiết bị khớp với nội dung mô tả như sau: – Thiết bị có thể nối mạng hoặc thiết bị truyền phát trực tuyến: Thiết bị kết nối với màn hình TV để hiển thị các luồng video (Roku, Apple TV, v.v.) – TV thông minh: TV tích hợp sẵn khả năng kết nối với Internet (TV thông minh Samsung, v.v.) – Máy chơi trò chơi: Máy chơi trò chơi có kết nối Internet (Xbox, PlayStation, Wii, v.v.) – Hộp giải mã tín hiệu số: Thiết bị truyền tải nội dung truyền hình cáp truyền thống và video theo yêu cầu." "Over the Top (OTT) là nội dung video tương tự như nội dung truyền hình, do một nhà cung cấp video phân phối qua Internet bên ngoài mạng khép kín của các nhà cung cấp dịch vụ viễn thông và truyền hình cáp. Bạn có thể xem video OTT trên máy tính, thiết bị di động, máy tính bảng, cũng như thiết bị CTV hoặc STB (miễn là nội dung được phân phối qua IP cho thiết bị sau). "Âm thanh: Đây là một phần riêng biệt mới ra mắt dành cho khoảng không quảng cáo âm thanh." "OOH: Nhà xuất bản quảng cáo kỹ thuật số ngoài trời."

Enum
MEDIUM_CAPABILITY_UNSPECIFIED Chưa xác định khả năng của phương tiện. Thông tin đầu vào không hợp lệ.
MEDIUM_CAPABILITY_DIGITAL Thiết bị kỹ thuật số có khả năng trung bình.
MEDIUM_CAPABILITY_TV TV có khả năng trung bình.
MEDIUM_CAPABILITY_AUDIO Âm thanh có khả năng trung bình.
MEDIUM_CAPABILITY_OOH Khả năng trung bình khi ở ngoài nhà.

CommitmentCapability

Enum về khả năng cam kết.

Enum
COMMITMENT_CAPABILITY_UNSPECIFIED Chưa xác định khả năng cam kết. Thông tin đầu vào không hợp lệ.
COMMITMENT_CAPABILITY_GUARANTEED Nhà xuất bản có khoảng không quảng cáo được đảm bảo.
COMMITMENT_CAPABILITY_NON_GUARANTEED Nhà xuất bản có khoảng không quảng cáo không được đảm bảo.

TVMetadata

Siêu dữ liệu dành cho nhà xuất bản có nội dung truyền hình.

Biểu diễn dưới dạng JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Trường
tvDeliveryType

enum (TVDeliveryType)

Bắt buộc. Loại phân phối của quảng cáo truyền hình.
topShows[]

string

Không bắt buộc. Danh sách các tựa chương trình truyền hình hàng đầu thuộc quyền sở hữu của nhà xuất bản. Kích thước tối đa là 10. Phải được mã hoá theo UTF-8.

TVDeliveryType

Enum loại phân phối TV.

Enum
TV_DELIVERY_TYPE_UNSPECIFIED Chưa chỉ định loại hình phân phối truyền hình. Thông tin đầu vào không hợp lệ.
TV_DELIVERY_TYPE_CTV Loại phân phối trên TV là TV thông minh.
TV_DELIVERY_TYPE_LINEAR_TV Loại phân phối truyền hình truyền thống.

Phương thức

create

 Tạo một nhà xuất bản mới.

get

 Lấy một nhà xuất bản.

list

 Liệt kê các nhà xuất bản.

patch

 Cập nhật một nhà xuất bản.
Tải biểu trưng của nhà xuất bản lên.