リリースノート

現在および計画中の機能の非推奨の最新リストについては、機能の非推奨をご覧ください。

v24 のメジャー バージョンとマイナー バージョン

Google Ads API v24 には、以下の新機能、更新、互換性を損なう変更が含まれています。

v24.2（2026 年 6 月 24 日）

Google Ads API v24.2 では、以下の新機能とアップデートが追加されました。v24.2 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
広告
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT 新しい列挙値 ランディング ページからテキスト情報を生成し、DemandGenVideoResponsiveAd インスタンスのエンゲージメント パネルに表示します（この API バージョン以降ではデフォルトでオプトインされています）。
アセット
AssetGroup.google_local_services_info 新しいフィールド P-MAX キャンペーンでローカル サービス広告の情報（カテゴリ ID とコールアウト）がサポートされるようになりました。
AssetGroupSignal.local_services_id 新しいフィールド P-MAX キャンペーンでローカル サービス広告のサービス ID シグナルをサポートするために追加されました。
AssetGroupSignal.vertical_ads_item_group_rule_list 新しいフィールド P-MAX キャンペーンで、添付された業種別フィードからアイテムを選択するための業種別広告アイテム グループ ルールをサポートするために追加されました。この機能は、許可リストに登録されたアカウントでのみご利用いただけます。
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN 新しい列挙値 / エラー キャンペーンからすべてのアセット グループを削除しようとしたときに返されます。
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS 新しい列挙値 / エラー アセット グループからすべてのシグナルを削除しようとしたときに返されます。
キャンペーン
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 新しいフィールド ローカル サービス P-MAX キャンペーンの特定をサポートします。
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps 新しいフィールド デマンド ジェネレーション広告グループで選択可能なチャネルに Google マップが含まれます。
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN 新しい列挙値 / エラー ローカル サービス P-MAX キャンペーンからすべての地域を削除しようとしたときに返されます。
SmartCampaignErrorEnum.CREATION_FAILED 新しい列挙値 / エラー 新しいスマート アシスト キャンペーンを作成しようとしたときに返されます。
コンバージョン数
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 新しい列挙値 ユーザーがローカル サービス広告をクリックして、広告主に電話をかけたり、メッセージを送信したり、予約したりした場合に発生するコンバージョンを表します。
テスト
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 新しい列挙値 新しい ExperimentType タイプ（
    ）のサポートを追加しました。
  • COMPARE_CAMPAIGNS: 1 つのテストで同じタイプまたは異なるタイプの複数のキャンペーンを比較するキャンペーン混合テストと P-MAX のカスタムテストの場合。
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: テキストのカスタマイズと最終ページ URL の拡張に関する P-MAX の最適化テスト。
全般
Asset.synthetic_content_info
Ad.synthetic_content_info		 新しいフィールド 合成コンテンツ/AI 生成コンテンツの証明を含みます。advertiser_input（広告主様が直接提供した宣言）と system_input（システムが自動的に検出または提供した証明）に分かれています。

この機能は v23 と v22 にバックポートされています。

v25 での今後の統合作業の計画に役立つよう、広告主様の証明書フィールドを変更するためのインターフェースが v22 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、synthetic_content_info.advertiser_attestation.status と synthetic_content_info.advertiser_attestation.source はこれらのバージョンでは変更できません。

これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。

「The field attempted to be mutated is immutable」または「Field cannot be set」。

これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。
マルチパーティ認可 新機能 複数当事者承認（MPA）の審査のサポートを追加しました。
この機能は、v23.3、v22.2、v21.2 にバックポートされています。
IncentiveService.FetchIncentive 動作の変更 リクエストで無効なメールアドレスが指定された場合、このメソッドは AuthenticationError.INVALID_EMAIL_ADDRESS エラーをスローする代わりに、デフォルトのインセンティブ オファーを返すようにフォールバックするようになりました。
計画
GenerateCreatorInsightsRequest.search_topics 新しいフィールド ContentCreatorInsightsService.GenerateCreatorInsights サービスに追加されました。このオプションでは、country_locations で指定した国で、特定のトピックについて話しているクリエイターを検索します（検索できるのは 1 つの国のみです）。
CREATOR_TOPIC_INSIGHTS 新しい列挙値 InsightsKnowledgeGraphEntityCapabilities に追加され、トピックについて話しているクリエイターを検索するためのエンティティを示します。これらのエンティティは search_topics フィールドで使用する必要があります。AudienceInsightsService.ListAudienceInsightsAttributes を使用して取得されます。
KnowledgeGraphEntitySearchOptions 新しいタイプ / オプション ListAudienceInsightsAttributes のトピックに関する追加の検索オプションが含まれます。これには、クリエイター属性としてサポートされているすべてのトピックを取得するオプションや、機能でフィルタするオプションが含まれます。
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 新しいフィールド ContentCreatorInsightsService メソッドへの省略可能な入力。このフィールドを指定すると、レスポンスに追加の場所やクリエイターの属性が入力されます。
local_creator_insights
related_local_creators		 新しいフィールド supplemental_data に LOCAL_CREATOR_DATA 列挙型が含まれている場合に設定されます。選択した国で視聴された、または選択した国を拠点とする、位置情報の共有に同意したローカル クリエイターが表示されます。
GenerateTrendingInsightsRequest.sub_country_locations 新しいフィールド ContentCreatorInsightsService.GenerateTrendingInsights に追加され、国と地域を使用して急上昇の分析情報を検索できるようになりました。
レポート
PerformanceMaxPlacementView セグメント拡張機能 ad_network_type でセグメント化可能になりました。
ショッピング
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads 新しいフィールド true の場合、ショッピング広告でブランド除外が無視されます。ショッピング キャンペーンでのみサポートされています。
ターゲティング
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE 新しい列挙値 / エラー 許可されていない言語をターゲットにしようとしたときに返されます。
動画
DataLink.youtube_link_metadata 新しいフィールド リンクされた YouTube ブランド チャンネルの ID を指定する brand_channel_id が含まれます。

v24.1（2026 年 5 月 13 日）

