REST Resource: advertisers.insertionOrders

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}

string

Только вывод. Название ресурса заказа на размещение.

string ( int64 format)

Только вывод. Уникальный идентификатор рекламодателя, которому принадлежит заказ на размещение.

string ( int64 format)

Необходимый. Неизменяемый. Уникальный идентификатор кампании, которой принадлежит заказ на размещение.

string ( int64 format)

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

string

Необходимый. Отображаемое название заказа на размещение.

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

enum ( InsertionOrderType )

Тип заказа на размещение.

Если это поле не указано при создании, по умолчанию используется значение RTB .

enum ( EntityStatus )

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

• Для метода insertionOrders.create разрешен только ENTITY_STATUS_DRAFT . Чтобы активировать заказ на размещение, используйте метод insertionOrders.patch и обновите статус на ENTITY_STATUS_ACTIVE после создания.
• Заказ на размещение нельзя вернуть обратно в статус ENTITY_STATUS_DRAFT из любого другого статуса.
• Заказу на размещение нельзя установить значение ENTITY_STATUS_ACTIVE , если его родительская кампания неактивна.

string ( Timestamp format)

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

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

object ( PartnerCost )

Расходы партнера, связанные с заказом на размещение.

Если метод insertionOrders.create отсутствует или пуст, вновь созданный заказ на размещение унаследует партнерские расходы из настроек партнера.

object ( Pacing )

Необходимый. Настройка скорости расходования бюджета в заказе на размещение.

object ( FrequencyCap )

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

object ( IntegrationDetails )

Дополнительные сведения об интеграции заказа на размещение.

object ( PerformanceGoal )

Необходимый. Цель эффективности заказа на размещение.

object ( InsertionOrderBudget )

Необходимый. Настройки распределения бюджета заказа на размещение.

object ( BiddingStrategy )

Стратегия назначения ставок в заказе на размещение. По умолчанию установлена fixedBid .

enum ( ReservationType )

Только вывод. Тип резервирования заказа на размещение.

enum ( BillableOutcome )

Неизменяемый. Оплачиваемый результат заказа на размещение.

Покупка на основе результата устарела. BILLABLE_OUTCOME_PAY_PER_IMPRESSION — единственное допустимое значение.

{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}

enum ( BudgetUnit )

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

enum ( InsertionOrderAutomationType )

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

Если это поле не указано при создании, значение по умолчанию равно INSERTION_ORDER_AUTOMATION_TYPE_NONE .

object ( InsertionOrderBudgetSegment )

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

{
  "budgetAmountMicros": string,
  "description": string,
  "dateRange": {
    object (DateRange)
  },
  "campaignBudgetId": string
}

string ( int64 format)

Необходимый. Сумма бюджета, которую заказ на размещение потратит за заданный dateRange . Сумма указана в микронах. Должно быть больше 0. Например, 500000000 представляет 500 стандартных единиц валюты.

string

Описание бюджетного сегмента. Его можно использовать для ввода информации о заказе на поставку для каждого сегмента бюджета и печати этой информации в счетах-фактурах.

Должно быть в кодировке UTF-8.

object ( DateRange )

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

• При создании нового сегмента бюджета и startDate , и endDate должны находиться в будущем.
• Существующий сегмент бюджета с startDate в прошлом имеет изменяемую endDate но неизменяемую startDate .
• endDate должна быть startDate или позже, оба до 2037 года.

string ( int64 format)

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