REST Resource: advertisers.lineItems

资源：LineItem

单个订单项。

JSON 表示法 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
字段
name

string

仅限输出。订单项的资源名称。
advertiserId

string (int64 format)

仅限输出。订单项所属广告客户的唯一 ID。
campaignId

string (int64 format)

仅限输出。订单项所属广告系列的唯一 ID。
insertionOrderId

string (int64 format)

必需。不可变。订单项所属广告订单的唯一 ID。
lineItemId

string (int64 format)

仅限输出。订单项的唯一 ID。由系统分配。
displayName

string

必需。订单项的显示名称。

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

enum (LineItemType)

必需。不可变。订单项的类型。
entityStatus

enum (EntityStatus)

必需。控制订单项能否支出预算和对广告资源出价。

  • 对于 lineItems.create 方法，仅允许使用 ENTITY_STATUS_DRAFT。如需启用订单项，请使用 lineItems.patch 方法，并在创建后将状态更新为 ENTITY_STATUS_ACTIVE。
  • 订单项无法从任何其他状态改回ENTITY_STATUS_DRAFT状态。
  • 如果订单项的父级广告订单未处于有效状态，则即使订单项自身的状态为ENTITY_STATUS_ACTIVE，也无法支出预算。
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"。
partnerCosts[]

object (PartnerCost)

与订单项相关的合作伙伴费用。

如果 lineItems.create 方法中不存在或为空，则新创建的订单项将沿用其父级广告订单的合作伙伴费用。
flight

object (LineItemFlight)

必需。订单项排期的开始时间和结束时间。
budget

object (LineItemBudget)

必需。订单项的预算分配设置。
pacing

object (Pacing)

必需。订单项的预算支出速度设置。
frequencyCap

object (FrequencyCap)

可选。如果订单项类型不是 LINE_ITEM_TYPE_DEMAND_GEN，则必须提供此值。订单项的展示频次上限设置。

如果分配有限上限，则必须使用此设置对象中的 maxImpressions 字段。
partnerRevenueModel

object (PartnerRevenueModel)

必需。订单项的合作伙伴收入模式设置。
conversionCounting

object (ConversionCountingConfig)

订单项的转化跟踪设置。
creativeIds[]

string (int64 format)

与订单项关联的广告素材的 ID。
bidStrategy

object (BiddingStrategy)

必需。订单项的出价策略。
integrationDetails

object (IntegrationDetails)

订单项的集成详情。
targetingExpansion

object (TargetingExpansionConfig)

订单项的优化型定位设置。

此配置仅适用于使用自动出价且正向定位到符合条件的受众群体名单的展示广告、视频广告或音频广告订单项。
warningMessages[]

enum (LineItemWarningMessage)

仅限输出。订单项生成的警告消息。这些警告不会阻止您保存订单项，但有些警告可能会阻止订单项投放。
mobileApp

object (MobileApp)

订单项宣传的应用宣传广告。

这仅在 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 或 LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL 时适用。
reservationType

enum (ReservationType)

仅限输出。订单项的预订类型。
excludeNewExchanges

boolean

是否禁止订单项自动定位到新的广告交易平台。此字段默认值为 false。
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

可选。YouTube 及合作伙伴订单项特有的设置。
demandGenSettings

object (DemandGenSettings)

可选。需求开发订单项特有的设置。

仅适用于需求开发订单项。
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

此订单项是否会投放欧盟政治广告。

如果父级广告客户中的 containsEuPoliticalAds 已设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，则除非另有指定，否则此字段将被分配 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING。然后，您可以使用界面、API 或结构化数据文件更新此字段。

创建新订单项时，必须为此字段赋值。否则，advertisers.lineItems.create 请求将失败。
optimizeFixedBidding

boolean

可选。是否为固定出价订单项启用 DV360 的出价优化功能。

默认情况下，DV360 会自动降低不太可能取得良好效果的展示机会的出价，从而优化您的固定出价。此优化默认处于启用状态（值为 true）。

如果此字段设置为 false，则此优化功能会被停用，并且出价不会因任何原因而降低。

此设置仅适用于类型为 FIXED_BID 的 biddingStrategy 订单项。

LineItemType

订单项的可能类型。

订单项的类型决定了哪些设置和选项适用，例如广告格式或定位选项。

枚举
LINE_ITEM_TYPE_UNSPECIFIED