Google Ads API v24.1 では、以下の新機能とアップデートが追加されました。v24.1 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
広告
DemandGenMultiAssetAdInfo.classic_display_images 新しいフィールド カスタム アップロードのディスプレイ画像は、追加のレスポンシブ アセットを必要とせずに配信されます。
テスト
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 新しい列挙値 新しい ExperimentType タイプ（
    ）のサポートを追加しました。
  • ADOPT_AI_MAX: AI 最大化設定を有効にして Google AI とインテント マッチ キーワードを活用することで、どのようにユーザーへのアプローチが増加するかをテストするテストの場合。
  • ADOPT_BROAD_MATCH_KEYWORDS: インテント マッチ キーワードが広告の表示対象となる検索の数に与える影響をテストするテスト。
  • OPTIMIZE_ASSETS: アセットを最適化するためのカスタム テストの場合。
  • PMAX_REPLACEMENT_SHOPPING: ショッピング キャンペーンと P-MAX キャンペーンのパフォーマンスを比較するテストの場合。
Experiment.video_experiment 新しいフィールド 動画キャンペーンで構成される既存の YOUTUBE_CUSTOM テストの設定をサポートします。
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 新しいフィールド テスト群でアセットのテスト、アセット グループ、P-MAX の設定をサポートするフィールドを公開します。
  • asset_testing_info: 広告のテストコピーに関連付けられているアセットの詳細。
  • asset_groups: オプティマイズ アセット テストの実験群のアセット グループのリスト。
  • performance_max_experiment_arm_info: PMAX_REPLACEMENT_SHOPPING テストの P-MAX キャンペーンの設定。
全般
CustomerUserAccess.passkey_enabled 新しいフィールド ユーザーがパスキーを有効にしているかどうかを示す読み取り専用フィールド。
レポート
mobile_device_platform 新しいセグメント ユーザーのデバイスのプラットフォーム（iOS、Android など）でレポートをセグメント化できます。
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED 新しい列挙値 / エラー リクエストされた日単位、時間単位、週単位の粒度がクエリの期間で対象外の場合に返されます（過去 37 か月間のみ使用可能）。
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 新しいセグメント 縦型広告に使用される新しいセグメント。
user_rating、venue、event_participant_display_name 新しいフィルタ条件 SharedCriterion リソースの VerticalAdsItemGroupRuleInfo でのフィルタリングをサポートしました。
コントロール群と介入群のテスト指標 新しいフィールド 7 つのコア指標ファミリ（クリック数、インプレッション数、費用、コンバージョン数、コンバージョン単価、コンバージョン値、費用あたりのコンバージョン値）全体に、コントロール値（control_clicks など）、トリートメント値（clicks など）、点推定値（clicks_point_estimate など）、誤差の範囲（clicks_margin_of_error など）、p 値（clicks_p_value など）を追加しました。
コンバージョン数の絶対変化の指標 新しいフィールド 点推定、許容誤差、p 値の各フィールドを使用した Conversions 絶対差の推定のサポート。
ターゲティング
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS 新しい列挙値 / エラー すべてのユーザー属性のターゲットを除外しようとしたときに返されます。
動画
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR 新しい列挙値 ZEFR を第三者の視認性統合パートナーとして公開しました。
DataLink.youtube_video.channel_id 新しいフィールド データリンクに関連付けられた YouTube チャンネル ID を公開します。

v24（2026 年 4 月 22 日）

Google Ads API v24（メジャー リリース）では、次の新機能、アップデート、重大な変更が追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
広告
DemandGenVideoResponsiveAdInfo の省略可能な videos と logo_images 必須項目 行動の変化 レスポンシブ デマンド ジェネレーション動画広告を作成または変更する際に、videos と logo_images を指定します。
VideoResponsiveAdInfo のオプションの videos、business_name、logo_images 必須項目 行動の変化 動画レスポンシブ広告を作成または変更するときに、videos、business_name、logo_images を指定します。VideoResponsiveAdInfo は変更可能になりました。
キャンペーン
Campaign.video_brand_safety_suitability なし 削除 キャンペーン単位の適合性コントロールが削除されます。ブランド保護の適合性は、引き続きお客様のレベルでご利用いただけます。代わりに Customer.video_brand_safety_suitability を使用してください。
コンバージョン数
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS なし 削除 ポイントカード登録のユーザー カテゴリが削除されました。それへのコード参照を削除します。
計画
topic_audience_combinations の InsightsAudienceAttributeGroup 型 common.InsightsAudienceAttributeGroup タイプ 行動の変化 / タイプの変更 型付きクライアント ライブラリの統合は、新しいリソース Namespace を使用するように更新する必要があります。
ReachPlanService.ListPlannableProducts の youtube_select_lineups フィールド なし 削除 youtube_select_lineup_targeting からラインナップの使用に切り替えます。
ContentCreatorInsightsService.GenerateCreatorInsights と GenerateTrendingInsights の is_brand_connect_creator フィールド なし 削除 代わりに、クリエイターが partnership_opportunities で CREATOR_PARTNERSHIPS を利用できるかどうかを確認します。
KeywordPlanIdeaService.GenerateKeywordForecastMetrics の geo_modifiers と biddable_keywords geo_target_constants、keywords 名前の変更 / 削除 CampaignToForecast.geo_target_constants[] と ForecastAdGroup.keywords[] に置き換えられました。
GenerateKeywordForecastMetrics でキーワード プラン / 予測フィールドが非推奨になりました なし 削除 次のプラン / 予測のフィールドとタイプを削除しました。 インテグレーションを適宜更新します。
レポート
campaign_budget の ad_sub_network_type セグメント なし 削除 campaign_budget リソースの ad_sub_network_type セグメントを削除しました。
アセットビューの click_type セグメント なし 削除 AdGroupAsset、CampaignAsset、CustomerAsset ビューからセグメントを削除しました。
動画
ShareablePreviewService.GenerateShareablePreviews で部分的な失敗が許可される 部分的な失敗なし 行動の変化 リクエスト内の ID のいずれかが検証に失敗すると、リクエストは失敗し、エラーがスローされます。
ShareablePreviewError レガシーコード: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 名前の変更 / 行動の変化 アセット グループに対して返されるエラーコードが、広告グループ広告のエラーと一致するように変更されました。検証キャッチ ロジックを更新します。

機能とアップデート（非破壊的）

