構造化データファイル（SDF）と Display & Video 360 API はいずれも、ディスプレイ &ビデオ 360 のリソース設定を一括で管理できます。ツールごとに固有の制限があります。このガイドでは、両方のツールを使用して既存の実装を最適化する方法について説明します。
すでに構造化データファイルを使用している場合
Display & Video 360 API を使用すると、ファイルと関連メタデータをプログラムで取得して SDF の統合をサポートできます。
API を使用してファイルを生成、ダウンロードする
デフォルトでは、ディスプレイ &ビデオ 360 のインターフェースを使って構造化データファイルを手動でダウンロードします。通常、このようなダウンロードは単一の広告主に制限され、特定のリソースページから開始する必要があります。このインターフェースから大量の SDF データをダウンロードすると、複雑で時間がかかります。
Display & Video 360 API を使用して構造化データファイルを生成、ダウンロードすることで、このプロセスを効率化できます。この機能を実装する詳しい手順については、ガイドをご覧ください。
API を使用して参照 ID を検索する
構造化データファイルには、ディスプレイ &ビデオ 360 リソースの設定が反映されます。 ほとんどの SDF 列では、他のリソースやターゲティング設定を識別するために数値 ID が使用されます。SDF データを読み取ったり変更したりするときに、こうした ID を理解するために参照が必要になることがよくあります。
Display & Video 360 API を使用すると、参照情報をまとめて取得できます。ほとんどの SDF 列で使用される使用可能な ID は、関連するリソースの GET 関数または LIST 関数を使って取得できます。
参照情報をプログラムで取得してキャッシュに保存し、構造化データファイルの解析と変更を行う際に、キャッシュに保存された情報を使用できるようにします。キャッシュは定期的に更新できます。また、SDF ファイルを解析して新しいリソースの情報を取得する際に、必要に応じて未知の ID をリアルタイムで検索することもできます。
利用可能な API サービスとメソッドの一覧については、API リファレンス ドキュメントをご覧ください。
既存の例外
構造化データファイルで使用される参照 ID の一部は、Display & Video 360 API を使用して取得することはできません。
- アフィニティと購買意向の強いオーディエンスのターゲティング: これらの列で使用されているオーディエンス ID をディスプレイ&ビデオ 360 管理画面から取得します。
- コンバージョン Floodlight アクティビティ ID: この列で使用されている Floodlight アクティビティ ID をディスプレイ &ビデオ 360 の管理画面から取得します。
- 広告枠ソース ターゲティング: これらの列で使用されている Exchange ID を、公開されている SDF エクスチェンジのリファレンスから取得します。これらの列で使用されている広告枠ソース ID とサブエクスチェンジ ID を、Display & Video 360 API を使って取得します。
- アプリ ターゲティング: これらの列で使用されるアプリ ID を関連するアプリ プラットフォームから取得します。
すでに Display & Video 360 API を使用している場合
SDF を使用すると、YouTube とパートナーのリソースを一括作成および更新して、ディスプレイ&ビデオ 360 API の統合をサポートできます。
SDF のアップロードを使用して YouTube とパートナーのリソースを更新する
Display & Video 360 API を使用して YouTube とパートナーのリソース（特定の種類の広告申込情報、広告グループ、広告など）を作成または更新することはできません。これらのリソースの設定や割り当てられているターゲティングを取得できますが、更新はディスプレイ &ビデオ 360 の管理画面から行う必要があります。これにより、一括操作が制限され、これらのリソースを更新できる頻度が制限されます。
構造化データファイルのアップロードを使用すると、ディスプレイ&ビデオ 360 の管理画面で YouTube とパートナーのリソースを一括で作成または更新できます。構造化データファイルは手動でアップロードする必要がありますが、プロセスの大部分（ファイルの取得と変更）はプログラムで行えます。
詳しくは、SDF ファイルのダウンロードに関する API ガイドと SDF のアップロードに関するドキュメントをご覧ください。