リリースノート

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

最新の API バージョン: v2

2025 年 9 月 22 日

既知の問題

使用率が低いため、3 つの Filter 列挙型値を廃止します。これは、ディスプレイ＆ビデオ 360 ヘルプセンターで以前にお知らせしたとおりです。

v2

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

    Filter 値

    FILTER_DFP_ORDER_ID

    FILTER_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

2025 年 3 月 1 日

既知の問題

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

v2

  • 次の列挙値は非推奨になりました。

    列挙型値
    ReportType INVENTORY_AVAILABILITY

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

    フィルタ値

    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 ディメンションは廃止されました。

params.groupBy で廃止値を使用して Query リソースを作成または実行すると、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

params.type が YOUTUBE で、params.metrics に関連する指標値がある Query リソースを作成または実行すると、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 から返されるエラー メッセージを更新し、より具体的な内容にして、より具体的な解決策を提供します。

v2 移行ガイドに沿って、v1.1 から v2 に移行します。

v2

既知の問題

なし。

以前のリリース

廃止されたバージョンの以前の Bid Manager API リリースについては、アーカイブされたリリースノートをご覧ください。