機能とアップデート タイプ 説明
広告
VideoResponsiveAdInfo の可変性 動作の変更 レスポンシブ動画広告の情報オブジェクトが変更可能になりました。
アセット
AssetSet の travel_feed_data 新しいフィールド 旅行フィード アセットの属性（hotel_center_account_id、merchant_center_id、partner_center_id、subset_id、travel_feed_vertical_type）を取得するために追加されました。
キャンペーン
Campaign.view_through_conversion_optimization_enabled 新しいフィールド デマンド ジェネレーション キャンペーンとアプリ キャンペーンでビュースルー コンバージョン（VTC）の最適化を有効にできます（デフォルトは false）。
CampaignCriterion.gender 新機能 すべての Google Ads API バージョンで、P-MAX キャンペーンの性別除外を有効にしました。
コンバージョン数
見込み顧客発掘のコンバージョン タイプ 新しい列挙値 ConversionActionType に新しい GA4/Firebase コンバージョン アクション タイプの列挙型を追加しました。
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
全般
UserListErrorEnum.DUPLICATE_LOOKALIKE 新しい列挙値 / エラー 同一の類似ユーザー リストを複数作成しようとした場合に返されます。
計画
ListPlannableProductsResponse の ProductCoreAttributes フィールド 新しいフィールド ListPlannableProductsResponse の ProductCoreAttributes に、計画可能なプロダクトの説明、マーケティングの目標、費用モデル、購入方法を追加しました。
レポート
CartDataSalesView 新しいレポート リソース クリックされた商品に加えて、販売された特定の商品（ブランドなど）別にコンバージョン指標を分割したレポートを表示します。
入札不可の指標 新しいフィールド 入札不可の指標（キャンペーンで最適化されていないコンバージョンを示す指標）を、一致するすべてのリソースに追加しました。
conversion_attribution_event_type 新しいセグメント ShoppingPerformanceViewに追加しました。
ショッピング
ShoppingProduct のアプリ キャンペーン 新機能 ShoppingProduct リソース内でサポートされているアプリ キャンペーン。メモのステータスと問題はサポートされていません。
タグベースの商品フィルタリング 新機能 論理セット式を使用して動的にフィルタリングを導入しました。 この機能は、許可リストに登録されたアカウントのみ利用可能です。

v23 のメジャー バージョンとマイナー バージョン

Google Ads API v23 には、次の新機能、更新、互換性を破る変更が含まれています。

v23.3（2026 年 6 月 24 日）

Google Ads API v23.3 では、以下の新機能とアップデートが追加されました。v23.3 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
全般
Asset.synthetic_content_info
Ad.synthetic_content_info		 新しいフィールド 合成コンテンツ/AI 生成コンテンツに関する証明が含まれます。advertiser_attestation（広告主が直接提供した宣言）と system_attestation（Google のシステムが自動的に検出または提供した証明）に分かれています。

v25 での今後の統合作業の計画に役立つよう、広告主様の証明書フィールドを変更するためのインターフェースが v22 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、synthetic_content_info.advertiser_attestation.status と synthetic_content_info.advertiser_attestation.source はこれらのバージョンでは変更できません。

これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。

「The field attempted to be mutated is immutable」または「Field cannot be set」。

これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。
複数の関係者による承認 新機能 マルチパーティ承認（MPA）の審査のサポートを追加しました。

v23.2（2026 年 3 月 25 日）

Google Ads API v23.2 では、以下の新機能とアップデートが追加されました。v23.2 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
アセット
VideoEnhancement 新しいリソース Google 生成か広告主提供かなど、拡張機能に固有の動画広告情報が含まれます。詳しくは、動画拡張についてをご覧ください。
AppTopCombinationView 新しいリソース アプリ キャンペーンでパフォーマンスの高いアセットの組み合わせに関する分析情報を提供する読み取り専用リソース。
CustomerAsset 新機能 field_type が BUSINESS_LOGO に設定されている CustomerAsset を取得するサポートを追加しました。
キャンペーン
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 新しいフィールド キャンペーンの期間について、より詳細なスケジュール設定の制約を指定できます。これは、一部の広告グループ タイプでのみサポートされています。
HotelSettingInfo.disable_hotel_setting 新しいフィールド デマンド ジェネレーション キャンペーンでホテルフィードを無効にできます。
全般
CustomerClientLinkError 新しい列挙値 / エラー 2 つの新しいエラーコード（MAX_CUSTOMER_LIMIT_REACHED と ACCOUNT_CREATION_POLICY_VIOLATION）を追加しました。
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS 動作の変更 このユーザーリストの顧客タイプ カテゴリを使用しようとすると、エラーがスローされるようになりました。
計画
GenerateTrendingInsights
GenerateCreatorInsights		 新機能 エンティティ、トピック、オーディエンスのカスタム AND/OR 組み合わせのサポートを追加しました。
ReachPlanService.GenerateReachForecast 新しい列挙値 AGE_RANGE_21_44 や AGE_RANGE_21_49 など、新しいターゲティング可能な年齢層を追加しました。
youtube_select_lineup_targeting 新しいフィールド ReachPlanService.ListPlannableProducts に追加しました。これは youtube_select_lineups に代わるものです。現在、両方のフィールドにデータが入力されています。
ReachPlanSurface 新しい列挙値 サーフェス オプションとして IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS を追加しました。
Forecast 新しいフィールド ReachPlanService.GenerateReachForecast で、デマンド ジェネレーションのクリック数の最大化（CPC）に clicks を追加しました。
partnership_opportunities 新しいフィールド ContentCreatorInsightsService.GenerateCreatorInsights と ContentCreatorInsightsService.GenerateTrendingInsights に追加しました。
レポート
biddable_indirect_install_first_in_app_conversion_micros 新しいフィールド Campaign、Customer、AdGroup リソースに追加されました。
動画
ShareablePreviewService 新機能 preview_type を YOUTUBE_LIVE_PREVIEW に設定することで、YouTube ライブ プレビューをサポートするように拡張されました。UNSUPPORTED_AD_TYPE と TOO_MANY_RESOURCES_IN_REQUEST を ShareablePreviewError に追加しました。この機能は一部の広告タイプでのみサポートされています。

v23.1（2026-02-25）

Google Ads API v23.1 では、以下の新機能とアップデートが追加されました。v23.1 などのマイナー バージョンには、互換性を損なう変更は含まれていません。

