REST Resource: exchanges.orders

Ресурс: Заказ

Не подлежащее обсуждению предложение, которое покупатель должен принять.

JSON-представление 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Поля
name

string

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

displayName

string

Название заказа, отображаемое покупателю. Макс. 250 символов. Необязательно.

partnerId[]

string ( int64 format)

Идентификатор партнёра в Google Display & Video 360, ранее известный как Doubleclick Bid Manager (DBM). Допускается только один идентификатор партнёра. Обязательно.

publisherEmail

string

Адрес электронной почты издателя. Адрес должен быть в допустимом формате. Максимум 250 символов. Необязательно.

publisherName

string

Название издательства. Макс. 250 символов. Обязательно.

budget

object ( Budget )

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

status

enum ( OrderStatus )

Статус заказа. Статус может измениться после того, как пользователи DV3 примут, отменят или архивируют заказ. Также поддерживается обновление до «ОТМЕНЕНО» после создания в API, чтобы сигнализировать об отмене заказа на Exchange.

wseatConfig

object ( WSeatConfig )

Необязательно. Конфигурация WSeat. Указывает конфигурацию WSeat на стороне биржи. Биржи, использующие многоместные сделки, должны поддерживать это поле заполненным и актуальным.

updateTime

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" .

buyerInfo

object ( BuyerInfo )

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

Бюджет

Бюджет указан.

JSON-представление 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
Поля
budgetType

enum ( BudgetType )

Указанный тип бюджета.

budget профсоюзного полевого округа. Можно включить только один тип бюджета. budget может быть только одним из следующих:
impressions

string ( int64 format)

Бюджет показов.

money

object ( Money )

Валютный бюджет.

BudgetType

Типы бюджета

Перечисления
BUDGET_TYPE_UNSPECIFIED Бюджет не указан. Недействительно для ввода.
BUDGET_TYPE_CURRENCY Валютный бюджет.
BUDGET_TYPE_IMPRESSION Бюджет показов.

Статус заказа

Статус заказа.

Перечисления
ORDER_STATUS_UNSPECIFIED Статус заказа не указан. Неожиданный результат, означает, что статус переговоров неизвестен. Недопустимое входное значение.
PENDING_ACCEPTANCE Статус заказа: ожидание подтверждения.
ACCEPTED Статус заказа принят.
ARCHIVED Статус заказа архивирован.
CANCELLED Статус заказа отменен.
NEGOTIATING Ведётся обсуждение статуса заказа. Применимо только для сценариев мгновенной сделки.

WSeatConfig

Конфигурация WSeat.

JSON-представление 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Поля
exchangeWseatStatus

enum ( WSeatStatus )

Необязательно. Текущий статус конфигурации WSeat на стороне Exchange.

exchangeWseatIds[]

string ( int64 format)

Необязательно. Идентификаторы WSeat на стороне Exchange.

updateTime

string ( Timestamp format)

Только вывод. Это поле автоматически обновляется DV3 при обновлении WSeatConfiguration сервером Exchange.

Использует 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" .

WSeatStatus

Параметры перечисления статуса WSeat.

Перечисления
W_SEAT_STATUS_UNSPECIFIED WSeatStatus не указан.
W_SEAT_STATUS_ENFORCED WSeatStatus принудительно применяется. Указывает, что Exchange принудительно применяет WSeatId, либо отправляя WSeatId в DV3, либо проверяя wseatid в ответах на заявки.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus не применяется. Указывает, что Exchange не отправляет wseatid в запросах ставок и не проверяет wseatid в запросах ставок.

Информация о покупателе

Информация для покупателей для сценариев мгновенной сделки.

JSON-представление 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Поля
partner

object ( PartnerInfo )

Только вывод. Информация о партнере.

advertisers[]

object ( AdvertiserInfo )

Только вывод. Информация для рекламодателя.

ПартнерИнфо

Информация о партнерах для сценариев мгновенной сделки.

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

string

Только вывод. Заголовок партнёрского контента в Display & Video 360.

Информация о рекламодателе

Информация для рекламодателей для сценариев мгновенных сделок.

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

string ( int64 format)

Только вывод. Идентификатор рекламодателя в Display & Video 360.

domainUri

string

Только вывод. URI домена сайта рекламодателя.

Методы

accept

 Принимает заказ.

create

 Создает заказ.

get

 Наводит порядок.

list

 Порядок списков.

patch

 Обновляет заказ.