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),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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, чтобы сигнализировать об отмене заказа на бирже.

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 .

,

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

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),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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, чтобы сигнализировать об отмене заказа на бирже.

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 .

,

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

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),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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, чтобы сигнализировать об отмене заказа на бирже.

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 .

,

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

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),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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, чтобы сигнализировать об отмене заказа на бирже.

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 .