機能とアップデート タイプ 説明
アカウント管理
advertising_partner_properties.allowed_domain 新しいフィールド ProductLinkInvitation リソースと ProductLink リソースに追加されました。広告パートナーは、このドメインでのみ広告を掲載できます。
Customer.contains_eu_political_advertising 新しいフィールド EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatus を返します。
キャンペーン
Campaign.text_guidelines 新しいフィールド テキストのガイドラインのサポートを追加しました。P-MAX キャンペーンと検索キャンペーンで使用して、AI によって生成されたテキスト アセットをプログラムで制御できます。text_guidelines 内で、term_exclusions と messaging_restrictions を定義できます。
CampaignPrimaryStatusReason 新しい列挙値 FIXED_CPM 入札戦略を使用するキャンペーンの主なステータスの理由を提供するために、CAMPAIGN_NOT_BOOKED、BOOKING_HOLD_EXPIRING、BOOKING_HOLD_EXPIRED、BOOKING_CANCELLED を追加しました。
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 新しいフィールド 純広告カテゴリの自己開示と読み取り専用の予約詳細のサポートを追加しました。
Campaign.missing_eu_political_advertising_declaration 新しいフィールド EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。
コンバージョン数
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS 新しい列挙値 広告を視聴した後に同じチャンネルの動画を視聴したユーザーのトラッキングをサポートします。
全般
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED 新しい列挙値 / エラー ユーザー属性ディメンションで不明なカテゴリのみをターゲットにしようとした場合に返されます。
インセンティブ
IncentiveErrorEnum 新しい列挙値 / エラー 2 つの新しいエラーコード（MAX_INCENTIVES_REDEEMED と ACCOUNT_TOO_OLD）を追加しました。これらのエラーは、2026 年 3 月 11 日以降に行われたリクエストに対して返される可能性があります。
計画
GenerateBenchmarksMetrics 新機能 BreakdownDefinition を使用した日付の内訳のサポートを追加しました。
ReachPlanService.GenerateReachForecast 新しい列挙値 デマンド ジェネレーションの「コンバージョン数の最大化」で、GOOGLE_DISPLAY_NETWORK をターゲットに設定できるサーフェスとして追加しました。
GenerateTrendingInsights 新しいフィールド トピックで検索したときに、TrendInsightDataPoint の過去のトレンドライン情報を TrendInsights に追加しました。
レポート
ユニーク ユーザーのフリークエンシー指標 新しいフィールド 広告を 2 回以上、3 回以上、4 回以上、5 回以上、10 回以上見たユーザーの数をレポートする新しい指標（unique_users_two_plus、unique_users_three_plus、unique_users_four_plus、unique_users_five_plus、unique_users_ten_plus）を追加しました。
SearchTermMatchSource 新しい列挙値 VERTICAL_ADS_DATA_FEED を追加して、旅行広告のエンティティ ターゲティングなどの業種別広告データフィードをサポートしました。
YouTubeVideoUpload
YouTubeVideoUpload 新しいサービス / リソース YouTube での動画のアップロードと管理をサポートする YouTubeVideoUpload サービスと、アップロード ステータスとメタデータの取得をサポートする YouTubeVideoUpload リソースを追加しました。この機能は、REST と Python クライアント ライブラリでのみサポートされています。

v23（2026 年 1 月 28 日）

Google Ads API v23（メジャー リリース）では、次の新機能、アップデート、互換性を損なう変更が追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
広告
広告の共有が許可されている AdGroupAdError.AD_SHARING_NOT_ALLOWED 行動の変化 複数の広告グループ間での広告の共有は許可されなくなりました。広告を共有しようとするリクエストは、AD_SHARING_NOT_ALLOWED エラーを返します。
CallAd と CallAdInfo のサポート なし 削除 電話専用広告のサポートが終了しました。電話専用広告についてのヘルプセンター記事を参照してください。
キャンペーン
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 名前の変更 / 交換 新しい日時フィールドを使用して、キャンペーンの時間コンポーネントを指定します。元の日付専用フィールドは削除されます。
デマンド ジェネレーション
DemandGenMultiAssetAdInfo.lead_form_only なし 削除 lead_form_only フィールドが削除されました。コード内の参照を更新します。
レポート
アセットのパフォーマンス ラベルの指標と列挙型を集計する なし 削除 アセットのパフォーマンス ラベルの集計指標を削除しました。検索とディスプレイでパフォーマンス ラベルの列挙型が返されなくなりました。

機能とアップデート（非破壊的）

機能とアップデート タイプ 説明
広告
AdFormatType 新しい列挙値 新しい形式タイプ TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION を追加しました。
アセット
asset_group 回視聴 新しいフィールド 指標として metrics.engagements、metrics.engagement_rate、metrics.average_cpe を追加しました。
asset_group_asset 回視聴 新しいフィールド 指標として metrics.average_cpe、metrics.average_cpm、metrics.trueview_average_cpv、metrics.video_trueview_view_rate、metrics.video_trueview_views、metrics.interaction_event_types を追加しました。
Asset.orientation 新しいフィールド 画像アセットと動画アセットに読み取り専用の向きフィールドが追加されました。
CampaignAsset 新機能 field_type が HEADLINE と DESCRIPTION に設定されているキャンペーン アセットを取得するサポートを追加しました。
ServedAssetFieldType 新しい列挙値 サイトリンクとして配信されるアセットに HEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO を追加しました。
BusinessMessageAsset 新機能 / サポート 更新されたビジネス メッセージ アセット:
課金
InvoiceService.ListInvoices 新しいオプション ListInvoicesRequest で include_granular_level_invoice_details を設定すると、Invoice でより詳細な情報を取得できるようになりました。たとえば、キャンペーン単位の費用の内訳、規制費用の明細、調整情報などです。
RegulatoryFeeType
UnitOfMeasure		 新しい列挙型 規制手数料と測定単位のヘルパー列挙型を追加しました。
キャンペーン
CampaignError 新しい列挙値 / エラー DURATION_TOO_LONG_FOR_TOTAL_BUDGET エラーコードと END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET エラーコードを追加しました。
コンバージョン数
ConversionActionCategory 新しい列挙値 広告を視聴した後に同じチャンネルの動画を視聴したユーザーをトラッキングするための YOUTUBE_FOLLOW_ON_VIEWS を追加しました。
デマンド ジェネレーション
DemandGenVideoResponsiveAdInfo.companion_banner 新しいフィールド デマンド ジェネレーションのレスポンシブ動画広告でコンパニオン バナーがサポートされるようになりました。
インセンティブ
Choose Your Own（CYO）インセンティブのサポートを追加しました。

障害のより詳細なプログラマティック処理を容易にするため、今後のリリースで IncentivesService にエラーコードを追加します。アプリケーションでこれらの新しい障害モードを管理できるように、今後のアナウンスとリリースノートでこれらの新しいエラーコードをモニタリングすることをおすすめします。
計画
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST 新しい列挙値 GenerateAudienceCompositionInsights、GenerateSuggestedTargetingInsights、GenerateInsightsFinderReport、GenerateCreatorInsights のライフイベントを使用してオーディエンスを作成できます。

