v2 から v3 に移行する

最終更新日: 2023 年 10 月 31 日

アプリケーションの移行

v2 から v3 に移行するには、v3 と 互換性を破る変更に対応するためにアプリケーションを更新する

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

v2 ではなく v3 を使用するには、新しい v3 を使用するようにリクエストを更新する必要があります 提供します

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

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

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

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

クライアント ライブラリを使用して API にリクエストを送信する場合は、 v3 を使用するように構成を更新してください。

必要な変更を加える

v3 では、互換性を破る変更が多数行われています。以下を確認してください の既存の使用に関連する必要な変更を行う ディスプレイとVideo 360 API。

  • YoutubeAdGroup リソースと YoutubeAdGroupAd リソースが次のリソースに置き換えられました: AdGroup リソースと AdGroupAd リソース。これらの新しいリソースでは v2 リソースとほぼ同じ情報だが、更新されたフィールドを使用する可能性がある 参照できます。統合では、モジュールの使用を YoutubeAdGroup リソースまたは YoutubeAdGroupAd リソース（AdGroup と） AdGroupAd リソースを作成し、次の v2 サービスの呼び出しを更新して、 対応する v3 サービス:
  • YoutubeAndPartnersBiddingStrategy オブジェクトへの参照 新しい youtubeAndPartnersBid フィールドに移動しました このオブジェクトは一般的な BiddingStrategy オブジェクト内にあります。「 「biddingStrategy」フィールドが次から削除されました: YoutubeAndPartnersSettings オブジェクト。統合を YouTube 広告申込情報または広告グループの入札戦略を BiddingStrategy オブジェクト（bidStrategy LineItem または AdGroup リソース。
  • thirdPartyMeasurementSettings フィールドの名前が次のように変更されました。 thirdPartyMeasurementConfigs: YoutubeAndPartnersSettings オブジェクトと YoutubeAndPartnersThirdPartyMeasurementSettings オブジェクトの名前が次のように変更されました: ThirdPartyMeasurementConfigs を選択します。統合を 新しいフィールドを使って第三者測定の設定情報を取得する 渡されます。

広告主の作成時に必要な請求設定を含める

billingConfig が必須フィールドになりました。 Advertiser リソース。advertisers.create を更新する このフィールドが設定されていることを確認するために必要とされます。デフォルトのお支払い情報には、 新しい Partner を使用して親パートナー用に取得します。 リソースの billingConfig フィールド。

新しいフィールドを使用して最適化されたターゲティングを管理する

新しいブール値フィールド enableOptimizedTargeting が、 TargetingExpansionConfig の targetingExpansionLevel フィールド 渡されます。

新しい KPI フィールドを使用するには、広告掲載オーダーの統合を更新してください

新しい kpi フィールドが performanceGoal フィールドを置き換えました。 InsertionOrder リソース。この新しいフィールドでは Kpi を使用します。 PerformanceGoal オブジェクトの代わりにオブジェクトを作成し、新しいフィールドと列挙型を使用します。

非推奨のサービスとフィールドへの参照を削除

これまでの機能に合わせて、v3 ではさまざまなエンティティが削除されました 非推奨化:

その他の変更

v3 では、上記の互換性を破る変更に加え、 説明します。

初回リリース後に v3 に追加された機能は、リリース メモをご覧ください。

近隣地域リストの管理

v3 では、近隣地域リストを完全に管理できるため、次のことが可能になります。 advertisers.locationLists.assignedLocations サービスを使用する TARGETING_LOCATION_TYPE_PROXIMITY に割り当てられたビジネス情報を作成、削除する LocationList のリソース。ロケーションは、ID を使用して識別されます。 TARGETING_TYPE_POI TargetingOption リソース。これらは次のいずれかです。 targetingTypes.targetingOptions.search を使用して取得します。

ルールベースのカスタム入札アルゴリズムを構築可能

v3 では、 customBiddingAlgorithms、media、 customBiddingAlgorithms.rules サービス。

この機能はベータ版であり、許可リストに登録されたパートナーのみご利用いただけます。お使いの パートナーが許可リストに登録されていない場合、リクエストに対してエラーが返されます。