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)
  }
}
欄位
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)

僅供輸出。委刊項上次更新時的時間戳記。由系統指派。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
partnerCosts[]

object (PartnerCost)

與委刊項相關的夥伴費用。

如果 lineItems.create 方法中缺少或留空，新建的委刊項會沿用上層廣告訂單的夥伴費用。
flight

object (LineItemFlight)

必要欄位。委刊項檔期的開始和結束時間。
budget

object (LineItemBudget)

必要欄位。委刊項的預算分配設定。
pacing

object (Pacing)

必要欄位。委刊項的預算支出速度設定。
frequencyCap

object (FrequencyCap)

必要欄位。委刊項的曝光展示頻率上限設定。

如要指派限制上限，必須使用這項設定物件的 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 和合作夥伴委刊項的專屬設定。

LineItemType

可能的委刊項類型。

委刊項的類型會決定適用的設定和選項，例如廣告的格式或指定目標選項。

列舉
LINE_ITEM_TYPE_UNSPECIFIED

這個版本未指定類型值，或無法指定類型值。

無法使用 API 建立或更新這個類型的委刊項及其指定目標。
LINE_ITEM_TYPE_DISPLAY_DEFAULT 圖片、HTML5、原生或互動式多媒體廣告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 可提高應用程式安裝次數的多媒體廣告。
LINE_ITEM_TYPE_VIDEO_DEFAULT 影片廣告可在多種環境中以千次曝光出價計算。
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 即時出價音訊廣告適用於多種環境。
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT 廣告訂單中出現 over-the-top 廣告。這個類型僅適用於廣告訂單為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 建立或更新這個類型的委刊項及其指定目標。

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 必須是 2037 年前的 startDate 或以後的日期。

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」。
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)

必要欄位。夥伴收益模式的成本加價模式。
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)
    }
  ]
}
欄位
postViewCountPercentageMillis

string (int64 format)

要計入的瀏覽後轉換次數百分比，以千分之一為單位 (百分之 1/1000)。必須介於 0 到 100000 之間。

舉例來說，如要追蹤 50% 的點擊後轉換，請將價值設為 50000。
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

用於追蹤轉換的 Floodlight 活動設定。

計算方式是將這個欄位中指定的所有 Floodlight 活動 ID 計入所有轉換次數的總和。

TrackingFloodlightActivityConfig

控制單一 Floodlight 活動設定行為的設定。

JSON 表示法 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
欄位
floodlightActivityId

string (int64 format)

必要欄位。Floodlight 活動的 ID。
postClickLookbackWindowDays

integer

必要欄位。按下廣告後會計為轉換的天數。必須介於 0 到 90 之間 (含 0 和 90)。
postViewLookbackWindowDays

integer

必要欄位。使用者瀏覽廣告後所記錄轉換的天數。必須介於 0 到 90 之間 (含 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 App Store (例如 422689480) 使用的九位數應用程式 ID 來識別。
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,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
欄位
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)

連結至產品動態饋給明細項目的商家 ID。
relatedVideoIds[]

string

在行動裝置上透過 YouTube 應用程式播放廣告時，主要影片廣告下方會顯示影片 ID。
leadFormId

string (int64 format)

用於產生待開發客戶的表單 ID。
videoAdSequenceSettings

object (VideoAdSequenceSettings)

與 VideoAdSequence 相關的設定。

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_ZERF
  • 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
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

選用設定。評估品牌提升的第三方供應商。

以下為適用的第三方供應商：

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

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。

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
timeUnitCount

integer

目標頻率的持續timeUnit次數。

下列限制會根據 timeUnit 的值套用：

  • TIME_UNIT_WEEKS：必須是 1

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)

上一個步驟的互動可將觀眾導向這個步驟。第一個步驟沒有 engagementType。

InteractionType

步驟的互動類型。

列舉
INTERACTION_TYPE_UNSPECIFIED 不明或不明
INTERACTION_TYPE_PAID_VIEW 付費觀看。
INTERACTION_TYPE_SKIP 觀眾已略過。
INTERACTION_TYPE_IMPRESSION 廣告曝光一次 (已觀看)。
INTERACTION_TYPE_ENGAGED_IMPRESSION 觀眾沒有立即略過，但也未達成可計費事件的廣告曝光。

方法

bulkEditAssignedTargetingOptions

 大量編輯多個委刊項的指定目標選項。

bulkListAssignedTargetingOptions

 列出各種指定類型中多個委刊項的指派指定目標選項。

bulkUpdate

 更新多個委刊項。

create

 建立新委刊項。

delete

 刪除委刊項。

duplicate

 複製委刊項。

generateDefault

 建立新委刊項，採用沿用了廣告訂單和ENTITY_STATUS_DRAFT entity_status的設定 (包括指定目標)。

get

 取得委刊項。

list

 列出廣告客戶中的委刊項。

patch

 更新現有的委刊項。