ライフサイクル イベントは、AudienceInsightsService.GenerateAudienceOverlap や AudienceInsightsService.GenerateTargetingSuggestionMetrics などの他の AudienceInsightsService メソッドではサポートされていません。
ReachPlanService.GenerateConversionRates 新しいフィールド / オプション レスポンスに、サーフェス コントロール（Gmail、ショート動画など）に基づいてコンバージョン率の提案をサポートするサーフェスが含まれるようになりました。デマンド ジェネレーション キャンペーンでのみサポートされています。
LanguageDistribution 新しいフィールド / タイプ YouTube チャンネルのコンテンツの言語分布の詳細を提供するために、YouTubeChannelInsights に追加されました。
BenchmarksService 新しいサービス YouTube 広告のデータを業界のベンチマークと比較します。
AudienceInsightsService.GenerateAudienceDefinition 新しいメソッド 生成 AI を使用して、ターゲット ユーザーの自由形式の説明を一致するオーディエンス属性に変換します。
YouTubeChannelInsights.relevance_score 新しいフィールド 視聴回数で重み付けされたトピックに対するクリエイターの関連性を評価します。
TrendInsightMetrics.trend_change_percent 新しいフィールド 比較期間におけるトレンドの値の変化率を表します。
推奨事項
GenerateRecommendationsRequest 新しいフィールド is_new_customer を追加しました。CAMPAIGN_BUDGET の最適化案で true に設定すると、新規顧客向けに最適化されたモデルが使用されます（キャンペーンがないお客様にのみ推奨）。
レポート
AdGroupAdAssetView 新機能 / 指標のサポート RESPONSIVE_DISPLAY_AD のインプレッション数、パフォーマンス、コンバージョン数の指標をサポートしました。
ad_sub_network_type セグメント 新しいセグメント 広告ネットワーク内のパフォーマンスを詳細に分類します。最初は YouTube のデマンド ジェネレーション キャンペーン（インストリーム、インフィード、ショート動画）で利用できます。ad_network_type とともに選択する必要があります。
P-MAX のレポート 新機能 P-MAX キャンペーンで有効になっている広告ネットワークのタイプの内訳。
UserLocationView
GeographicView		 新しいセグメントのサポート コンバージョン日別に分類された指標（conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date、cross_device_conversions_by_conversion_date、cross_device_conversions_value_by_conversion_date）をサポート。
縦型広告セグメント 新しいセグメント セグメントとして vertical_ads_event_participant_display_names、vertical_ads_hotel_class、vertical_ads_listing、vertical_ads_listing_brand、vertical_ads_listing_city、vertical_ads_listing_country、vertical_ads_listing_region、vertical_ads_partner_account、vertical_ads_vertical を追加しました。
PerStoreView
MatchedLocationInterestView		 新しいレポート リソース 店舗の所在地に関する詳細情報を取得する PerStoreView と、関心対象地域別のパフォーマンス指標を取得する MatchedLocationInterestView（AI 最大化設定キャンペーンの場合）を追加しました。
ショッピング
ShoppingPerformanceView 新しい指標のサポート コンバージョン日別にセグメント化された指標（conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date）がサポートされるようになりました。
ShoppingPerformanceView 新しい指標のサポート search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share、search_rank_lost_absolute_top_impression_share のサポートを追加しました。
ShoppingProduct.product_image_uri 新しいフィールド ShoppingProductに追加しました。
縦向き広告
AdGroup.vertical_ads_format_setting 新しいフィールド 旅行フィードを使用する検索キャンペーンで配信できる広告フォーマットを制御できます。
AdGroupCriterion
SharedCriterion		 新しいフィールド / 条件 AdGroupCriterion に vertical_ads_item_group_rule_list 条件タイプを追加し、SharedCriterion に vertical_ads_item_group_rule を追加して、旅行フィードを使用する検索キャンペーンでアイテム グループをターゲットに設定できるようにしました。
縦長広告のデータフィード統合 新機能 AI 最大化設定で実行されている検索キャンペーンに業種別広告のデータフィードを接続して、テキスト広告とともに物件プロモーション広告と予約リンクの旅行広告を表示できるようになりました。vertical_ads_format_setting で形式を制御し、vertical_ads_item_group_rule を使用してルールを定義します。AdFormatType と業種別広告データフィードのディメンションでレポートを分割します。
動画
AdVideoAssetInfo.ad_video_asset_feature_control 新しいフィールド 動画広告アセットの機能制御オプションを追加しました。
CampaignCriterionError 新しい列挙値 / エラー エラーコード INVALID_VIDEO_LINEUP_ID を追加しました。
YouTube の音声指標 新しい指標 YouTube のオーディオ広告の聴取可能性に関する指標を追加しました。広告が聴取可能だったかどうかと、聴取可能性を測定できたインプレッション数をレポートします。

v22 のメジャー バージョンとマイナー バージョン

Google Ads API v22 には、以下の新機能、更新、互換性を損なう変更が含まれています。

v22.2（2026 年 6 月 24 日）

Google Ads API v22.2 では、以下の新機能とアップデートが追加されました。v22.2 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
全般
Asset.synthetic_content_info
Ad.synthetic_content_info		 新しいフィールド 合成コンテンツ/AI 生成コンテンツの証明を含みます。advertiser_attestation（広告主が直接提供した宣言）と system_attestation（Google のシステムが自動的に検出または提供した証明）に分かれています。

v25 での今後の統合作業の計画に役立つよう、広告主様の証明書フィールドを変更するためのインターフェースが v22 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、synthetic_content_info.advertiser_attestation.status と synthetic_content_info.advertiser_attestation.source はこれらのバージョンでは変更できません。

これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。

「The field attempted to be mutated is immutable」または「Field cannot be set」。

これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。
複数の関係者による承認 新機能 マルチパーティ承認（MPA）の審査のサポートを追加しました。

v22.1（2026 年 2 月 25 日）

Google Ads API v22.1 では、次の新機能が追加されました。v22.1 などのマイナー バージョンには、互換性を破る変更は含まれていません。

機能とアップデート タイプ 説明
アカウント管理
Customer.contains_eu_political_advertising 新しいフィールド EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatus を返します。
キャンペーン
Campaign.missing_eu_political_advertising_declaration 新しいフィールド EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。

v22（2025-10-15）

