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