リリースノート

v0(2026-11-09)

新しいセグメント

次のセグメントが追加されます。

v0(2026-08-01)

新しいフィールド

ad リソースと asset リソースに synthetic_content_info を追加し、サポートする SyntheticContentInfo メッセージ、SyntheticContentAttestationStatus、SyntheticContentSource 列挙型を追加します。

v0(2026-03-10)

新しいセグメント

次のセグメントが追加されます。

v0(2025-12-05)

新しい指標

campaign リソースをクエリするときに、次の指標を使用できるようになりました。

カート コンバージョン レポート(CwCD)の指標として、以下が追加されます。

新しいセグメント

クエリで郵便番号のセグメンテーションを指定できるようになりました。詳しくは、segments.geo_target_postal_code をご覧ください。

v0(2025-11-10)

新しい URL フィールド

追加

UserLocationView の新しい指標

user_location_view リソースをクエリするときに、次の指標を使用できるようになりました。

リソース名の修正

次の有効なラベルリソースのリソース名パターンが、ラベルを所有するお客様 ID が含まれるように、owner_customer_id を使用するように修正されました。

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • (AdGroupCriterionEffectiveLabel にある)CriterionEffectiveLabel
  • AdGroupAdEffectiveLabel

例: CampaignEffectiveLabel のパターンが customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} から customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} に変更されました。

v0(2025-06-12)

この更新には、customer リソースの新しいフィールドが含まれています。これらの変更をすべて利用するには、クライアント ライブラリを更新してください。

新しいフィールド

追加

。検索広告 360 のアカウント階層を移動する際に役立ちます。

v0(2025-01-21)

このアップデートには、MCC 拡張を構成するための新しいパラメータが含まれています。

MCC の拡大

bidding_strategy をクエリするときに、PARAMETERS セクションでブール値(enable_mcc_expansion)を設定できるようになりました。

このパラメータを有効にすると、customer_id をルートとするアカウント階層内のすべてのアカウントのデータがレスポンスで返されます。

v0(2024-11-08)

この更新には、新しいフィールドと新しいリソースが含まれています。これらの変更をすべて利用するには、クライアント ライブラリを更新してください。

新しいフィールド

ad_group_ad.effective_labels と ad_group_criterion.effective_labels を追加しています。

有効なラベルとは、継承されたラベルまたは直接割り当てられたラベルのことです。

新しいリソース

ユーザーの所在地ビュー

地域セグメントと組み合わせて使用すると、地域、大都市圏、都市に関連する指標を取得できます。

user_location_view リソースの詳細をご覧ください。

新しい effective_labels フィールドに関連して、有効なラベルと ad_group_ad(ad_group_ad_effective_label)または ad_group_criterion(ad_group_criterion_effective_label)の関連付けのメタデータを保持する 2 つの新しいリソースがあります。

v0(2024-10-07)

この更新には、新しい指標、リソース、フィールド、新しいマッピング定義が含まれています。これらの変更をすべて利用するには、クライアント ライブラリを更新してください。

指標を追加しました

cross_device_conversions_by_conversion_date と cross_device_conversions_value_by_conversion_date は、ad_group_ad、ad_group_audience_view、ad_group、bidding_strategy、campaign、customer、campaign_audience_view、keyword_view、shopping_performance_view のリソースに対応しています。

フィールド マッピングの再定義

一部の以前のレポートで、dfaActions、dfaActionsCrossEnv、dfaRevenue、dfaRevenueCrossEnv、dfaTransactions、dfaTransactionsCrossEnv のフィールド マッピングが変更されました。

フィールド 以前 新しい定義
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

フィールド マッピングが変更された従来のレポートのリスト

新しいフィールド

campaign.effective_labels と ad_group.effective_labels を追加しています。

有効なラベルとは、継承されたラベルまたは直接割り当てられたラベルのことです。

新しいリソース

新しい effective_labels フィールドに関連して、新しいリソースは、有効なラベルとキャンペーン(campaign_effective_label)または ad_group(ad_group_effective_label)の関連付けのメタデータを保持します。

v0(2024-08-23)

この更新では、カスタム列のメタデータに renderType フィールドが追加されます。

CustomColumnRenderType の詳細をご覧ください。

新しい owner_customer_id フィールドが campaign_label、ad_group_label、ad_group_ad_label、ad_group_criterion_label リソースに追加されました。

これらの新しいフィールドを利用するには、クライアント ライブラリを更新してください。

v0(2024-08-01)

この更新には、1 時間ごとのセグメンテーションといくつかの新しいフィールドが含まれています。

時間単位のセグメンテーション

クエリで時間単位のセグメントを指定できるようになりました。詳しくは、segments.hour をご覧ください。

詳しくは、customer_manager_link.start_time をご覧ください。

ad_group_ad.ad.type に MULTIMEDIA_AD を追加しました。

MULTIMEDIA_AD タイプで指標とセグメントを選択できるようになりました。このバージョンでは、マルチメディア固有の属性のクエリはサポートされていません。

campaign.advertising_channel_type に SOCIAL キャンペーン タイプを追加し、campaign.advertising_channel_sub_type に SOCIAL_FACEBOOK_TRACKING_ONLY サブタイプを追加しました。

指標とセグメントを、SOCIAL キャンペーン タイプと SOCIAL_FACEBOOK_TRACKING_ONLY サブタイプで選択できるようになりました。このバージョンでは、SOCIAL または SOCIAL_FACEBOOK_TRACKING_ONLY 固有の属性のクエリはサポートされていません。

average_quality_score のサポートを追加しました

詳細については、指標をご覧ください。

v0(2024-04-18)