Google Ads API v22（メジャー リリース）では、次の新機能、アップデート、互換性を破る変更が追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
デマンド ジェネレーション
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros 名前の変更 / スペルの修正 修正されたフィールド名を使用するように参照の名前を変更します。
全般
AddBatchJobOperations のオペレーションの上限なし リクエストあたりのオペレーション数の上限: 10,000 行動の変化 1 つの AddBatchJobOperations リクエストに 10,000 を超えるオペレーションが含まれないようにします。
ListBatchJobResultsRequest でページサイズを 1,000 に自動的に制限 INVALID_PAGE_SIZE エラーを返します 行動の変化 ListBatchJobResultsRequest.page_size が 1,000 以下に設定されていることを確認してください。これより大きいページサイズをリクエストすると、エラーが発生します。
P-MAX
アセットのパフォーマンス ラベル なし 削除 P-MAX キャンペーンでは、アセットのパフォーマンス ラベルのサポートと関連するパフォーマンス ラベルの列挙型が削除されました。統合を適宜更新します。
Campaign.url_expansion_opt_out AssetAutomationSetting の FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION フラグ 取り外し / 交換 最終ページ URL の拡張のテキスト アセットの自動化設定を使用します。キャンペーン単位の URL 拡張のオプトアウト フィールドが削除されます。
計画
views trueview_views 取り外し / 交換 views への参照を ReachPlanService の新しい trueview_views フィールドに置き換えます。
動画
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 名前の変更 TrueView 動画視聴回数を表す新しい指標名を使用するように、クエリ文字列と統合を更新します。

機能とアップデート（非破壊的）

機能とアップデート タイプ 説明
アセット
AssetFieldType.LANDING_PAGE_PREVIEW 新しい列挙値 新しい画像アセット フィールド タイプとして追加されました。
AssetGenerationService 新しいサービス（ベータ版） 生成 AI を使用してテキスト アセットと画像アセットを生成できます。
  • GenerateText: 最終ページ URL、プロンプト、キーワードなどに基づいてテキストを生成します。
  • GenerateImages: 最終ページ URL、プロンプト、またはプロダクト イメージの再コンテキスト化に基づいて画像を生成します。
  • エラーは AssetGenerationError のコードとともに返されます。
最初は、クローズド ベータ版の参加者の一部にのみ提供されます。
キャンペーン
AppCampaignBiddingStrategyGoalType 新しい列挙値 アプリ インストール キャンペーン（ACi）の新しい目標を追加しました。目標を指定せずに最適化できます。
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: 標準の「コンバージョン数の最大化」で使用します。
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: 標準のコンバージョン値の最大化で使用します。
BiddingStrategyType 新機能 固定広告シェア入札戦略タイプのサポートを追加しました。
Campaign.feed_types 新しいフィールド キャンペーンに添付されているフィードのタイプが表示されます。P-MAX キャンペーンの場合、これは小売業の MERCHANT_CENTER_FEED などの業種を示すことができます。
共有設定のターゲティング 新機能 マルチチャネル（アプリ キャンペーン用）キャンペーンとローカル キャンペーンに除外キーワードの共有セットを関連付けられるようになりました。
デマンド ジェネレーション
目標クリック単価入札戦略 新機能 目標クリック単価でクリック数を最大化する入札戦略を追加しました。Campaign.target_cpc を使用してキャンペーン単位の目標クリック単価を設定し、AdGroup.target_cpc_micros を使用して広告グループ単位でオーバーライドします。
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES 新しい列挙値 DemandGenMultiAssetAdInfo で有効にすると、デザイン要素が追加され、テキスト アセットが画像アセットに埋め込まれて、アスペクト比の異なる新しい画像アセットが作成されます（デフォルトで有効）。
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS 新しい列挙値 DemandGenMultiAssetAdInfo で有効にすると、画像やテキストなどの他のアセットを使用して動画が生成されます。この動画は、新しい DemandGenVideoResponsiveAdInfo インスタンスの作成に使用できます（デフォルトで有効）。
全般
ListBatchJobResultsRequest ページサイズのフォールバック 動作の変更 page_size が設定されていないか 0 の場合、デフォルトで最大 1,000 になります（以前は INVALID_PAGE_SIZE を返していました）。
QuotaError 新しい列挙値 / エラー お支払いプロファイルの有効化率の上限を超えたことを示す PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED を追加しました。
P-MAX
アセットの自動生成の設定 新しい列挙値 P-MAX のアセットの自動化に関する新しいオプションを追加しました。
  • GENERATE_IMAGE_ENHANCEMENT: 拡張画像の自動作成（自動切り抜き）を有効にします。デフォルトで有効。
  • GENERATE_IMAGE_EXTRACTION: 最終ページ URL から取得した画像。デフォルトでは、アカウントの動的画像表示オプションの設定が使用されます。
P-MAX のレポート セグメント 新しいセグメント P-MAX キャンペーンに固有の新しいセグメントを追加しました。
  • ad_using_product_data: 広告で Google Merchant Center の商品データが使用されているかどうかを示します。
  • ad_using_video: 広告で動画アセットが使用されているかどうかを示します。
計画
CRM パートナー データリスト 新機能 / 列挙値 CRM データソースに THIRD_PARTY_PARTNER_DATA を追加しました。また、パートナー オーディエンスの検証エラーコード（利用規約への同意、リンクがないなど）も追加しました。
ライブ配信のクリエイター指標 新しいフィールド YouTubeMetrics.is_active_live_stream_creator を追加しました。これは、クリエイターが過去 90 日間にライブ配信を公開したかどうかを示すためにクリエイター分析によって返されます。
プランニング可能な CRM ソースのメタデータ 新着メッセージ ReachPlanService.ListPlannableUserLists によって返される PlannableUserList 内に PlannableUserListMetadata を追加し、CRM データソースのタイプを表示するようにしました。
TrendInsight で関連動画とクリエイターをサポート 新しいフィールド TrendInsight で related_videos と related_creators のサポートを追加し、video_properties と publish_date でプロパティを監視します。
InsightsFinder の改善 新機能 GenerateInsightsFinderReport が parental_status、income_ranges、より複雑な AND/OR ターゲティングの組み合わせをサポートするようになりました。
レポート
新しいクリックタイプ 新しい列挙値 CLICK_TO_MESSAGE_THIRD_PARTY_CLICK と CLICK_TO_MESSAGE_LANDING_PAGE_CLICK を追加しました。
AssetGroupAsset のセグメンテーション 新しいセグメントのサポート AssetGroupAsset は、device、conversion_action、conversion_action_name、conversion_action_category でセグメント化できるようになりました。
AdGroupAdAssetView のレスポンシブ検索広告 新機能 / 指標のサポート AdGroupAdAssetView が RESPONSIVE_SEARCH_AD のパフォーマンスとコンバージョンの指標を完全にサポートするようになりました（以前はインプレッション数のみが返されていました）。
探索クエリのクラスタ指標のセグメンテーション 新しいセグメントのサポート 指標 clicks_unique_query_clusters、conversions_unique_query_clusters、impressions_unique_query_clusters を日付フィールドでセグメント化できるようになりました。
TargetingExpansionView 新しいレポート リソース TargetingExpansionView を追加して、検索キャンペーン向け AI 最大化設定のキーワードレスの拡張など、手動ターゲティングの拡張に関するレポート指標を表示できるようになりました。
ショッピング
ショッピングのスコープの修正 バグの修正 ShoppingProduct リソースの指標のキャンペーンと広告グループのスコープ設定を修正しました。
統合された目標
「ユーザー維持」目標 新機能 既存顧客の再エンゲージメントを重視して最適化するための顧客維持目標のサポートを追加しました（例: TARGET_SPECIFIC または TARGET_ALL で target_option を使用）。
動画
動画の総再生時間に関する指標 新しいフィールド 総再生時間（video_watch_time_duration_millis）とインプレッションあたりの平均再生時間（average_video_watch_time_duration_millis）の指標を追加しました。

