REST Resource: exchanges.inventorySources

资源：InventorySource

DV360 广告资源来源的执行模型。

JSON 表示法 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
字段
name

string

仅限输出。订单的相对资源名称。由服务器生成。示例：“exchanges/1234/inventorySources/5678”。
buyerStatus

enum (BuyerStatus)

仅限输出。买方状态。
sellerStatus

enum (SellerStatus)

卖家状态。
transactionType

enum (TransactionType)

仅限输出。商品交易类型。
pricingType

enum (PricingType)

仅限输出。商品的定价类型。
rateDetails

object (RateDetails)

仅限输出。费率详情。
startTime

string (Timestamp format)

仅限输出。此商品生效的时间。必须早于 endTime。开始时间不得超过 1 年后。

采用 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"。
endTime

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"。
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

广告交易平台提供每日交易量预测。用于确定节奏并启用买方选择。该字段已弃用。
audienceMatchRate

number

仅限输出。采用受众群体定位的有保证程序化交易的预测受众群体匹配率，由广告交易平台用来确定应发送多少额外请求。此值是一个介于 0 到 1 之间的小数，其倒数应用作展示次数的乘数。0 表示该字段未设置，因此没有受众群体定位。示例：“0.125”。这表示有 12.5% 的请求与受众群体定位条件相符，并且发送的请求量应为协商的展示次数的 8 倍。
makegoodRequested

boolean

仅限输出。指示是否已向买方请求补偿项。
makegoodRequestedReason

string

仅限输出。买方提供的申请补偿项的原因。
percentFrequencyCapExcludedTraffic

string (int64 format)

有保证的程序化交易中被排除在频次上限之外的流量所占的百分比。此值是一个介于 0 到 100 之间的整数。值 0（也是默认值）表示不排除，因此所有流量都符合频次上限条件。值 100 表示完全排除，因此不会应用频次上限。值介于 0 到 100 之间将导致部分排除。例如，如果值为 20，则会导致 20% 的流量被排除在频次上限之外。
dv360WseatId[]

string (int64 format)

仅限输出。当前对广告资源来源拥有权限的 wseat。
lastModifiedTime

string (Timestamp format)

仅限输出。广告资源来源的上次更新时间。请注意，某些 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"
creativeApprovalConfig

object (CreativeApprovalConfig)

可选。广告素材审批的配置。可能需要在广告交易平台一级或发布商一级获得批准。

BuyerStatus

买方状态。

枚举
BUYER_STATUS_UNSPECIFIED 未指定买方状态。输入值无效。
BUYER_STATUS_ACTIVE 买方状态为有效。已分配订单项，已分配有效的广告素材。
BUYER_STATUS_PENDING 买方状态为待处理。此状态表示交易处于无效状态，买方需要执行某些操作。
BUYER_STATUS_PAUSED 买方状态为“已由买方暂停”。

SellerStatus

卖家状态。

枚举
SELLER_STATUS_UNSPECIFIED 卖方状态未指定。意外，表示协商状态未知。输入值无效。
SELLER_STATUS_ACTIVE 卖家状态为有效。广告资源来源在广告交易平台端处于有效状态。
SELLER_STATUS_PAUSED 卖家状态为“暂停”。

InventorySourceVolumeForecast

广告资源来源的每日请求量预测。适用以下验证规则：- 必须为每周每一天提供条目 - 音量必须为正数 - timeZoneId 是必填项，且必须有效

JSON 表示法 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
字段
dailyVolumes[]

object (DailyVolume)

每日交易量预测。
timeZoneId

string

IANA 时区数据库中的时区（例如“America/New_York”），用于每日交易量。

DailyVolume

指定日期的广告资源来源的请求量。

JSON 表示法 
{
  "day": enum (DayOfWeek),
  "volume": string
}
字段
day

enum (DayOfWeek)

请求量所适用的周几。
volume

string (int64 format)

给定星期几的预测请求量。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

CreativeApprovalConfig

广告素材审批的配置。

JSON 表示法 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
字段
requiresExchangeApproval

boolean

必需。指明广告素材是否需要在广告交易平台一级进行预提取审批。
publisherConfigs[]

object (PublisherConfig)

可选。发布商的配置。

PublisherConfig

发布商的配置 (publisher_config)。如果设置了 publisher_config，则广告素材需要在发布商一级获得预提取批准。

JSON 表示法 
{
  "publisherId": string,
  "publisherDisplayName": string
}
字段
publisherId

string

必需。发布商 ID。
publisherDisplayName

string

必需。发布商名称。

方法

get

 获取广告资源来源。

list

 列出广告资源来源。

patch

 更新广告资源来源。