Display & Video 360 API を使用すると、YouTube とパートナーの広告申込情報、その広告グループと広告リソース、YouTube とパートナーの広告配信に関連するターゲティングを取得できます。YouTube とパートナーのリソースとターゲティングは、UI でのみ作成または更新できます。
このページでは、ディスプレイ＆ビデオ 360 API を使用して YouTube とパートナーのリソースを特定し、関連するターゲティングを取得する方法と、UI で構造化データファイル（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
YouTube とパートナーの広告申込情報に固有の設定は、LineItem リソースの youtubeAndPartnersSettings フィールドから取得できます。
YouTube の広告グループと広告
YouTube 広告グループと広告は、YouTube とパートナーの広告申込情報の子リソースであり、さらに詳細を指定できます。
YouTube とパートナーの広告申込情報には、複数の AdGroup リソースを設定できます。各リソースには、独自の追加ターゲティングと入札戦略を設定できます。各 AdGroup リソースには、同じ広告フォーマットの複数の AdGroupAd リソースを含めることができます。各リソースには、独自のクリエイティブ情報と追加のトラッキング URL のリストが含まれます。
ターゲティングを取得する
YouTube とパートナーの広告配信に使用されるターゲティングは、広告主、広告申込情報、広告グループの各レベルで割り当てられます。
親リソースから継承された YouTube とパートナーのターゲティングは、YouTube とパートナー以外のリソースでは標準であるように、子リソースのターゲティング設定に反映されません。
YouTube とパートナーの広告の配信に関連するすべてのターゲティングを取得するには、次の操作を行う必要があります。
advertisers.listAssignedTargetingOptionsを使用して、親広告主に割り当てられたターゲティングを取得します。advertisers.lineItems.bulkListAssignedTargetingOptionsを使用して、親広告申込情報に割り当てられたターゲティングを取得します。advertisers.adGroups.bulkListAssignedTargetingOptionsを使用して、親広告グループに割り当てられたターゲティングを取得します。
YouTube のターゲティングの変更を試行している
YouTube とパートナーのリソースと同様に、ディスプレイ＆ビデオ 360 API を使用して YouTube とパートナーのターゲティングを変更することはできません。次のターゲティングを変更しようとすると、エラーが返されます。
- 次のターゲティング タイプ（
TARGETING_TYPE_SESSION_POSITION、TARGETING_TYPE_YOUTUBE_CHANNEL、TARGETING_TYPE_YOUTUBE_VIDEO）の任意のレベルで割り当てられたターゲティング。 - YouTube とパートナーの広告申込情報リソースに割り当てられたターゲティング。
AdGroupリソースに割り当てられたターゲティング。
SDF UI アップロードを使用して作成、更新する
ディスプレイ＆ビデオ 360 API を使用して YouTube & Partners リソースを作成または更新することはできませんが、ディスプレイ＆ビデオ 360 の管理画面から構造化データファイル（SDF）をアップロードして、YouTube & Partners の広告申込情報、広告グループ、広告を一括で作成または更新することは可能です。
これらのリソースは、SDF では [広告申込情報]、[YouTube 広告グループ]、[YouTube 広告] のファイル形式で表されます。
Display & Video 360 API を使用して構造化データファイルを生成してダウンロードできます。既存の行を編集して既存のリソースを変更するか、新しい行を追加して新しいリソースを作成します。更新したファイルをディスプレイ＆ビデオ 360 の管理画面からアップロードします。