您可以使用 Display & Video 360 API 擷取 YouTube 與合作夥伴委刊項、其廣告群組和廣告資源，以及與 YouTube 與合作夥伴廣告放送相關的指定目標。YouTube 與合作夥伴資源和指定目標只能透過使用者介面建立 或更新。
本頁說明如何使用 Display & Video 360 API 識別 YouTube 與合作夥伴資源，並擷取相關的指定目標，以及如何在使用者介面中使用結構化資料檔案 (SDF) 大量建立及更新 YouTube 與合作夥伴資源。
找出 YouTube 與合作夥伴資源
YouTube 與合作夥伴資源包含特定類型的委刊項、廣告群組和廣告。
委刊項
下列 LineItemType 值的委刊項為 YouTube 與合作夥伴委刊項，無法建立或更新：
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
您可以從 LineItem 資源的 youtubeAndPartnersSettings 欄位擷取 YouTube 與合作夥伴委刊項專屬的設定。
YouTube 廣告群組和廣告
YouTube 廣告群組和廣告是 YouTube 與合作夥伴委刊項下的子資源，可進一步指定。
YouTube 與合作夥伴委刊項下方可包含多個 AdGroup 資源，每個資源都有自己的額外指定目標和出價策略。每個 AdGroup 資源下方可包含多個相同廣告格式的 AdGroupAd 資源，每個資源都包含專屬的廣告素材資訊和額外追蹤網址清單。
擷取指定目標
用於放送 YouTube 與合作夥伴廣告的指定目標會在廣告主層級、委刊項層級和廣告群組層級指派。
從父項資源繼承的 YouTube 與合作夥伴指定目標，不會反映在子項資源的指定目標設定中，這與非 YouTube 與合作夥伴資源的標準相同。
如要擷取與 YouTube 與合作夥伴廣告放送相關的所有指定目標，您必須：
- 使用
advertisers.listAssignedTargetingOptions擷取指定給上層廣告主的指定目標。 - 使用
advertisers.lineItems.bulkListAssignedTargetingOptions擷取指派給父項委刊項的指定目標。 - 並使用
advertisers.adGroups.bulkListAssignedTargetingOptions擷取其父項廣告群組的指定目標。
嘗試修改 YouTube 指定目標
與 YouTube 與合作夥伴資源一樣，您無法使用 Display & Video 360 API 修改 YouTube 與合作夥伴指定目標。若嘗試修改下列指定目標，系統會傳回錯誤：
- 在下列指定目標類型的任何層級指派指定目標：
TARGETING_TYPE_SESSION_POSITION、TARGETING_TYPE_YOUTUBE_CHANNEL和TARGETING_TYPE_YOUTUBE_VIDEO。 - 指定給 YouTube 與合作夥伴委刊項資源的指定目標。
- 指派給
AdGroup資源的指定目標。
使用 SDF UI 上傳功能建立及更新
雖然您無法使用 Display & Video 360 API 建立或更新 YouTube 與合作夥伴資源，但您可以透過 結構化資料檔案 (SDF) 上傳功能，在 Display & Video 360 UI 中大量建立或更新 YouTube 與合作夥伴委刊項、廣告群組和廣告。
這些資源會透過 委刊項、YouTube 廣告群組和 YouTube 廣告檔案格式，在 SDF 中呈現。
您可以使用 Display & Video 360 API 產生及下載結構化資料檔案。編輯現有資料列以修改現有資源，或新增資料列來建立新資源，然後透過 Display & Video 360 UI 上傳更新後的檔案。