v21 のメジャー バージョンとマイナー バージョン

Google Ads API v21 には、次の新機能、更新、重大な変更が含まれています。

v21.2（2026 年 6 月 24 日）

Google Ads API v21.2 では、以下の新機能とアップデートが追加されました。v21.2 などのマイナー バージョンには、互換性を損なう変更は含まれていません。

機能とアップデート タイプ 説明
全般
複数の関係者による承認 新機能 マルチパーティ承認（MPA）の審査のサポートを追加しました。

v21.1（2026 年 2 月 25 日）

Google Ads API v21.1 では、以下の新機能とアップデートが追加されました。v21.1 などのマイナー バージョンには、互換性を損なう変更は含まれていません。

機能とアップデート タイプ 説明
アカウント管理
Customer.contains_eu_political_advertising 新しいフィールド EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatusEnum を返します。
キャンペーン
Campaign.missing_eu_political_advertising_declaration 新しいフィールド EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。

v21（2025-08-06）

Google Ads API v21（メジャー リリース）では、次の新機能、アップデート、重大な変更が追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
キャンペーン
CriterionError.INVALID_LISTING_GROUP_HIERARCHY を返します CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION を返します エラーコードの変更 部分的な失敗が有効になっているリクエストの場合は、元の階層エラーコードではなく、新しいエラーコードを処理します。
コンバージョン数
ConversionUploadService での debug_enabled モードへのアクセス なし 削除 debug_enabled フィールドが削除されます。このパラメータを設定またはクエリしないように、このパラメータを参照するコードを更新します。
EU の政治広告に関する変更
EU の政治広告に関するキャンペーンの自己申告（任意） 新しいキャンペーンの必須の contains_eu_political_advertising フィールド 検証ルール / 動作の変更 このフィールドが設定されていない場合、新しいキャンペーンを作成する API 呼び出しは FieldError.REQUIRED エラーで失敗します。2025 年 9 月 22 日以降、CONTAINS_EU_POLITICAL_ADVERTISING と申告されたキャンペーンは EU で配信されなくなります。
自己申告なしで変更可能な条件 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION で更新が失敗する 検証ルール / 動作の変更 既存のキャンペーンのキャンペーン単位または広告グループ単位の近接地域、地域、地域グループのターゲティング条件を作成または更新する前に、自己申告ステータスを設定します。
自己申告の要件がないテスト ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION で更新が失敗する 検証ルール / 動作の変更 テストのキャンペーンで自己申告が完了していることを確認します。
P-MAX
brand_guidelines_enabled のデフォルトは false です デフォルトは true です 行動の変化 新しい P-MAX キャンペーンでは、ブランド ガイドラインはデフォルトで有効になっています。無効にする場合は、フィールドを明示的に false に設定します。
計画
AudienceInsightsService.GenerateTargetingSuggestionMetrics の元の入力引数の型 InsightsAudience 型の入力 型の変更 実装を更新して、ユーザーの興味 / 関心の OR の AND の組み合わせをサポートする新しい入力タイプを渡します。これにより、カスタム オーディエンス定義のリーチ指標の可能性が許可されます。

機能とアップデート（非破壊的）

