YouTube とパートナーの広告申込情報を取得する

ディスプレイ＆ビデオ 360 API を使用すると、YouTube とパートナーの広告申込情報、その広告グループと広告リソース、YouTube とパートナーの広告配信に関連するターゲティングを取得できます。YouTube とパートナーのリソースとターゲティングは、UI を通じてのみ作成または更新できます。

このページでは、ディスプレイ＆ビデオ 360 API を使用して YouTube とパートナーのリソースを特定し、関連するターゲティングを取得する方法と、UI の構造化データファイル（SDF）を使用して YouTube とパートナーのリソースを一括で作成、更新する方法について説明します。

YouTube とパートナーのリソースを特定する

YouTube とパートナーのリソースは、特定のタイプの広告申込情報、広告グループ、広告で構成されます。

広告申込情報

次の LineItemType 値の広告申込情報は YouTube とパートナーの広告申込情報であり、作成または更新することはできません。

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
• LINE_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 とパートナーのリソースを作成または更新することはできませんが、ディスプレイ＆ビデオ 360 UI を介した構造化データファイル（SDF）のアップロードを使用して、YouTube とパートナーの広告申込情報、広告グループ、広告を一括で作成または更新することはできます。

これらのリソースは、SDF では Line Item、Youtube Ad Group、YouTube Ad のファイル形式で表されます。

Display & Video 360 API を使用して構造化データファイルを生成してダウンロードできます。既存の行を編集して既存のリソースを変更するか、新しい行を追加して新しいリソースを作成し、ディスプレイ＆ビデオ 360 UI から更新したファイルをアップロードします。