REST Resource: partners.inventorySources

Ресурс: InventorySource

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

JSON-представление 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
Поля
name

string

Только для вывода. Название ресурса источника инвентаря.
inventorySourceId

string (int64 format)

Только для вывода. Уникальный идентификатор источника инвентаря. Назначается системой.
displayName

string

Отображаемое название источника инвентаря.

Должно быть закодировано в UTF-8 и иметь максимальный размер 240 байт.
inventorySourceType

enum (InventorySourceType)

Указывает тип источника инвентаря.
inventorySourceProductType

enum (InventorySourceProductType)

Только для вывода. Тип товара источника инвентаря, указывающий на способ продажи инвентаря.
commitment

enum (InventorySourceCommitment)

Гарантированное или негарантированное выполнение для источника инвентаря.
deliveryMethod

enum (InventorySourceDeliveryMethod)

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

  • Для негарантированных источников инвентаря единственным допустимым значением является INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Для гарантированных источников инвентаря допустимы значения INVENTORY_SOURCE_DELIVERY_METHOD_TAG и INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

Идентификатор, который однозначно определяет источник инвентаря на бирже.

Должен быть уникальным для покупателей в рамках каждой биржи, но не обязательно для разных бирж.
status

object (InventorySourceStatus)

Настройки статуса источника инвентаря.
exchange

enum (Exchange)

Биржа, к которой относится источник инвентаря.
updateTime

string (Timestamp format)

Только для вывода. Временная метка последнего обновления источника инвентаря. Назначается системой.

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

object (RateDetails)

Обязательно. Сведения о тарифах источника инвентаря.
publisherName

string

Название издателя или продавца, которому принадлежит источник инвентаря.
timeRange

object (TimeRange)

Период времени, в течение которого источник инвентаря начинает и прекращает показ.
creativeConfigs[]

object (CreativeConfig)

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

Неприменимо к пакетам для аукционов.
guaranteedOrderId

string

Не меняется. Идентификатор гарантированного заказа, к которому относится этот источник инвентаря.

Применимо, только если для параметра commitment задано значение INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

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

Выводится, только если для параметра commitment задано значение INVENTORY_SOURCE_COMMITMENT_GUARANTEED. В этом случае методы доступа для чтения и записи наследуются от родительского гарантированного заказа.

Обязательно, если для параметра commitment задано значение INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Если для параметра commitment задано значение INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED и в этом поле указан партнер, то все рекламодатели, относящиеся к этому партнеру, автоматически получат доступ к источнику инвентаря только для чтения. Эти рекламодатели не будут включены в readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Только для вывода. Идентификаторы рекламодателей, у которых есть доступ к источнику инвентаря только для чтения.
readPartnerIds[]

string (int64 format)

Только для вывода. Идентификаторы партнеров, у которых есть доступ к источнику инвентаря только для чтения.

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

Методы

get

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

list

 Возвращает список сделок, относящихся к источнику инвентаря.