機能とアップデート タイプ 説明
検索キャンペーン向け AI 最大化設定
Campaign の ai_max_setting.enable_ai_max 新しいフィールド AI 最大化設定で検索語句とのマッチングを拡大できます（以前のテキスト アセットの自動作成とブランドリストは、無効にするまで維持されます）。フィールド Campaign.ai_max_setting.bundling_required は、これらの設定を尊重または変更するために AI 最大化設定を有効にする必要があるかどうかを示します。また、AdGroup.ai_max_ad_group_setting.disable_search_term_matching は、広告グループ単位でマッチングを無効にできます。検索キャンペーン向け AI 最大化設定でパフォーマンスを飛躍的に高めるをご覧ください。
CampaignError.AI_MAX_MUST_BE_ENABLED 新しい列挙値 / エラー AI 最大化設定を有効にせずに、検索キャンペーンで URL 拡張テキスト アセットの自動作成を有効にしようとした場合にスローされます。
広告グループ単位のターゲティング 新機能 検索キャンペーン向け AI 最大化設定で、広告グループ単位のブランド リスト、地域、ウェブページ（URL ルール）がサポートされるようになりました。
ai_max_search_term_ad_combination_view 新しいレポート リソース 検索語句、広告見出し、ランディング ページの組み合わせのパフォーマンスをレポートします。
search_term_match_type セグメント 新しい列挙値 検索語句のマッチタイプのオプションとして AI_MAX を追加しました。
アセット
PromotionAsset 新しいフィールド terms_and_conditions_text、terms_and_conditions_uri、oneof promotion_trigger オプション（promotion_barcode_info、promotion_qr_code_info）を追加しました。プロモーション アセットについてをご覧ください。
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 新しい列挙値 検索キャンペーンの最終ページ URL からの自動テキストとランディング ページの生成を制御するために AssetAutomationType に追加されました。
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset 新しいサービス / メソッド 自動作成された最終ページ URL の拡張アセットをキャンペーンから削除できます。
ServedAssetFieldType.DESCRIPTION_PREFIX 新しい列挙値 ad_group_ad_asset_combination_view で型が UNKNOWN として返されるレポートの問題を修正するために追加されました。
キャンペーン
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING 新しい列挙値 地域制限付きキャンペーンに地域ターゲティングがない場合に返されます（許可された地域外をターゲットに設定すると、LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN がスローされます）。
サードパーティ製アプリ解析との連携 新しいフィールド VideoCustomer.third_party_integration_partners と Campaign.third_party_integration_partners のサポートを追加しました。サードパーティ製アプリ解析を使ってアプリ コンバージョンをトラッキングするをご覧ください。
Campaign.advertising_partner_ids 新しいフィールドのサポート このフィールドは既存のキャンペーンに設定できるようになりました（設定後は変更できません）。
クライアント センター（MCC）アカウント単位の除外プレースメント 新機能 CustomerNegativeCriterion を使用して、個々の広告主アカウントでプレースメント リストを除外できます。
目標広告費用対効果戦略の許容範囲の設定 新しいフィールド MaximizeConversionValue と TargetRoas で TargetRoas.target_roas_tolerance_percent_millis（検索キャンペーンのポートフォリオ戦略用）のサポートを追加しました。
LocationInterestView 新しいレポート リソース 広告グループの地域関心条件のパフォーマンスを要約します。
コンバージョン数
conversion_attribution_event_type セグメント 新しい列挙値 コンバージョン アトリビューション タイプのオプションに ENGAGED_VIEW を追加しました。
デマンド ジェネレーション
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM 新しい列挙値 / エラー デマンド ジェネレーション キャンペーンの 1 日の最低予算額の適用に備えて追加されました。詳細は budgetDailyMinimumErrorDetails を使用して公開されます。
P-MAX
campaign_search_term_view 新しいレポート リソース 検索語句の指標をキャンペーン単位で集計し、P-MAX の検索語句の分析とレポート作成を可能にします。
計画
ReachPlanService.ListPlannableUserInterests 新しいメソッド generateReachForecast のプラン可能なアフィニティと購買意向の強いインタレストを検出できます。
AdditionalApplicationInfo 新しいフィールド ReachPlanService.ListPlannableUserLists のオプション入力として追加されました。
AudienceInsights 属性のリスト 新機能 AudienceInsightsService.ListAudienceInsightsAttributes で、利用可能な 1P ユーザーリストが取得されるようになりました。
AudienceCompositionInsights で CRM リストをターゲットに設定する 新機能 AudienceInsightsService.GenerateAudienceCompositionInsights で、AudienceInsightsDimension ディメンション（AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST）のユーザーリスト インデックスの詳細が返されるようになりました。
TrendInsightMetrics 視聴者の占有率 新しいフィールド トレンドのオーディエンスの割合を表します。
KnowledgeGraphAttributeMetadata カテゴリ 新しいフィールド 一致するカテゴリでナレッジグラフの属性をフィルタします。
レポート
アセットビューの指標 新機能 / 指標 AssetGroupAsset、ChannelAggregateAssetView、CampaignAggregateAssetView に複数の新しい指標を追加しました。また、P-MAX キャンペーンで impressions の実際の値がレポートされるようになりました。
セレクタ拡張機能 新機能 ChangeStatus 内で AssetSet と CampaignAssetSet を一緒にクエリできるようにしました。
search_term_targeting_status 新しいセグメント キャンペーンの検索語句ビューで選択可能なセグメント。
final_url_expansion_asset_view 新しいレポート リソース 最終ページ URL の拡張アセットのパフォーマンスの詳細をレポートします。
AssetGroup の値の調整 新しいフィールド AssetGroup レポートで value_adjustment 指標と all_value_adjustment 指標がサポートされるようになりました。
landing_page_source 新しいセグメント landing_page_view でランディング ページのソース セグメントを提供します。
search_term_match_source 新しいセグメント 検索語句ビューとキャンペーン検索語句ビューで選択可能なセグメント。
match_type 新しいセグメント キーワード ビューで選択可能なセグメントキー。
固有の検索語句の意図クラスタ レポート 新しいフィールド 一意のクエリ インテント クラスタをレポートするために、clicks_unique_query_clusters、conversions_unique_query_clusters、impressions_unique_query_clusters を追加しました。
ClickType.VEHICLE_ASSETS 新しい列挙値 click_view レポートで、車両広告フォーマットに固有のクリック数をトラッキングしてレポートします。
スマート自動入札の入札範囲拡大機能
検索戦略の許容範囲の設定 新しいフィールド / 設定 target_roas_tolerance_percent_millis を 10,000（10%）から 30,000（30%）の範囲で設定することで、検索キャンペーンでスマート自動入札の入札範囲拡大機能を有効にできます（コンバージョン数の最大化には target_roas の設定が必要です）。詳しくは、スマート自動入札の入札範囲拡大機能に関するブログ投稿と、ヘルプセンターの記事をご覧ください。
多様性レポートの互換性 新機能 ユニークなクエリ インテント クラスタの次の指標で、集計された多様性レポートがサポートされるようになりました。Google 広告の管理画面で、期間でセグメント化したビューを利用できます。
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
動画
YouTubeVideoListAsset 新しいリソース / フィールド Asset.youtube_video_list_asset を使用して、キャンペーンと動画リスト アセット間のリンクを確立できます。関連動画を使用するをご覧ください。
分析情報のメタデータ拡張機能 新しいフィールド YouTubeChannelInsights と YouTubeVideoAttributeMetadata に新しいメタデータを追加しました。
インタラクティブ クリックタイプ 新しい列挙値 クリックタイプ VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK、PRODUCT_ASSETS を追加しました。
VideoAdInventoryControl.allow_non_skippable_in_stream 新しいフィールド スキップ可能なフォーマットとスキップ不可のフォーマットを組み合わせたキャンペーンで、レスポンシブ動画広告をスキップ不可のインストリーム広告として配信できます。
動画シーケンスの設定 新しいフィールド 読み取り専用のシーケンス設定 Campaign.VideoCampaignSettings.video_ad_sequence と VideoAdSequenceStepSetting を追加しました。動画広告シーケンスについてをご覧ください。
動画ラインナップ ターゲティング 新しい条件タイプ / フィールド CampaignCriterion と AdGroupCriterion に VIDEO_LINEUP 条件タイプと対応するフィールドを追加しました。この機能は、許可リストに登録されたアカウントでのみご利用いただけます。
コンテンツの適合性のプレースメントのビュー数 新しいレポート リソース 詳細レベル（detail_content_suitability_placement_view）とグループ レベル（group_content_suitability_placement_view）の両方で、コンテンツの適合性レポートが追加されました。「コンテンツの適合性」レポートについてをご覧ください。

リリースノートのアーカイブ

アーカイブされたリリースノートについては、サポート終了バージョンをご覧ください。