此版本中未指定类型值，或类型值未知。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_DISPLAY_DEFAULT 图片广告、HTML5 广告、原生广告或富媒体广告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 展示广告，旨在提高应用安装量。
LINE_ITEM_TYPE_VIDEO_DEFAULT 在各种环境中按每千次展示费用 (CPM) 出售的视频广告。
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL 旨在提高应用安装量的视频广告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

在移动应用内广告资源上投放的展示广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

在移动应用内广告资源上投放的视频广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_AUDIO_DEFAULT 在各种环境中销售的 RTB 音频广告。
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT 广告订单中包含的 OTT 广告。此类型仅适用于广告订单为 insertionOrderType OVER_THE_TOP 的订单项。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

可促成转化的 YouTube 视频广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

无法跳过的 YouTube 视频广告（最长 15 秒）。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

YouTube 视频广告，采用多种格式按特定顺序展示一系列广告，讲述您创作的故事。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube 音频广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

YouTube 视频广告，旨在以更低的费用覆盖更多唯一身份用户。可能包括导视广告、可跳过的插播广告或多种广告类型的组合。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

默认 YouTube 视频广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

在联网电视上投放的 YouTube 视频广告（最长 15 秒），无法跳过。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

联网电视 YouTube 视频广告，经过优化，能以更低的费用覆盖更多唯一身份用户。可能包括导视广告、可跳过的插播广告或多种广告类型的组合。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

联网电视默认 YouTube 视频广告。仅包含插播广告格式。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

此类订单项的目标是在特定时间段内向同一用户展示 YouTube 广告的目标次数。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

YouTube 视频广告，旨在通过各种广告格式获得更多观看次数。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

在数字户外广告资源中投放的展示广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

在数字户外广告资源上投放的视频广告。

无法使用 API 创建或更新此类型的订单项及其定位条件。
LINE_ITEM_TYPE_DEMAND_GEN 需求开发广告。

LineItemFlight

用于控制订单项有效时长的设置。

JSON 表示法 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
字段
flightDateType

enum (LineItemFlightDateType)

必需。订单项排期的类型。
dateRange

object (DateRange)

订单项的广告投放期开始日期和结束日期。它们是相对于父级广告客户的时区进行解析的。

  • 当 flightDateType 为 LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM 时为必需。否则仅限输出。
  • 创建新排期时，startDate 和 endDate 都必须是将来的时间。
  • 如果现有排期的 startDate 已过，则其 endDate 可变，但 startDate 不可变。
  • endDate 必须是 startDate或更晚，且均在 2037 年之前。

LineItemFlightDateType

订单项排期的可能类型。

枚举
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED 此版本中未指定类型值，或类型值未知。
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED 订单项的排期继承自其父级广告订单。
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM 该订单项使用自己的自定义排期。

LineItemBudget

用于控制预算分配方式的设置。

JSON 表示法 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
字段
budgetAllocationType

enum (LineItemBudgetAllocationType)

必需。预算分配类型。

仅当为父级广告订单启用了自动分配预算功能时，LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC才适用。

对于需求开发订单项，此字段必须设置为 LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED。
budgetUnit

enum (BudgetUnit)

仅限输出。预算单位用于指定预算是基于货币还是基于展示次数。此值继承自父级广告订单。
maxAmount

string (int64 format)

订单项将支出的预算金额上限。必须大于 0。

当 budgetAllocationType 为以下值时：

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC，此字段不可变，由系统设置。
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED，如果 budgetUnit 为：
    • BUDGET_UNIT_CURRENCY：此字段表示要支出的最高预算金额，以广告客户所用币种的微单位表示。例如，1500000 表示 1.5 个标准货币单位。
    • BUDGET_UNIT_IMPRESSIONS，此字段表示要投放的展示次数上限。
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED，此字段不适用，系统会忽略该字段。

LineItemBudgetAllocationType

预算分配的可能类型。

枚举
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED 此版本中未指定类型值，或类型值未知。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC 已为订单项启用自动分配预算功能。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED 为订单项分配固定的最高预算金额。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED 未对订单项应用预算上限。

PartnerRevenueModel

用于控制合作伙伴收入计算方式的设置。

JSON 表示法 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
字段
markupType

enum (PartnerRevenueModelMarkupType)

必需。合作伙伴收入模式的加价类型。

对于需求开发订单项，此字段必须设置为 PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP。
markupAmount

string (int64 format)

