ディスプレイ＆ビデオ 360 API でデマンドジェネレーションリソースの管理がサポートされるようになりました。デマンドジェネレーション広告キャンペーンを作成して実行する方法については、新しいガイドをご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Display & Video 360 API v4 から v5 に移行する

最終更新日: 2026 年 10 月 22 日

アプリケーションの移行

v4 から v5 に移行するには、v5 を呼び出すようにエンドポイント URL を更新し、互換性を破る変更に対応するようにアプリケーションを更新して、統合に役立つ可能性のある新機能を確認する必要があります。

API 呼び出しを v4 から v5 に更新する

v4 ではなく v5 を使用するには、新しい v5 エンドポイントを使用するようにリクエストを更新する必要があります。

たとえば、v4 で advertisers.get メソッドを呼び出すには、次の URL を使用します。

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

v5 の場合は、URL を次のように更新します。

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

クライアントライブラリを使用して API にリクエストを送信している場合は、最新バージョンのクライアントライブラリを使用し、v5 を使用するように構成を更新します。

必要な変更を加える

Display & Video 360 API v5 では、互換性を破る変更がいくつか導入されています。以下の手順を確認し、Display & Video 360 API の既存の使用に関連する必要な変更を行ってください。

Display & Video 360 API v4 と v5 の違いの完全なリストについては、リリースノートをご覧ください。

新しい ID とタイプを使用するように、広告在庫ソースの取得とターゲティングを更新

Display & Video 360 API v5 では、広告在庫ソースの取引とオークションパッケージの取得方法とターゲティング方法が変更されています。

v4 では、inventorySources サービスを使用して取得された InventorySource リソースは、広告在庫ソースの取引とオークションパッケージの両方を表します。取引とオークションパッケージはどちらも TARGETING_TYPE_INVENTORY_SOURCE を使用してターゲティングされます。

v5 では、広告在庫ソースの取引とオークションパッケージは別々に処理されます。

広告在庫ソースの取引は、TARGETING_TYPE_INVENTORY_SOURCE_DEAL を使用してターゲティングされ、advertisers.inventorySources サービスと partners.inventorySources サービスを使用して取得され、AssignedTargetingOption フィールド inventorySourceDetails を使用してターゲティングされます。
オークションパッケージは TARGETING_TYPE_AUCTION_PACKAGE を使用してターゲットに設定され、targetingTypes.targetingOptions サービスを使用して取得され、AssignedTargetingOption フィールド auctionPackageDetails を使用してターゲットに設定されます。

この更新により、既存の取引とオークションパッケージに使用される ID が変更されるため、移行後に以前にキャッシュに保存された InventorySource リソース ID を使用することはできません。

これらの変更に加えて、v5 では広告在庫ソースのアクセサーを作成、更新、編集する機能も削除されています。

デマンドジェネレーションと YouTube リソースのオーディエンスターゲティングロジックを更新

ディスプレイ＆ビデオ 360 API v5 では、デマンドジェネレーションと YouTube リソースのオーディエンスターゲティングロジックが更新され、ターゲットオーディエンスリストごとに個別の割り当てオプションが使用されるようになりました。

v4 では、すべてのオーディエンスターゲティングが TARGETING_TYPE_AUDIENCE_GROUP を使用して管理されます。

v5 では、デマンドジェネレーションと YouTube の広告グループに割り当てられたオーディエンスターゲティングは、オーディエンスのタイプに応じて、次のいずれかのターゲティングタイプと AssignedTargetingOption リソースフィールドを使用して管理されます。

combinedAudienceDetails を使用した TARGETING_TYPE_COMBINED_AUDIENCE
customListDetails を使用した TARGETING_TYPE_CUSTOM_LIST
TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE（firstPartyAndPartnerAudienceDetails を使用）
googleAudienceDetails を使用した TARGETING_TYPE_GOOGLE_AUDIENCE
lookalikeAudienceDetails を使用した TARGETING_TYPE_LOOKALIKE_AUDIENCE

広告申込情報では、引き続き 1 つの TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption を使用して、すべてのタイプのオーディエンスターゲティングを管理します。

