Method: exchanges.orders.patch

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

HTTP-запрос

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
order.name

string

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

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Поля
order.displayName

string

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

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

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

order.publisherName

string

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

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

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

order.buyerInfo

object ( BuyerInfo )

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

updateMask

string ( FieldMask format)

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

Это список полных имён полей, разделённых запятыми. Пример: "user.displayName,photo" .

Тело ответа

В случае успеха тело ответа содержит экземпляр Order .

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Для получения более подробной информации см.OAuth 2.0 Overview .