必需。合作伙伴收入模式的加价金额。必须大于等于 0。

  • 当 markupType 设置为 PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM 时，此字段表示以广告客户币种的微单位表示的每千次展示费用加价。例如，1500000 表示 1.5 个标准货币单位。
  • 如果 markupType 设置为 PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP，则此字段表示媒体费用加价百分比（以千分之一为单位）。例如，100 表示 0.1%（小数 0.001）。
  • 如果 markupType 设置为 PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP，则此字段表示总媒体费用加价百分比（以千分之一为单位）。例如，100 表示 0.1%（小数 0.001）。

PartnerRevenueModelMarkupType

合作伙伴收入模式的可能加价类型。

枚举
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED 此版本中未指定类型值，或类型值未知。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM 根据固定每千次展示费用计算合作伙伴收入。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

根据媒体费用的百分比附加费计算合作伙伴收入。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP 根据总媒体费用（包括所有合作伙伴费用和数据费用）的百分比附加费计算合作伙伴收入。

ConversionCountingConfig

用于控制转化次数统计方式的设置。

所有点击后转化都会被统计。您可以为浏览后转化统计设置一个百分比值。

JSON 表示法 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
字段
postViewCountPercentageMillis

string (int64 format)

要统计的浏览后转化次数所占的百分比，以千分之一为单位（1% 的千分之一）。必须在 0 到 100000 之间（含边界值）。

例如，如需跟踪 50% 的点击后转化，请设置值 50000。
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

用于跟踪转化的 Floodlight 活动配置。

统计的转化次数是此字段中指定的所有 Floodlight 活动 ID 统计的所有转化次数的总和。

如果为订单项分配了自定义出价算法，则无法更新此字段。如果您在同一请求中设置此字段并分配自定义出价算法，则 Floodlight 活动必须与自定义出价算法所用的活动一致。
primaryAttributionModelId

string (int64 format)

可选。用于进行转化衡量的归因模型。此归因模型将决定转化次数的统计方式。您可以为 Floodlight 配置或组设置主要模型。如需了解更多详情，请参阅此处。

仅适用于需求开发订单项。

TrackingFloodlightActivityConfig

用于控制单个 Floodlight 活动配置行为的设置。

JSON 表示法 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
字段
floodlightActivityId

string (int64 format)

必需。Floodlight 活动的 ID。
postClickLookbackWindowDays

integer

必需。广告被点击后，系统可能会统计转化的天数。必须在 0 到 90 之间（含边界值）。
postViewLookbackWindowDays

integer

必需。广告被观看后，系统可统计转化的天数。必须在 0 到 90 之间（含边界值）。

LineItemWarningMessage

订单项生成的警告消息。这些类型的警告不会阻止保存订单项，但可能会阻止订单项投放。

枚举
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED 未指定或未知。
INVALID_FLIGHT_DATES 此订单项的排期无效。订单项将不会投放。
EXPIRED 此订单项的结束日期已过。
PENDING_FLIGHT 此订单项将在未来开始投放。
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED 所有合作伙伴启用的广告交易平台都会被排除。订单项将不会投放。
INVALID_INVENTORY_SOURCE 未定位任何有效的广告资源来源。订单项将不会投放。
APP_INVENTORY_INVALID_SITE_TARGETING 此订单项的应用和网址定位条件不包含任何移动应用。此订单项的类型要求您在渠道、网站列表或应用定位条件中添加移动应用。订单项将不会投放。
APP_INVENTORY_INVALID_AUDIENCE_LISTS 此订单项未定位到任何移动用户。此订单项的类型要求您定位包含移动用户的用户名单。订单项将不会投放。
NO_VALID_CREATIVE 此订单项不含任何有效广告素材。订单项将不会投放。
PARENT_INSERTION_ORDER_PAUSED 此订单项的广告订单已暂停。订单项将不会投放。
PARENT_INSERTION_ORDER_EXPIRED 此订单项的广告订单的结束日期已过。订单项将不会投放。

MobileApp

移动应用安装订单项宣传的移动应用。

JSON 表示法 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
字段
appId

string

必需。平台商店提供的应用 ID。

Android 应用由 Android Play 商店使用的软件包 ID（例如 com.google.android.gm）标识。

iOS 应用由 Apple 应用商店 使用的 9 位数应用 ID 标识，例如 422689480。
platform

enum (Platform)

仅限输出。应用平台。
displayName