この更新には、アクセス可能な入札戦略リソースが含まれています。

アクセス可能な入札戦略

顧客が所有し、顧客と共有している BiddingStrategies のビューを表します。BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様のマネージャーが所有し、このお客様と共有している戦略が含まれます。このリソースは指標を提供せず、BiddingStrategy 属性の限定されたサブセットのみを公開します。

accessible_bidding_strategy リソースの詳細をご覧ください。

v0(2024-02-12)

この更新により、カスタム列とカスタム Floodlight 変数にアクセスできるようになります。

カスタム列

カスタム コンバージョン列とカスタム数式列をクエリで指定できるようになりました。詳しくは、カスタム列のドキュメントをご覧ください。

カスタム Floodlight 変数

2024 年 1 月 30 日以降の統計情報について、クエリでカスタム Floodlight 変数を指定できるようになりました。詳しくは、カスタム Floodlight 変数のドキュメントをご覧ください。

v0(2023-11-09)

このアップデートには、次のリソースが含まれています。リンクにアクセスして、これらのリソースに対してクエリできるフィールドと、それらで使用できる指標とセグメンテーションを確認してください。

アセット グループ

asset_group リソースの詳細をご覧ください。

アセット グループのアセット

asset_group_asset リソースの詳細をご覧ください。

アセット グループのリスティング グループのフィルタ

asset_group_listing_group_filter リソースの詳細をご覧ください。

アセット グループのシグナル

asset_group_signal リソースの詳細をご覧ください。

アセット グループの上位の組み合わせビュー

asset_group_top_combination_view リソースの詳細をご覧ください。

カートのデータ販売ビュー

cart_data_sales_view リソースの詳細をご覧ください。

コンバージョン

conversion リソースの詳細を確認します。

ショッピングの掲載結果ビュー

shopping_performance_view リソースの詳細をご覧ください。

アクセス

visit リソースの詳細をご覧ください。

v0(2023-08-15)

このアップデートには、次のリソースと、指標の通貨換算を構成するための新しいパラメータが含まれています。

リンクにアクセスして、これらのリソースに対してクエリできるフィールドと、それらで使用できる指標とセグメンテーションを確認してください。

広告グループのアセット

ad_group_asset リソースの詳細をご覧ください。

広告グループのアセットセット

ad_group_asset_set リソースの詳細をご覧ください。

アセット

asset リソースの詳細を確認する。

アセットセット

asset_set アセットセットのリソースの詳細をご覧ください。

アセットセットのアセット

asset_set_asset アセットセット リソースの詳細をご覧ください。

キャンペーンのアセット

campaign_asset リソースの詳細をご覧ください。

キャンペーン アセットセット

campaign_asset_set アセットセット リソースの詳細をご覧ください。

お客様のアセット

customer_asset リソースの詳細をご覧ください。

顧客のアセットセット

customer_asset_set アセットセット リソースの詳細をご覧ください。

通貨換算

PARAMETERS セクションの metrics_currency を使用して、指標の計算に使用する通貨を指定できます。

アクセス可能な顧客をリストアップする

ListAccessibleCustomers メソッドを使用して、アクセス可能なすべてのアカウントを一覧表示します。

v0(2023-05-15)

この更新には、次のリソースが含まれています。リンクにアクセスして、このリソースでクエリできるフィールドと、このリソースで使用できる指標とセグメンテーションを確認してください。

広告グループ広告

ad_group_ad リソースの詳細をご覧ください。

v0(2023-04-06)

このアップデートには、次のリソースが含まれています。リンクをクリックすると、各リソースでクエリできるフィールドと、そのリソースで使用できる指標とセグメンテーションが表示されます。

広告グループのオーディエンス ビュー

ad_group_audience_view リソースの詳細をご覧ください。

広告グループの条件ラベル

ad_group_criterion_label リソースの詳細をご覧ください。

広告グループのラベル

ad_group_label リソースの詳細をご覧ください。

年齢層ビュー

age_range_view リソースの詳細をご覧ください。

キャンペーン条件

campaign_criterion リソースの詳細をご覧ください。

キャンペーン ラベル

campaign_label リソースの詳細を確認する

動的検索広告の検索語句ビュー

dynamic_search_ads_search_term_view リソースの詳細をご覧ください。

ウェブページ ビュー

webpage_view リソースの詳細をご覧ください。

ラベル

ラベルリソースの詳細をご覧ください。

v0(2022-12-05)

v0 バージョンには、次のリソースとサービスが含まれています。リンクをクリックすると、各リソースでクエリできるフィールドと、そのリソースで使用できる指標とセグメンテーションが表示されます。

広告グループ

ad_group リソースの詳細をご覧ください。

入札

bidding_strategy リソースの詳細をご覧ください。

キャンペーン

キャンペーン リソースの詳細をご覧ください。

コンバージョン アクション

conversion_action リソースの詳細をご覧ください。

お客様

customer リソースの詳細をご覧ください。

キーワード

keyword_view リソースの詳細をご覧ください。

商品グループ

product_group_view リソースの詳細をご覧ください。

SearchAds360FieldService

  • SearchAds360FieldService は、クエリ可能なすべてのフィールドのカタログを提供します。これらのフィールドのメタデータには、説明、タイプ、他のフィールドとの互換性が含まれます。詳細

SearchAds360Service

  • SearchAds360Service は、1 つのクエリで複数のリソースを取得するためのものです。クエリ可能なリソースには、次のものがあります。

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup
  • 表示回数やクリック数などの指標は、次のリソースの SearchAds360Service を使用して取得することもできます。

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup
  • SearchAds360Service を使用すると、日付フィールドなどのフィールドでセグメント化できます。詳細