v3 から v4 に移行する

最終更新日: 2025 年 7 月 31 日

アプリケーションの移行

v3 から v4 に移行するには、v4 を呼び出すようにエンドポイント URL を更新し、重要な変更に対応するようにアプリケーションを更新する必要があります。

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

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

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

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

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

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

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

必要な変更を加える

v4 では、互換性を破る変更が多数導入されています。以下の手順を確認し、ディスプレイ＆ビデオ 360 API の既存の使用状況に関連する必要な変更を行ってください。

ファーストパーティ オーディエンスとサードパーティ オーディエンスのリソースおよび関連するターゲティングに関する呼び出しを更新

FirstAndThirdPartyAudience リソースが FirstPartyAndPartnerAudience リソースに置き換えられました。

この変更では、次のものを更新する必要があります。

既存の広告グループの一括リスト ターゲティング リクエストを更新する

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions の名前が advertisers.adGroups.bulkListAssignedTargetingOptions に変更されました。新しいメソッド名を使用するように既存のリクエストを更新します。

広告掲載オーダーの作成時に最適化の目標を指定する

optimizationObjective が InsertionOrder リソースの必須フィールドになりました。advertisers.insertionOrders.create リクエストを更新して、このフィールドが設定されていることを確認します。

クリエイティブ リソース フィールド publisherReviewStatuses への参照を削除

publisherReviewStatuses フィールドは、2024 年 6 月に非推奨になった後、Creative リソースの ReviewStatusInfo オブジェクトから削除されました。