カスタマーマッチオーディエンスの管理に Data Manager API を使用する

ディスプレイ＆ビデオ 360 API v5 では、次のメソッドが削除され、カスタマーマッチオーディエンスのメンバーシップを作成、管理する機能が削除されました。

firstPartyAndPartnerAudiences.create
firstPartyAndPartnerAudiences.editCustomerMatchMembers
firstPartyAndPartnerAudiences.patch

カスタマーマッチオーディエンスの管理を継続するには、Data Manager API を使用するようにワークフローをアップグレードしてください。

デジタル屋外広告掲載オーダーの取得のサポートを追加

ディスプレイ＆ビデオ 360 API v5 では、デジタル屋外広告の広告申込情報の取得がサポートされるようになりました。

広告主がデジタル屋外広告を使用している場合は、insertionOrderType フィールド値が OUT_OF_HOME の InsertionOrder リソースが含まれることを想定して、advertisers.insertionOrders.list を呼び出す統合をアップグレードします。

v5 では、デジタル屋外広告の広告掲載オーダーの広告申込情報は、v4 と同様に取得できます。

Adloox への参照を Peer39 に更新

v5 では、Adloox（Scope3 とも呼ばれる）とのディスプレイ＆ビデオ 360 の第三者ブランド適合性統合を参照するフィールドと列挙値が Peer39 に更新されました。

ThirdPartyVerifierAssignedTargetingOptionDetails フィールド adloox は peer39 に置き換えられました。
PartnerCostType 列挙値 PARTNER_COST_TYPE_ADLOOX と PARTNER_COST_TYPE_ADLOOX_PREBID が PARTNER_COST_TYPE_PEER39 と PARTNER_COST_TYPE_PEER39_PREBID に置き換えられました。

YouTube の広告申込情報、広告グループ、広告のフィールドを更新する

v5 では、LineItem、AdGroup、AdGroupAd リソースのさまざまなフィールドが削除または更新されています。これらの変更を考慮して、リソース取得ロジックを更新してください。

LineItem リソースで、次の操作を行います。

YoutubeAndPartnersSettings フィールド relatedVideoIds は relatedVideos に置き換えられました。

LineItem リソースと AdGroup リソース:

TargetingExpansionConfig フィールド audienceExpansionSeedListExcluded と audienceExpansionLevel が削除されました。

AdGroupAd リソースで、次の操作を行います。

containsSyntheticMedia フィールドが追加されました。
AudioAd、CommonInStreamAttribute、VideoPerformanceAd オブジェクトの trackingUrl フィールドは、trackingUrl と userSpecifiedTrackingUrl の 2 つのフィールドに分割され、トラッキングに使用される URL とユーザーが指定したトラッキング URL を区別できるようになりました。

非推奨の列挙値への参照を削除する

v5 では、以前に非推奨となった列挙値が完全に削除されました。API へのリクエストでこれらの値を使用すると、v4 ではエラーが発生していましたが、この変更により、v5 クライアントライブラリからこれらの値への参照が削除されます。コード内でこれらの非推奨の値が参照されていると、v5 へのアップグレード時にエラーが発生する可能性があります。

影響を受ける値を持つ列挙型には、ContentRatingTier、GoogleAudienceType、SdfVersion、SensitiveCategory があります。削除されたすべての列挙値の完全なリストについては、リリースノートをご覧ください。

新機能を確認する

互換性を破る変更に加えて、v5 では次の新機能も導入されています。

ターゲティングタイプ TARGETING_TYPE_YOUTUBE_VIDEO と TARGETING_TYPE_YOUTUBE_CHANNEL で、広告主レベルでの YouTube 動画とチャンネルの除外ターゲティングを完全に管理できます。v4 では、このターゲティングは読み取り専用でした。
デジタル屋外広告 InsertionOrder リソースを作成する機能。
AdGroup フィールド adSource と creativeAssignments、AdGroupAd フィールド parentCreativeId を追加することで、割り当てられたクリエイティブを使用して広告を生成する広告グループをサポート。
LookalikeAudience リソースを作成して取得する機能。
AdGroupAd リソースの新しい containsSyntheticMedia フィールド。