string

仅限输出。应用名称。
publisher

string

仅限输出。应用发布商。

平台

可能的移动应用平台。

枚举
PLATFORM_UNSPECIFIED 未指定平台。
IOS iOS 平台。
ANDROID Android 平台。

YoutubeAndPartnersSettings

YouTube 及合作伙伴订单项的设置。

JSON 表示法 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
字段
viewFrequencyCap

object (FrequencyCap)

订单项的观看频次上限设置。

如果分配有限上限，则必须使用此设置对象中的 maxViews 字段。
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

可选。订单项的第三方衡量配置。
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

用于控制订单项将定位到哪些 YouTube 及合作伙伴广告资源的设置。
contentCategory

enum (YoutubeAndPartnersContentCategory)

仅限输出。YouTube 和合作伙伴广告将展示在何种内容上。
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

仅限输出。在投放订单项时生效的内容分类。如果订单项和广告客户都设置了内容分类，则在投放订单项时，限制性更强的分类会生效。

新订单项只会沿用广告客户级设置。
targetFrequency

object (TargetFrequency)

可选。您希望此订单项中的广告在特定时间段内向同一用户展示的平均次数。
linkedMerchantId

string (int64 format)

可选。用于提供商品 Feed 的 Merchant Center 账号的 ID。

此 Merchant Center 账号必须已与广告客户相关联。
relatedVideos[]

object (RelatedVideo)

可选。订单项的相关视频。当移动设备上的 YouTube 应用中播放主视频广告时，这些视频会在广告下方显示。
leadFormId

string (int64 format)

可选。用于发掘潜在客户的表单的 ID。
videoAdSequenceSettings

object (VideoAdSequenceSettings)

可选。与 VideoAdSequence 相关的设置。
videoAdInventoryControl

object (VideoAdInventoryControl)

可选。用于控制此订单项允许使用哪些广告资源的设置。

ThirdPartyMeasurementConfigs

用于控制哪些第三方供应商衡量特定订单项指标的设置。

JSON 表示法 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
字段
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

可选。衡量可见度的第三方供应商。

以下第三方供应商适用：

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

可选。衡量品牌保障的第三方供应商。

以下第三方供应商适用：

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

可选。衡量覆盖面的第三方供应商。

以下第三方供应商适用：

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

可选。衡量品牌提升效果的第三方供应商。

以下第三方供应商适用：

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

用于控制如何配置第三方衡量服务供应商的设置。

JSON 表示法 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
字段
vendor

enum (ThirdPartyVendor)

第三方衡量服务供应商。
placementId

string

第三方供应商的平台用于标识订单项的 ID。

ThirdPartyVendor

执行第三方衡量的供应商。

枚举
THIRD_PARTY_VENDOR_UNSPECIFIED 未知的第三方供应商。
THIRD_PARTY_VENDOR_MOAT Moat。
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify。
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science。
THIRD_PARTY_VENDOR_COMSCORE Comscore。
THIRD_PARTY_VENDOR_TELEMETRY 遥测。
THIRD_PARTY_VENDOR_MEETRICS Meetrics。
THIRD_PARTY_VENDOR_ZEFR ZEFR。
THIRD_PARTY_VENDOR_NIELSEN Nielsen。
THIRD_PARTY_VENDOR_KANTAR Kantar。
THIRD_PARTY_VENDOR_DYNATA Dynata。
THIRD_PARTY_VENDOR_TRANSUNION Transunion。
THIRD_PARTY_VENDOR_ORIGIN 源网域的技术。
THIRD_PARTY_VENDOR_GEMIUS Gemius。
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope。
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT AudienceProject。
THIRD_PARTY_VENDOR_VIDEO_AMP 视频 AMP。
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV。
THIRD_PARTY_VENDOR_INTAGE Intage。
THIRD_PARTY_VENDOR_MACROMILL Macromill。
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research。
THIRD_PARTY_VENDOR_AQUILA Aquila。

YoutubeAndPartnersInventorySourceConfig

用于控制 YouTube 及合作伙伴订单项将定位到哪些 YouTube 相关广告资源的设置。

JSON 表示法 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
字段
includeYoutube

boolean

可选。是否定位到 YouTube 上的广告资源。这包括搜索、频道和视频。
includeGoogleTv

boolean

可选。是否定位到适用于 Google TV 的视频应用中的广告资源。
includeYoutubeVideoPartners

