Method: exchanges.orders.patch

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

HTTP-запрос

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

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

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

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

string

Относительное имя ресурса для заказа. Сгенерировано сервером. Пример: "exchanges/1234/orders/5678". Ourput Only.

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

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

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

updateMask

string ( FieldMask format)

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

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

Тело ответа

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

Области действия авторизации

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

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

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