REST Resource: inventorySources

{
  "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)
    }
  ],
  "subSitePropertyId": string,
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}

string

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

string ( int64 format)

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

string

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

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

enum ( InventorySourceType )

Обозначает тип источника инвентаризации.

enum ( InventorySourceProductType )

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

enum ( InventorySourceCommitment )

Имеет ли источник запасов гарантированную или негарантированную доставку.

enum ( InventorySourceDeliveryMethod )

Способ доставки источника инвентаря.

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

string

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

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

object ( InventorySourceStatus )

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

enum ( Exchange )

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

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

object ( RateDetails )

Необходимый. Сведения о ставке источника инвентаря.

string

Имя издателя/продавца источника инвентаря.

object ( TimeRange )

Диапазон времени, когда этот источник инвентаря запускается и прекращает обслуживать.

object ( CreativeConfig )

Творческие требования к источнику инвентаря.

Не применимо к аукционным пакетам.

string

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

Применимо только в том случае, если commitment INVENTORY_SOURCE_COMMITMENT_GUARANTEED .

object ( InventorySourceAccessors )

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

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

Требуется, если commitment INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED .

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

string ( int64 format)

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

string ( int64 format)

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

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

{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}

enum ( EntityStatus )

Является ли источник инвентаря доступным для обслуживания.

Допустимые значения: ENTITY_STATUS_ACTIVE , ENTITY_STATUS_ARCHIVED и ENTITY_STATUS_PAUSED . Значение по умолчанию — ENTITY_STATUS_ACTIVE .

string

Указанная пользователем причина приостановки работы этого источника инвентаря.

Не должно превышать 100 символов.

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

enum ( EntityStatus )

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

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

string

Только вывод. Продавец указал причину приостановки использования этого источника ресурсов.

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

enum ( InventorySourceConfigStatus )

Только вывод. Статус конфигурации источника инвентаризации.

Применимо только для гарантированных источников инвентаря. Допустимые значения: INVENTORY_SOURCE_CONFIG_STATUS_PENDING и INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED .

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

{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}

enum ( InventorySourceRateType )

Тип тарифа.

Допустимые значения: INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED , INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR и INVENTORY_SOURCE_RATE_TYPE_CPD .

object ( Money )

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

string ( int64 format)

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

object ( Money )

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

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Трехбуквенный код валюты, определенный в ISO 4217.

string ( int64 format)

Целые единицы суммы. Например, если currencyCode равен "USD" , то 1 единица равна одному доллару США.

integer

Количество нано (10^-9) единиц суммы. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если units положительны, nanos должен быть положительным или нулевым. Если units равны нулю, nanos может быть положительным, нулевым или отрицательным. Если units измерения отрицательные, nanos должно быть отрицательным или нулевым. Например, -1,75 доллара США представлены как units = -1 и nanos = -750 000 000.

{
  "startTime": string,
  "endTime": string
}

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}

enum ( CreativeType )

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

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object ( InventorySourceDisplayCreativeConfig )

Конфигурация показа креативов. Применимо, когда creativeType имеет значение CREATIVE_TYPE_STANDARD .

object ( InventorySourceVideoCreativeConfig )

Конфигурация для видеокреативов. Применимо, когда creativeType имеет значение CREATIVE_TYPE_VIDEO .

{
  "creativeSize": {
    object (Dimensions)
  }
}

object ( Dimensions )

Требования к размерам медийных креативов, которые можно назначить источнику ресурсов.

{
  "duration": string
}

string ( Duration format)

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

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}

object ( PartnerAccessor )

Партнер, имеющий доступ к источнику ресурсов.

object ( AdvertiserAccessors )

Рекламодатели, имеющие доступ к источнику инвентаря. Все рекламодатели должны принадлежать одному партнеру.

{
  "partnerId": string
}

string ( int64 format)

Идентификатор партнера.

{
  "advertiserIds": [
    string
  ]
}

string ( int64 format)

Идентификаторы рекламодателей.