REST Resource: 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)
    }
  ],
  "subSitePropertyId": string,
  "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_TAGINVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC
dealId

string

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

对于每个广告交易平台内的买方,此 ID 必须是唯一的,但在各个广告交易平台中不一定是唯一的。

status

object (InventorySourceStatus)

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

exchange

enum (Exchange)

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

updateTime

string (Timestamp format)

仅限输出。上次更新广告资源来源时的时间戳。由系统分配。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

rateDetails

object (RateDetails)

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

publisherName

string

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

timeRange

object (TimeRange)

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

creativeConfigs[]

object (CreativeConfig)

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

不适用于竞价包。

guaranteedOrderId

string

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

仅在 commitmentINVENTORY_SOURCE_COMMITMENT_GUARANTEED 时适用。

readWriteAccessors

object (InventorySourceAccessors)

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

仅当 commitmentINVENTORY_SOURCE_COMMITMENT_GUARANTEED 时才输出,在这种情况下,读/写访问器会从父级有保证订单继承。

commitmentINVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED 时为必填项。

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

readAdvertiserIds[]

string (int64 format)

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

readPartnerIds[]

string (int64 format)

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

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

InventorySourceType

可能的广告资源来源类型。

枚举
INVENTORY_SOURCE_TYPE_UNSPECIFIED 该版本中未指定广告资源来源类型或类型未知。
INVENTORY_SOURCE_TYPE_PRIVATE 私下交易广告资源来源。
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE 竞价包。

InventorySourceProductType

广告资源来源可能的产品类型。

枚举
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED 该版本中未指定或未知产品类型。不支持通过 API 修改此商品类型的广告资源来源。
PREFERRED_DEAL 广告资源来源通过首选交易出售广告资源。
PRIVATE_AUCTION 广告资源来源通过私下竞价销售广告资源。
PROGRAMMATIC_GUARANTEED 广告资源来源通过有保证的程序化交易销售广告资源。
TAG_GUARANTEED 广告资源来源通过基于代码的有保证交易销售广告资源。
YOUTUBE_RESERVE 广告资源来源通过 YouTube 预订型广告资源销售广告资源。
INSTANT_RESERVE 广告资源来源通过即时预订销售广告资源。不支持通过 API 修改此商品类型的广告资源来源。
GUARANTEED_PACKAGE 广告资源来源通过有保证的广告资源包销售广告资源。不支持通过 API 修改此商品类型的广告资源来源。
PROGRAMMATIC_TV 该广告资源来源通过 Programmtic TV 销售广告资源。不支持通过 API 修改此商品类型的广告资源来源。
AUCTION_PACKAGE 广告资源来源通过竞价包销售广告资源。不支持通过 API 修改此商品类型的广告资源来源。

InventorySourceCommitment

广告资源来源可能的承诺类型。

枚举
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED 在此版本中,承诺未指定或未知。
INVENTORY_SOURCE_COMMITMENT_GUARANTEED 承诺是保证交付的。
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED 承诺是无保证的

InventorySourceDeliveryMethod

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

枚举
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED 此版本中的投放方式未指定或未知。
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC 投放方式是程序化。
INVENTORY_SOURCE_DELIVERY_METHOD_TAG 投放方式是基于代码。

InventorySourceStatus

广告资源来源的状态相关设置。

JSON 表示法
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}
字段
entityStatus

enum (EntityStatus)

该广告资源来源是否可投放。

可接受的值包括 ENTITY_STATUS_ACTIVEENTITY_STATUS_ARCHIVEDENTITY_STATUS_PAUSED。默认值为 ENTITY_STATUS_ACTIVE

entityPauseReason

string

用户提供的暂停此广告资源来源的原因。

不得超过 100 个字符。

仅在 entityStatus 设置为 ENTITY_STATUS_PAUSED 时适用。

sellerStatus

enum (EntityStatus)

仅限输出。卖方为广告资源来源设置的状态。

仅适用于直接从发布商同步的广告资源来源。可接受的值包括 ENTITY_STATUS_ACTIVEENTITY_STATUS_PAUSED

sellerPauseReason

string

仅限输出。卖方提供的暂停此广告资源来源的原因。

仅适用于直接从发布商同步的广告资源来源,以及 sellerStatus 设为 ENTITY_STATUS_PAUSED 的情况。

configStatus

enum (InventorySourceConfigStatus)

仅限输出。广告资源来源的配置状态。

仅适用于有保证的广告资源来源。可接受的值包括 INVENTORY_SOURCE_CONFIG_STATUS_PENDINGINVENTORY_SOURCE_CONFIG_STATUS_COMPLETED

