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

Необязательно. Обмен предоставленными идентификаторами издателя. Каждый идентификатор должен быть уникальным и соответствовать идентификатору издателя, отправленному в запросах на ставки .

Максимум 10. Максимум 100 символов на идентификатор. Допустимые символы: буквы, цифры, подчеркивание, тире и точка.

displayName

string

Обязательно. Отображаемое имя этого издателя. Должно быть в кодировке UTF-8 с максимальным размером 30 символов.

status

enum ( DiscoveryObjectStatus )

Обязательно. Статус этого издателя. Издатели со статусом PAUSED или REMOVED не отображаются для рекламодателей DV3.

mediumCapability

enum ( MediumCapability )

Обязательно. Медиа, на которых этот издатель планирует размещать свою рекламу.

description

string

Обязательно. Текст описания для этого издателя. Должен быть в кодировке UTF-8 с максимальным размером 1000 символов. Обязательно.

contactInfo[]

string

Обязательно. Контактные адреса электронной почты для связи рекламодателей с издателем. Максимум 10 контактов. Максимум 100 символов для каждого контакта. Пример: [Контакт в США - Джон Смит: 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 )

Необязательно. Ниже представлены группы, членом которых является владелец, если таковые имеются.

СреднийВозможность

Средний уровень возможностей enum. Интерфейс Marketplace (в модуле Inventory Module DV360) включает различные разделы для инвентаря. "Цифровой: Сюда входят пакеты издателей и аукционов, охватывающие инвентарь Display, Video (включая CTV и OTT) и Audio". "Телевидение: Это наш недавно запущенный специальный раздел для поиска инвентаря CTV и OTT. CTV и OTT определяются следующим образом: "Подключенный телевизор (CTV) включает все устройства, которые соответствуют следующим описаниям: - Подключенные или потоковые устройства: Устройства, которые подключаются к экрану телевизора для отображения видеопотоков (Roku, Apple TV и т. д.) - Smart TV: Телевизоры со встроенным подключением к Интернету (Samsung Smart TV и т. д.) - Игровые консоли: Игровые консоли с подключением к Интернету (Xbox, PlayStation, Wii и т. д.) - Телевизионные приставки: Устройства, доставляющие традиционный кабельный и видеоконтент по запросу". "Over the Top (OTT) означает видеоконтент, подобный телевизионному, доставляемый поставщиком видео через Интернет за пределами закрытых сетей поставщиков телекоммуникационных и кабельных услуг. OTT-видео можно просматривать на настольном компьютере, мобильном телефоне, планшете, а также на устройствах CTV или STB (при условии, что для последнего контент доставляется по IP). «Аудио: Это недавно запущенный, специальный раздел для аудиоинвентаря». «OOH: Цифровые издатели наружной рекламы».

Перечисления
MEDIUM_CAPABILITY_UNSPECIFIED Средняя способность не указана. Недопустимый ввод.
MEDIUM_CAPABILITY_DIGITAL Цифровая, средней мощности.
MEDIUM_CAPABILITY_TV Телевизор средней мощности.
MEDIUM_CAPABILITY_AUDIO Звук средней мощности.
MEDIUM_CAPABILITY_OOH Средняя производительность вне дома.

ОбязательствоВозможность

Перечисление возможностей обязательства.

Перечисления
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.

TVТипДоставки

Тип доставки ТВ перечисление.

Перечисления
TV_DELIVERY_TYPE_UNSPECIFIED Тип доставки ТВ не указан. Недопустимый ввод.
TV_DELIVERY_TYPE_CTV Тип доставки ТВ: подключенный телевизор.
TV_DELIVERY_TYPE_LINEAR_TV Тип доставки ТВ: линейное ТВ.

Методы

create

 Создает нового издателя.

get

 Находит издателя.

list

 Список издателей.

patch

 Обновляет издателя.
Загрузить логотип издателя.