REST Resource: partners.inventorySources

资源：InventorySource

广告资源来源。

JSON 表示法 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
字段
name

string

仅限输出。广告资源来源的资源名称。
inventorySourceId

string (int64 format)

仅限输出。广告资源来源的唯一 ID。由系统分配。
displayName

string

广告资源来源的显示名称。

必须采用 UTF-8 编码，大小上限为 240 字节。
inventorySourceType

enum (InventorySourceType)

表示广告资源来源的类型。
inventorySourceProductType

enum (InventorySourceProductType)

仅限输出。广告资源来源的商品类型，表示其销售广告资源的方式。
commitment

enum (InventorySourceCommitment)

广告资源来源是否具有有保证或无保证的投放。
deliveryMethod

enum (InventorySourceDeliveryMethod)

广告资源来源的投放方式。

  • 对于无保证广告资源来源，唯一可接受的值是 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC。
  • 对于有保证的广告资源来源，可接受的值为 INVENTORY_SOURCE_DELIVERY_METHOD_TAG 和 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC。
dealId

string

广告交易平台空间中用于唯一标识广告资源来源的 ID。

在每个交易平台内的买方中必须是唯一的，但在不同交易平台之间不一定唯一。
status

object (InventorySourceStatus)

广告资源来源的状态设置。
exchange

enum (Exchange)

广告资源来源所属的广告交易平台。
updateTime

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"。
rateDetails

object (RateDetails)

必需。广告资源来源的费率详情。
publisherName

string

广告资源来源的发布商/卖方名称。
timeRange

object (TimeRange)

此广告资源来源开始和停止投放的时间范围。
creativeConfigs[]

object (CreativeConfig)

广告资源来源的广告素材要求。

不适用于竞价型广告资源包。
guaranteedOrderId

string

不可变。此广告资源来源所属的有保证的订单的 ID。

仅在 commitment 为 INVENTORY_SOURCE_COMMITMENT_GUARANTEED 时适用。
readWriteAccessors

object (InventorySourceAccessors)

对广告资源来源具备读写权限的合作伙伴或广告客户。

仅当 commitment 为 INVENTORY_SOURCE_COMMITMENT_GUARANTEED 时输出，在这种情况下，读写访问函数会沿用父级有保证的订单。

当 commitment 为 INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED 时为必需。

如果 commitment 为 INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED，并且在此字段中设置了合作伙伴，则该合作伙伴名下的所有广告客户都将自动拥有对相应广告来源的只读权限。这些广告客户不会包含在readAdvertiserIds中。
readAdvertiserIds[]

string (int64 format)

仅限输出。对广告资源来源拥有只读权限的广告客户的 ID。
readPartnerIds[]

string (int64 format)

仅限输出。对该广告资源来源拥有只读权限的合作伙伴的 ID。

此字段中合作伙伴的所有广告客户都会继承对该广告资源来源的只读权限。

方法

get

 获取广告资源来源交易。

list

 列出广告资源来源交易。