REST Resource: exchanges.inventorySources

Ресурс: InventorySource

Модель исполнения источника инвентаря DV360.

JSON-представление 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Поля
name

string

Только вывод. Относительное имя ресурса для заказа. Сгенерировано сервером. Пример: "exchanges/1234/inventorySources/5678".

buyerStatus

enum ( BuyerStatus )

Только вывод. Статус покупателя.

sellerStatus

enum ( SellerStatus )

Статус продавца.

transactionType

enum ( TransactionType )

Только вывод. Тип транзакции продукта.

pricingType

enum ( PricingType )

Только вывод. Тип ценообразования для продукта.

rateDetails

object ( RateDetails )

Только вывод. Подробности оценки.

startTime

string ( Timestamp format)

Только вывод. Время, когда этот продукт станет активным. Должно быть раньше endTime. Время начала не может быть более чем на 1 год в будущем.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

endTime

string ( Timestamp format)

Только вывод. Время, когда этот продукт становится неактивным.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

Биржа предоставила ежедневный прогноз объема. Используется для определения темпа и включения выбора покупателя. Это поле устарело.

audienceMatchRate

number

Только вывод. Прогнозируемый коэффициент соответствия аудитории для гарантированных программных сделок с таргетингом на аудиторию, используемый биржей для определения количества дополнительных запросов, которые следует отправить. Это десятичное число от 0 до 1, обратная величина которого должна использоваться в качестве множителя для показов. 0 указывает на то, что поле не задано и, следовательно, не имеет таргетинга на аудиторию. Пример: «0,125». Это указывает на то, что 12,5% запросов соответствуют таргетингу на аудиторию, а количество отправленных запросов должно быть в 8 раз больше согласованных показов.

makegoodRequested

boolean

Только вывод. Указывает, была ли запрошена компенсация от покупателя.

makegoodRequestedReason

string

Только вывод. Причина, по которой запрашивается компенсация, указана покупателем.

percentFrequencyCapExcludedTraffic

string ( int64 format)

Процент трафика, исключенного из ограничения частоты для гарантированной программной сделки. Это целое число от 0 до 100. Значение 0 (также значение по умолчанию) указывает на отсутствие исключения, и поэтому весь трафик имеет право на ограничение частоты. 100 указывает на полное исключение, и поэтому ограничение частоты не применяется. Значения от 0 до 100 приведут к частичному исключению. Например, значение 20 приведет к исключению 20% трафика из ограничения частоты.

dv360WseatId[]

string ( int64 format)

Только вывод. Wseats, которые в настоящее время имеют разрешение на источник инвентаря.

lastModifiedTime

string ( Timestamp format)

Только вывод. Последнее время обновления источника инвентаря. Обратите внимание, что некоторые внутренние обновления DV3 изменят время последнего изменения.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

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

Статус покупателя

Статус покупателя.

Перечисления
BUYER_STATUS_UNSPECIFIED Статус покупателя не указан. Недопустимое входное значение.
BUYER_STATUS_ACTIVE Статус покупателя активен. Позиция назначена, назначен действительный креатив.
BUYER_STATUS_PENDING Статус покупателя: ожидание. Этот статус означает, что сделка не активна и покупателю необходимо предпринять определенные действия.
BUYER_STATUS_PAUSED Статус покупателя: приостановлено покупателем.

Статус продавца

Статус продавца.

Перечисления
SELLER_STATUS_UNSPECIFIED Статус продавца не указан. Неожиданный, указывает на то, что статус переговоров неизвестен. Недопустимое входное значение.
SELLER_STATUS_ACTIVE Статус продавца активен. Источник инвентаря активен на стороне биржи.
SELLER_STATUS_PAUSED Статус продавца приостановлен.

ИнвентарьИсточникОбъемПрогноз

Прогноз объема ежедневных запросов для источника инвентаря. Применяются следующие правила проверки: - запись должна быть предоставлена ​​для каждого дня недели - объем должен быть неотрицательным - timeZoneId является обязательным и должен быть действительным

JSON-представление 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Поля
dailyVolumes[]

object ( DailyVolume )

Прогноз ежедневных объемов.

timeZoneId

string

Часовой пояс базы данных часовых поясов IANA, например, «Америка/Нью-Йорк», который используется для ежедневных объемов.

ЕжедневныйОбъем

Запрос объема для источника инвентаря на определенный день.

JSON-представление 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Поля
day

enum ( DayOfWeek )

День недели, к которому относится объем запроса.

volume

string ( int64 format)

Прогнозируемый объем запросов на данный день недели.

ДеньНедели

Обозначает день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

CreativeApprovalConfig

Конфигурация для одобрения креатива.

JSON-представление 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Поля
requiresExchangeApproval

boolean

Обязательно. Указывает, требуется ли для креатива предварительное одобрение на уровне биржи.

publisherConfigs[]

object ( PublisherConfig )

Необязательно. Конфигурация для издателя.

Конфигурация издателя

Конфигурация для издателя (publisher_config). Если задан publisher_config, креатив требует предварительного одобрения на уровне издателя.

JSON-представление 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Поля
publisherId

string

Обязательно. Идентификатор издателя.

publisherDisplayName

string

Обязательно. Имя издателя.

Методы

get

 Получает источник инвентаря.

list

 Перечисляет источники инвентаря.

patch

 Обновляет источник инвентаря.