boolean

是否定位到与 YouTube 遵循相同品牌保障标准的合作网站和应用集合中的广告资源。

YoutubeAndPartnersContentCategory

YouTube 和合作伙伴内容的品牌保障类别。

枚举
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED 此版本中未指定内容分类，或内容分类未知。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD 此类别包含适合大多数品牌的各种内容。这些内容基于 YouTube 的“适合投放广告的内容”准则。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED 此类别包含 YouTube 和视频合作伙伴上所有符合变现标准的内容。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED 此类别包含的内容范围较小，但符合更高的要求，特别是在不当用语和性暗示方面。

TargetFrequency

此设置用于控制广告在特定时间段内向同一用户展示的平均次数。

JSON 表示法 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
字段
targetCount

string (int64 format)

在 timeUnit 和 timeUnitCount 指定的时间跨度内，广告向同一用户展示的目标平均次数。
timeUnit

enum (TimeUnit)

应用目标频次的时间单位。

以下时间单位适用：

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

目标频次将持续的timeUnit数。

根据 timeUnit 的值，存在以下限制：

  • TIME_UNIT_WEEKS - 必须为 1
  • TIME_UNIT_MONTHS - 必须为 1

RelatedVideo

表示相关视频条目。

JSON 表示法 
{
  "videoId": string,
  "videoAssetId": string
}
字段
videoId

string

仅限输出。相关视频的 YouTube 视频 ID。
videoAssetId

string (int64 format)

必需。YouTube 视频的 AdAsset 资源的 adAssetId。

VideoAdSequenceSettings

与 VideoAdSequence 相关的设置。

JSON 表示法 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
字段
minimumDuration

enum (VideoAdSequenceMinimumDuration)

同一用户再次看到此序列的最短时间间隔。
steps[]

object (VideoAdSequenceStep)

序列包含的步骤。

VideoAdSequenceMinimumDuration

枚举，表示同一用户再次看到 VideoAdSequence 之前可能的最短间隔时间。

枚举
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED 未指定或未知。
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 天。
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 天。

VideoAdSequenceStep

VideoAdSequence 中单个步骤的详细信息。

JSON 表示法 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
字段
stepId

string (int64 format)

步骤的 ID。
adGroupId

string (int64 format)

步骤的对应广告组的 ID。
previousStepId

string (int64 format)

上一步的 ID。第一步没有上一步。
interactionType

enum (InteractionType)

上一步中将引导观看者进入此步骤的互动。第一步没有 interactionType。

InteractionType

步骤中的互动类型。

枚举
INTERACTION_TYPE_UNSPECIFIED 未指定或未知
INTERACTION_TYPE_PAID_VIEW 付费观看。
INTERACTION_TYPE_SKIP 已被观看者跳过。
INTERACTION_TYPE_IMPRESSION （已观看的）广告展示。
INTERACTION_TYPE_ENGAGED_IMPRESSION 观看者未立即跳过，但也没有达到可计费事件的广告展示。

VideoAdInventoryControl

在某些 YouTube 订单项类型中使用的视频广告资源控制。

JSON 表示法 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
字段
allowInStream

boolean

可选。广告是否可以采用插播广告格式投放。
allowInFeed

boolean

可选。广告是否可以采用信息流广告格式投放。
allowShorts

boolean

可选。广告是否可以采用 Shorts 格式投放。
allowNonSkippableInStream

boolean

可选。指明广告是否可以采用不可跳过的插播广告格式投放。

DemandGenSettings

需求开发订单项的设置。

JSON 表示法 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
字段
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

可选。需求开发订单项的第三方衡量设置。
linkedMerchantId

string (int64 format)

可选。用于提供商品 Feed 的 Merchant Center 账号的 ID。

此 Merchant Center 账号必须已与广告客户相关联。
geoLanguageTargetingEnabled

boolean

可选。不可变。是否可以在订单项级设置地理位置和语言定位。否则，必须直接向广告组分配相关的定位类型。

方法

bulkEditAssignedTargetingOptions

 批量修改多个订单项下的定位选项。

bulkListAssignedTargetingOptions

 列出多个订单项在各种定位类型中分配的定位选项。

bulkUpdate

 更新多个订单项。

create

 创建新订单项。

delete

 删除订单项。

duplicate

 复制订单项。

get

 获取订单项。

list

 列出广告客户中的订单项。

patch

 更新现有订单项。