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 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[]. Ad Exchange đã cung cấp mã nhận dạng nhà xuất bản duy nhất. Phải khớp với mã nhận dạng 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 sử dụng là chữ-số, dấu gạch dưới, dấu gạch nối 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ã 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 giá thầu.

Tối đa 10 lần đếm. Tối đa 100 ký tự cho mỗi mã nhận dạng. Các ký tự được phép sử dụng là chữ-số, dấu gạch dưới, dấu gạch nối 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 ĐÃ TẠM DỪNG hoặc ĐÃ XOÁ sẽ không xuất hiện cho nhà quảng cáo DV3.
mediumCapability

enum (MediumCapability)

Bắt buộc. Nội dung nghe nhì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ự. Bắt buộc.
contactInfo[]

string

Bắt buộc. Email của đầu mối liên hệ để nhà quảng cáo trao đổi với nhà xuất bản. Tối đa 10 người liên hệ. Mỗi người liên hệ có tối đa 100 ký tự. Ví dụ: [Người liên hệ tại Hoa Kỳ – John Smith: john.smith@abc.com]. Bắt buộc.
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 cho 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 những bảng chi tiết này. Bạn phải cung cấp bảng chi tiết về thông tin dự đoán về 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.
tvMetadata

object (TVMetadata)

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

enum (UnderRepresentedGroup)

Không bắt buộc. Các nhóm thiểu số mà chủ sở hữu là thành viên (nếu có).

MediumCapability

Enum chức năng trung bình. Giao diện người dùng của trang web Thị trường (trong Mô-đun khoảng không quảng cáo của DV360) bao gồm nhiều phần dành cho khoảng không quảng cáo. "Kỹ thuật số: 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à phần mới ra mắt dành riêng cho việc khám phá khoảng không quảng cáo trên CTV và OTT. CTV và OTT được xác định 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". "Trực tuyến (OTT) là nội dung video giống như TV do nhà cung cấp video phân phối qua Internet bên ngoài mạng khép kín của nhà cung cấp dịch vụ viễn thông và truyền hình cáp. Video OTT có thể xem được 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ị STB). "Âm thanh: Đây là một phần mới ra mắt, chuyên dành cho khoảng không quảng cáo dạng âm thanh". "OOH: Nhà xuất bản kỹ thuật số ngoài trời".

Enum
MEDIUM_CAPABILITY_UNSPECIFIED Chưa xác định chức năng trung bình. Dữ liệu đầu vào không hợp lệ.
MEDIUM_CAPABILITY_DIGITAL Khả năng kỹ thuật số trung bình.
MEDIUM_CAPABILITY_TV TV có chức 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 chỉ định khả năng cam kết. Dữ liệu đầ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 cho những 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 hình phân phối quảng cáo trên TV.
topShows[]

string

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

TVDeliveryType

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

Enum
TV_DELIVERY_TYPE_UNSPECIFIED Chưa chỉ định loại hình phân phối trên TV. Dữ liệu đầu vào không hợp lệ.
TV_DELIVERY_TYPE_CTV Loại hình phân phối TV: TV thông minh.
TV_DELIVERY_TYPE_LINEAR_TV Loại hình phân phối quảng cáo trên TV: 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ê nhà xuất bản.

patch

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