リリースノート

このページでは、Google Bid Manager API のリリースノートを提供します。

最新の API バージョン: v2

2025 年 9 月 22 日

既知の問題

ディスプレイ＆ビデオ 360 ヘルプセンターで以前にお知らせしたとおり、使用頻度が低い 3 つの Filter 列挙値のサポートを終了します。

v2

  • 次の Filters は非推奨になりました。

    Filter 値

    FILTER_DFP_ORDER_ID

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

2025 年 3 月 1 日

既知の問題

ディスプレイ＆ビデオ 360 ヘルプセンターで以前にお知らせしたとおり、YouTube TrueView 広告枠の利用可能性レポートと関連する ディメンションのサポートを終了します。

v2

  • 次のフィルタは非推奨になりました。

    フィルタ値

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • 次の指標は非推奨になりました。

    指標値

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

2024 年 11 月 20 日

新機能

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID がリリースされました。これにより、次の接頭辞が付いた指標について、信頼度の低いデータを含めることができます。

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

このフィルタを使用する場合は、関連する指標のいずれかを含める必要があります。

リリース時、このフィルタを含まないクエリは、信頼度の高いデータのみを含めるという以前のデフォルトの動作になります。 2025 年 2 月 4 日以降、このフィルタを含まないクエリは、デフォルトで 信頼度の低いデータを含めるようになります。

v2

  • 次のフィルタが追加されました。

    フィルタの種類使用可能な値
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: 信頼度の低いデータを含めます。（2025 年 2 月 4 日 以降のデフォルト）

    1: 信頼度の高いデータのみを含めます。（2025 年 2 月 4 日 より前のデフォルト）

2024 年 10 月 1 日

新機能

なし。

既知の問題

v2

匿名広告枠モデリング（AIM）レポート ディメンションのサポート終了

FILTER_ANONYMOUS_INVENTORY_MODELING ディメンションのサポートを終了します。

Query でサポート終了の値を使用して params.groupBy を作成または実行すると、400 エラーが返されます。

DST（デジタル サービス税）/ ROC（規制実施事業費）と合計メディア費用の指標が YOUTUBE レポートと非互換になる

次の指標値は YOUTUBE レポートで使用できなくなります。

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

Query リソースを params.typeが YOUTUBEで、 params.metrics に関連する指標値がある状態で作成または実行すると、400 エラーが返されます。

2024 年 5 月 1 日

新機能

なし。

既知の問題

v2

経路全体レポートと経路アトリビューション レポートのサポート終了

経路全体レポートと経路アトリビューション レポートのサポートを終了します。これらの タイプの Query リソースと Report リソースを取得または作成すると、 エラーが発生します。

次の ReportType値のサポートを終了します。

  • FULL_PATH
  • PATH_ATTRIBUTION

Options オブジェクトの pathQueryOptions フィールドのサポートも終了します。

2024 年 2 月 28 日

新機能

なし。

既知の問題

v2

クロスデバイス コンバージョン指標値のサポート終了

クロスデバイス コンバージョン 指標のサポートを終了します。 次の Bid Manager API 指標 値が含まれます。

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

2022 年 7 月 6 日

新機能

Bid Manager API v2 をリリースしました。

サービス エンドポイントの更新、サービスとメソッドの名前の変更など、API の構造を変更しました。

不要なフィールドの削除、既存のフィールドの再編成、フィールド タイプの変更により、Query リソースと Report リソースを大幅に更新しました。これには、フィールド タイプを一般的な「ネストされたオブジェクト」定義ではなく名前付きオブジェクトを使用するように変更することも含まれます。

作成後に自動的に実行されるのではなく、queries.run メソッド を使用してアドホック クエリを実行する必要がありました。

queries.run クエリ パラメータ asynchronous を synchronous に置き換えました。

次の変更により、レポートの取得を簡素化しました。

API から返されるエラー メッセージを更新し、より具体的な内容と、より規範的な解決策を提供できるようにしました。

v1.1 から v2 に移行するには、v2 移行ガイドの 手順に沿って操作してください。

v2

既知の問題

なし。

以前のリリース

サポート終了バージョンの以前の Bid Manager API リリースの詳細については、 リリースノートのアーカイブをご覧ください。