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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

 更新广告资源来源。