リリースノート

v0（2026-08-01）

新しいフィールド

synthetic_content_info を ad リソースと asset リソースに追加します。また、サポート対象の 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 リソースのクエリで次の指標を使用できるようになりました。

リソース名の修正

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

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel（AdGroupCriterionEffectiveLabel 内）
  • AdGroupAdEffectiveLabel

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

v0（2025-06-12）

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

新しいフィールド

以下を追加します。

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

v0（2025-01-21）

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

MCC 拡張機能

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

このパラメータを有効にすると、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_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）

このアップデートには、時間別セグメンテーションといくつかの新しいフィールドが含まれています。

時間別セグメンテーション

クエリで時間別セグメンテーションを指定できるようになりました。詳しくは、 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）

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

アクセス可能な入札戦略

顧客が所有し、顧客と共有している BiddingStrategy のビューを表します。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 リソースの詳細をご覧ください。

ラベル

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

v0（2022-12-05）

v0 バージョンには、次のリソースとサービスが含まれています。 リンクにアクセスして、各リソースに対してクエリを実行できるフィールドと、そのリソースで使用できる指標とセグメンテーションを確認してください。

広告グループ

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

入札

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

キャンペーン

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

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

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 では、日付フィールドなどのフィールドでセグメンテーションを行うことができます。詳細