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 中的合作伙伴 ID，以前称为 DoubleClick Bid Manager(DBM)。仅允许一个合作伙伴 ID。必需。
publisherEmail

string

发布商的电子邮件地址。必须是有效的电子邮件地址格式。最多 250 个字符。可选。
publisherName

string

发布商名称。最多 250 个字符。必需。
budget

object (Budget)

仅限输出。买方设置的预算。仅适用于即时交易方案。
status

enum (OrderStatus)

订单状态。在 DV3 用户接受、取消或归档订单后，状态可能会发生变化。还支持在 API 中创建后更新为“CANCELLED”，以表明相应订单已在 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 展示次数形式的预算。

OrderStatus

订单状态。

枚举
ORDER_STATUS_UNSPECIFIED 订单状态未指定。意外，表示协商状态未知。输入值无效。
PENDING_ACCEPTANCE 订单状态：待接受。
ACCEPTED 订单状态为“已接受”。
ARCHIVED 订单状态已归档。
CANCELLED 订单状态为“已取消”。
NEGOTIATING 订单状态为“正在协商”。仅适用于即时交易方案。

WSeatConfig

WSeat 配置。

JSON 表示法 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
字段
exchangeWseatStatus

enum (WSeatStatus)

可选。Exchange 端 WSeat 配置的当前状态。
exchangeWseatIds[]

string (int64 format)

可选。广告交易平台端的 WSeat ID。
updateTime

string (Timestamp format)

仅限输出。当交易平台更新 WSeatConfiguration 时，DV3 会自动更新此字段。

采用 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。表示交易平台是否通过以下方式强制执行 WSeatId：向 DV3 发送 WSeatId 或验证出价响应中的 wseatid。
W_SEAT_STATUS_NOT_ENFORCED 未强制执行 WSeatStatus。表示广告交易平台不会在出价请求中发送 wseatid，也不会验证出价请求中的 wseatid。

BuyerInfo

即时交易情形下的买方信息。

JSON 表示法 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
字段
partner

object (PartnerInfo)

仅限输出。合作伙伴信息。
advertisers[]

object (AdvertiserInfo)

仅限输出。广告客户信息。

PartnerInfo

即时交易方案的合作伙伴信息。

JSON 表示法 
{
  "title": string
}
字段
title

string

仅限输出。Display & Video 360 中的合作伙伴显示名称。

AdvertiserInfo

即时交易情形下的广告客户信息。

JSON 表示法 
{
  "advertiserId": string,
  "domainUri": string
}
字段
advertiserId

string (int64 format)

仅限输出。Display & Video 360 中的广告客户 ID。
domainUri

string

仅限输出。广告客户网站的网域 URI。

方法

accept

 接受订单。

create

 创建订单。

get

 获取订单。

list

 列出订单。

patch

 更新订单。