广告资源来源必须先配置(填写必填字段、选择广告素材并选择默认广告系列),然后才能投放。

InventorySourceConfigStatus

有保证的广告资源来源可能的配置状态。

枚举
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED 此版本中的审批状态未指定或未知。
INVENTORY_SOURCE_CONFIG_STATUS_PENDING 有保证的广告资源来源的初始状态。需要配置处于此状态的广告资源来源。
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED 买方配置有保证的广告资源来源后的状态。

RateDetails

广告资源来源的费率相关设置。

JSON 表示法
{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}
字段
inventorySourceRateType

enum (InventorySourceRateType)

费率类型。

可接受的值包括 INVENTORY_SOURCE_RATE_TYPE_CPM_FIXEDINVENTORY_SOURCE_RATE_TYPE_CPM_FLOORINVENTORY_SOURCE_RATE_TYPE_CPD

rate

object (Money)

广告资源来源的费率。

unitsPurchased

string (int64 format)

有保证的广告资源来源的必需属性。由卖方保证的展示次数。

minimumSpend

object (Money)

仅限输出。买方事先承诺为广告资源来源支出的金额。

仅适用于有保证的广告资源来源。

InventorySourceRateType

广告资源来源可能的费率类型。

枚举
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED 未指定或此版本中的费率类型未知。
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED 费率类型为 CPM(固定)。
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR 费率类型为 CPM(底价)。
INVENTORY_SOURCE_RATE_TYPE_CPD 费率类型为“每日费用”。
INVENTORY_SOURCE_RATE_TYPE_FLAT 费率类型为固定费率。

金钱

表示含有货币类型的金额。

JSON 表示法
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
字段
currencyCode

string

ISO 4217 中定义的由三个字母组成的货币代码。

units

string (int64 format)

金额的整数单位。例如,如果 currencyCode"USD",则 1 单位就是一美元。

nanos

integer

金额的纳诺 (10^-9) 单位数。这个值必须在 -999999999(含)和 +999999999(含)之间。如果 units 是正数,nanos 必须是正数或零。如果 units 为零,nanos 可以是正数、零或负数。如果 units 为负数,则 nanos 必须为负数或零。例如 $-1.75 表示为 units=-1 和 nanos=-750,000,000。

TimeRange

时间范围。

JSON 表示法
{
  "startTime": string,
  "endTime": string
}
字段
startTime

string (Timestamp format)

必需。时间范围的下限(含边界值)。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

必需。时间范围的上限(含边界值)。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

CreativeConfig

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

JSON 表示法
{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}
字段
creativeType

enum (CreativeType)

可分配给广告资源来源的广告素材类型。仅支持以下类型:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

联合字段 creative_config_scheme。当 creative_type 为以下项之一时,适用此字段:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

可分配给广告资源来源的广告素材的配置。creative_config_scheme 只能是下列其中一项:

displayCreativeConfig

object (InventorySourceDisplayCreativeConfig)

展示广告素材的配置。当 creativeTypeCREATIVE_TYPE_STANDARD 时,适用此字段。

videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

视频广告素材的配置。当 creativeTypeCREATIVE_TYPE_VIDEO 时,适用此字段。

InventorySourceDisplayCreativeConfig

展示广告素材的配置。

JSON 表示法
{
  "creativeSize": {
    object (Dimensions)
  }
}
字段
creativeSize

object (Dimensions)

可分配给广告资源来源的展示广告素材的尺寸要求。

InventorySourceVideoCreativeConfig

视频广告素材的配置。

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

string (Duration format)

可分配给广告资源来源的视频广告素材的时长要求。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

InventorySourceAccessors

有权访问相应广告资源来源的合作伙伴或广告客户。

JSON 表示法
{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}
字段
联合字段 accessors。有权访问相应广告资源来源的合作伙伴或广告客户。accessors 只能是下列其中一项:
partner

object (PartnerAccessor)

有权访问广告资源来源的合作伙伴。

advertisers

object (AdvertiserAccessors)

有权访问相应广告资源来源的广告客户。所有广告客户都必须属于同一合作伙伴。

PartnerAccessor

有权访问广告资源来源的合作伙伴。

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

string (int64 format)

合作伙伴的 ID。

AdvertiserAccessors

有权访问相应广告资源来源的广告客户。

JSON 表示法
{
  "advertiserIds": [
    string
  ]
}
字段
advertiserIds[]

string (int64 format)

广告客户的 ID。

方法

create

创建新的广告资源来源。

editInventorySourceReadWriteAccessors

可以修改广告资源来源的读写访问者。

get

获取广告资源来源。

list

列出当前用户可访问的广告资源来源。

patch

更新现有广告资源来源。