リリースノート

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

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

Google Ads API v25 には、以下の新機能、更新、破壊的変更が含まれています。

v25.2(2026 年 9 月 23 日)

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

機能とアップデート タイプ 説明
アセット
AssetGroup の URL オプション 新しいフィールド AssetGroup で URL オプションのサポートを追加しました。これにより、広告主様はアセット グループ単位でトラッキング テンプレート、カスタム パラメータ、最終ページ URL のサフィックスを指定できます。
  • AssetGroup.tracking_url_template: トラッキング URL を作成するための URL テンプレート。
  • AssetGroup.url_custom_parameters: tracking_url_templatefinal_urlsfinal_mobile_urls で URL カスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。
  • AssetGroup.final_url_suffix: 並行トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。
キャンペーン
動画の自動クロールに関する情報 新しいフィールドと列挙型 Campaign.AssetAutomationSettingAutomatedVideoCrawlSettingAssetAutomationType.AUTOMATED_VIDEO_CRAWL を追加しました。これにより、P-MAX キャンペーンの自動動画クロール設定を指定できるようになりました。AutomatedVideoCrawlSetting.automated_video_crawl_infos には AutomatedVideoCrawlInfo エントリのリストが含まれます。各エントリは、クロール urlsource_platformVideoCrawlSourcePlatform: LANDING_PAGESOCIAL、または YOUTUBE)、enabled オプトイン ステータスを構成します。
顧客ライフサイクルの最適化の価値の調整比のエラー 新しい列挙値とエラー 顧客ライフサイクル最適化のコンバージョン値の調整比(value_multiplierhigh_lifetime_value_multiplier)を設定する際に、新しい検証エラーの理由を追加しました。
SmartCampaignSettingService.GeneratePMaxDraftCampaign 新機能 既存のスマート アシスト キャンペーンから P-MAX 下書き用キャンペーンを生成するサポートとして SmartCampaignSettingService.GeneratePMaxDraftCampaign を追加しました。ステータスは CampaignStatus.PAUSED、作成ステータスは CampaignCreationStatus.INCOMPLETE に初期化されます(スマート アシスト キャンペーンを P-MAX キャンペーンに変換するを参照)。
コンバージョン数
Firebase 広告のインプレッション数 新しいコンバージョン アクションのタイプとカテゴリ FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_IOS_APP_AD_IMPRESSION のコンバージョン アクション タイプが公開され、これらのコンバージョン アクションを取得して変更できるようになりました。また、アプリ内広告の収益化による収益をトラッキングするために、ConversionActionCategoryIN_APP_AD_REVENUE カテゴリも公開しました。
全般
BusinessProfileLocationSyncError 新しい列挙型とエラー LOCATION_SYNC 型の AssetSet で店舗情報を同期する際に、ビジネス プロフィールの店舗情報の同期エラーの理由を追加しました。API は、一般的な UNKNOWN エラーを返す代わりに、特定の理由(EMAIL_INVALIDOAUTH_TOKEN_INVALIDACCOUNT_REMOVEDNO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT)とともに BusinessProfileLocationSyncError を返すようになりました。
計画
BenchmarksService.GenerateBenchmarksMetrics パーセンタイル指標 新機能

BenchmarksService.GenerateBenchmarksMetrics を更新し、他の広告主との比較における広告主の競争力をパーセンタイル階層形式で表す指標を提供しました。指標は、新しい CustomerMetrics.percentile_metrics フィールド(GenerateBenchmarksMetricsResponse.customer_metricsBreakdownMetrics.customer_metrics の両方)の PercentileMetrics で返され、BenchmarksCustomerPercentileTier を使用して表されます。

CustomerMetrics.percentile_metrics は、GenerateBenchmarksMetricsRequest で次の両方の条件が満たされている場合にのみ入力されます。

ListBenchmarksAvailableDatesResponse.supported_dates 内の未確定四半期の日付のパーセンタイル指標のサポートを追加しました(BenchmarksService.ListBenchmarksAvailableDates によって返されます)。お客様の集計指標(CustomerMetrics.aggregate_metrics)、お客様の割合指標(CustomerMetrics.average_rate_metrics)、お客様のパーセンタイル指標(CustomerMetrics.percentile_metrics)は supported_dates のすべての日付(未確定四半期を含む)でサポートされていますが、お客様のシェア指標(CustomerMetrics.share_metrics)とベンチマーク ソースの割合指標(average_benchmarks_metrics、たとえば「/Apparel/Clothing」広告の average_cpm)は未確定四半期では対象外であり、リクエストされた date_range がより狭い ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics の範囲内にある場合を除き、レスポンスから除外されます。

選択した入力の組み合わせに対応する指標が見つからなかったことを示すカスタム BenchmarksError.NO_METRICS_FOUND エラーを追加し、ユーザビリティを改善しました。

クリエイター インサイトの YouTube チャンネル ハンドル 新機能 ContentCreatorInsightsService.GenerateCreatorInsights を更新し、YouTubeChannels.youtube_channel_handles を使用して YouTube チャンネル ハンドルで検索できるようにしました(有効なチャンネル ハンドルは @ で始まる必要があります(例: @channel_handle))。このオプションは、YouTube チャンネル ID での検索に似ています。レスポンスには、リクエストされた YouTube クリエイターに関する分析情報が含まれます。
推奨事項
アクション単価と広告費用対効果の入札単価に関する最適化案 新しい推奨事項 検索キャンペーンの入札単価が低すぎてオークションに参加できない場合に、目標アクション単価を引き上げたり、目標広告費用対効果を引き下げたりできるように、Recommendation.raise_target_cpa_performance_bid_too_low_recommendationRAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW)と Recommendation.lower_target_roas_performance_bid_too_low_recommendationLOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)に加えて、ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_lowApplyRecommendationOperation.lower_target_roas_performance_bid_too_low を追加しました。
レポート
ホテル宿泊プランのディメンション セグメント 新しいセグメント 次のホテルと旅行の予約旅程ディメンション セグメントを Segments に追加しました(campaignad_groupcustomer で選択可能)。
縦長広告の指標 新しい指標 ホテルと旅行業種の広告レポートの次の指標を Metrics に追加しました(campaignad_groupcustomer で選択可能)。
縦長広告セグメント 新しいセグメント ホテルと旅行業種の広告のレポート用に、次のセグメントを Segments に追加しました(campaignad_groupcustomer で選択可能)。

v25.1(2026 年 8 月 19 日)

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

機能とアップデート タイプ 説明
アセット
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER
新しい列挙値 テキストの免責条項アセットのサポートを追加しました。
キャンペーン
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time
新しいフィールド AI 最大化設定への自動移行の予定を確認する。
コンバージョン数
ブランド効果測定 新機能 以下の更新により、ブランド効果測定のサポートを追加しました。
コンバージョン リフト測定 新機能 以下の更新により、コンバージョン リフト測定のサポートを追加しました。
  • リフトスタディーを表す新しい読み取り専用リソース LiftMeasurementConfig を追加しました。
  • リフトの結果をセグメント化してフィルタするための新しい選択可能なセグメントを追加しました。
  • コンバージョン リフト測定のパフォーマンスの詳細な統計分析をサポートする、24 個の新しいコンバージョン リフト測定指標と勝者スコア指標を追加しました。
  • キャンペーンの詳細とコンバージョン目標を取得するサポートを追加しました。
  • 新しいオプション フィールド Experiment.lift_measurement_config を追加しました。
  • ConversionLiftIncludedConversionActionTypes 列挙型を追加しました。
LiftMeasurementFlight 新しいリソース リフト測定の設定のフライトの詳細を表す新しい読み取り専用リソース。測定されたフライトの開始日と終了日(start_dateend_date)が含まれます。
全般
SmartCampaignError 新しい列挙値 P-MAX の生成制約に関する新しい特定のエラーコードを追加しました。
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 新しい列挙値 / エラー TEST アクセスレベルの Google Cloud プロジェクトがテスト用以外のアカウントに対してリクエストを試みた場合に返されます。
計画
ブランド センチメントに関する分析情報 新機能 ContentCreatorInsightsService でブランドの感情分析情報のサポートを追加しました。
BenchmarksService の拡張 新機能 ベンチマーク分析の範囲設定のフィルタとしてカテゴリのサポートを追加しました。ビジネス クリティカルな指標も追加でサポートされています。
  • BenchmarksService.GenerateBenchmarksMetricscategory_filter を使用して、1 つ以上の商品とサービスのカテゴリで広告を掲載しているすべての広告主様をベンチマーク対象とするオプションを追加しました。
  • お客様の合計費用や視聴回数などの広告指標や、share_of_voice などのシェア指標がより多く表示されるようになりました。指標は AggregateMetricsShareMetrics を使用して返されます。
  • サポートされているカテゴリのリストは、CATEGORY ソースタイプで BenchmarksService.ListBenchmarksSources を使用して取得できます。
子供の有無によるターゲティング 新機能 リーチ プランニングで保護者のステータス ターゲティングのサポートを追加しました。サービス ReachPlanService.GenerateReachForecastTargeting に新しいフィールド parental_statuses を追加し、サービス ReachPlanService.ListPlannableProductsPlannableTargetingparental_statuses を追加しました。
推奨事項
Recommendation.campaign_specific_app_goal_recommendation 新しい最適化案 キャンペーン固有のアプリ コンバージョン目標を追加することを提案します。新しい EffectiveAutomaticGoal リソースは、この推奨事項内の現在の目標を表すために使用されます。
レポート
Metrics.original_conversion_value 新しいフィールド 入札可能なコンバージョンから得られた元のコンバージョン値を表します。これは、値のルールによる調整(コンバージョン値のルールやライフサイクル目標による調整など)が適用される前の、未調整のコンバージョン値です。
ポイント プログラムのメンバーシップの統計情報 新機能 ユーザーのポイント プログラムのメンバーシップ ステータス別に統計情報をセグメント化するサポートを追加しました。また、コンバージョン値ルールのポイント メンバーシップのプライマリ ディメンションを追加しました。
  • コンバージョン ユーザーのポイント プログラムの階層別にレポート指標をセグメント化できるように、Segments.loyalty_membership セグメントを追加しました。
  • コンバージョン値ルールのポイント プログラムのメンバーシップ条件が満たされたタイミングを特定するためのメイン ディメンション LOYALTY_MEMBERSHIP を追加しました。
ターゲティング
vertical_ads_item_bid 新しい条件タイプ 新しい vertical_ads_item_bid 条件タイプを AdGroupCriterion.criterion に追加しました。

v25(2026-07-22)

Google Ads API v25(メジャー リリース)では、次の新機能、更新、重大な変更が追加されました。

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

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
キャンペーン
CustomerLifecycleOptimizationValueSettings のスタンドアロン フィールド additional_valueadditional_high_lifetime_value それぞれ value_adjustmenthigh_lifetime_value_adjustment の oneof の一部。新しい value_multiplier フィールドと high_lifetime_value_multiplier フィールドも含まれます 構造変化 これらのフィールドは oneof の一部になったため、これらのフィールドへの参照を更新します。
以前の CustomerLifecycleGoal リソースと CampaignLifecycleGoal リソース、対応するサービス CustomerLifecycleGoalServiceCampaignLifecycleGoalService、以前の設定/列挙型(CustomerAcquisitionGoalSettingsCustomerAcquisitionOptimizationModeEnumLifecycleGoalValueSettings なし 削除 刷新された統一目標スキーマを使用します。
全般
インセンティブ サービスのリクエスト メッセージとレスポンス メッセージのネストされた列挙型フィールド:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
スタンドアロンの列挙型フィールド: 名前の変更 / 削除 以前の type フィールドではなく、新しいスタンドアロン列挙型フィールドを使用します。
ApplyIncentiveRequest の省略可能な selected_incentive_id フィールドと customer_id フィールド 必須項目 挙動のシフト ApplyIncentive を呼び出すときは、両方のフィールドを指定してください。
LocalServicesLead リソースの購入者のメールアドレス フィールド ContactDetails.email なし 削除 このフィールドはサポートされなくなったため、このフィールドへの参照を削除します。
AdvertisingPartnerLinkInvitationProperties の省略可能な allowed_domain フィールド 広告パートナーの CreateProductLinkInvitation を呼び出す場合の必須フィールド 挙動のシフト 広告パートナー向けのプロダクト リンクの招待状を作成する際は、必ず allowed_domain を指定してください。
計画
GenerateCreatorInsightsRequestsearch_brand フィールド なし 削除 代わりに search_topics を使用してください。
Targetingplannable_location_id フィールドと GenerateReachForecastRequestcookie_frequency_cap フィールド なし 削除 plannable_location_idscookie_frequency_cap_setting を使用するように切り替えます。
レポート
GenerateBenchmarksMetricsResponseBreakdownMetricscustomer_metrics フィールド(型: Metrics CustomerMetrics 型のフィールド 型変更 / 挙動のシフト 統合を更新して、顧客の広告のパフォーマンスを表す指標のみを含む新しい CustomerMetrics 型を使用します。

機能とアップデート(非破壊的)

機能とアップデート タイプ 説明
広告
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS 新しい列挙値 / 動作 DemandGenMultiAssetAds で使用できます。有効にすると、アニメーション化されていない画像を入力として使用して、アニメーション画像を生成します。この API バージョン以降、新しい DemandGenMultiAssetAds はデフォルトで有効になります。
合成コンテンツ情報の変更可能性 行動の変更 Asset.synthetic_content_infoAd.synthetic_content_info は、v25、v24、v23 で完全に変更可能になりました。
キャンペーン
「ユーザー維持」目標 新機能 / 設定 ポイント プログラム メンバーの維持を重視してキャンペーンを最適化できる「ポイント プログラム メンバーの維持」目標のサポートを追加しました。
「新規顧客の獲得」目標 新機能 / 設定 Google Ads API での「新規顧客の獲得」目標のサポートを更新し、統合型の目標のスキーマの変更を反映しました。
コンバージョン数
YouTube のサードパーティのコンバージョン アトリビューション 新しいフィールド サードパーティ パートナーを使用した YouTube コンバージョン アトリビューション検証のサポートを追加しました。 詳しくは、ヘルプセンターの記事をご覧ください。
全般
ContactDetails.phone_number_extension 新しいフィールド LocalServicesLead リソースに追加されました。
IncentiveError 新しい列挙値とエラー インセンティブの利用失敗に関する新しい特定のエラーコードを追加しました。
計画
急上昇中の分析情報の YouTube チャンネルの詳細 新しいフィールド 急上昇ワードの分析情報を検索する際に、関連動画の YouTube チャンネルの詳細情報をさらにサポートしました。YouTubeVideoAttributeMetadata に新しいフィールド channel_idchannel_namechannel_url を追加しました。
YouTubeChannelInsights.data_sharing_consent_given 新しいフィールド YouTubeChannelInsights に追加しました。これは、クリエイターが非公開データの共有に同意している場合に当てはまります。その場合、次のフィールドに値が入力されます。
レポート
ad_sub_format_type 新しいセグメント YouTube のインストリーム スキップ不可広告を長さ別に分類したデータを提供します。 このセグメントは、常に ad_format_type とともに選択する必要があります。AdGroupAdGroupAdCampaignCustomerVideoVideoEnhancement で選択できます。
動画固有のソーシャル指標 新しいフィールド / 指標 広告主様が YouTube のショート動画広告に対するユーザー エンゲージメント(コメント、高評価、共有)をトラッキングできるように、動画固有のソーシャル指標を追加しました。 これらは、AdGroupAdGroupAdAssetCampaignCustomerVideo で使用できます。

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_attestation(広告主が直接提供した宣言)と system_attestation(システムが自動的に検出または提供した証明)に分かれています。

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

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

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

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

これらのフィールドは、v25 以降で完全に変更可能になります。このインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。そうすることで、v25 のリリース時にシステムで完全な書き込み機能を利用できるようになります。

複数の関係者による承認 新機能 複数の関係者による承認(MPA)の審査のサポートが追加されました。
この機能は、v23.3v22.2v21.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_dataLOCAL_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: Optimize アセット テストの実験群のアセット グループのリスト。
  • 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_ratingvenueevent_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 の省略可の videoslogo_images 必須項目 挙動のシフト レスポンシブ デマンド ジェネレーション動画広告を作成または変更する際に、videoslogo_images を指定します。
VideoResponsiveAdInfo のオプションの videosbusiness_namelogo_images 必須項目 挙動のシフト 動画レスポンシブ広告を作成または変更するときに、videosbusiness_namelogo_images を指定します。VideoResponsiveAdInfo は変更可能になりました。
キャンペーン
Campaign.video_brand_safety_suitability なし 削除 キャンペーン単位の適合性コントロールが削除されます。ブランド保護の適合性は、引き続きお客様レベルでご利用いただけます。代わりに Customer.video_brand_safety_suitability を使用してください。
コンバージョン数
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS なし 削除 [ポイントカードの登録] ユーザー カテゴリが削除されました。それへのコード参照を削除します。
計画
topic_audience_combinationsInsightsAudienceAttributeGroup common.InsightsAudienceAttributeGroup タイプ 挙動のシフト / タイプの変更 型付きクライアント ライブラリの統合は、新しいリソース Namespace を使用するように更新する必要があります。
ReachPlanService.ListPlannableProductsyoutube_select_lineups フィールド なし 削除 youtube_select_lineup_targeting からラインナップの使用に切り替えます。
ContentCreatorInsightsService.GenerateCreatorInsightsGenerateTrendingInsightsis_brand_connect_creator フィールド なし 削除 代わりに、クリエイターが partnership_opportunitiesCREATOR_PARTNERSHIPS を利用できるかどうかを確認します。
KeywordPlanIdeaService.GenerateKeywordForecastMetricsgeo_modifiersbiddable_keywords geo_target_constantskeywords 名前の変更 / 削除 CampaignToForecast.geo_target_constants[]ForecastAdGroup.keywords[] に置き換えられました。
GenerateKeywordForecastMetrics でのキーワード プラン / 予測フィールドの非推奨化 なし 削除 次のプラン / 予測のフィールドとタイプを削除しました。 必要に応じてインテグレーションを更新します。
レポート
campaign_budgetad_sub_network_type セグメント なし 削除 campaign_budget リソースの ad_sub_network_type セグメントを削除しました。
アセットビューの click_type セグメント なし 削除 AdGroupAssetCampaignAssetCustomerAsset ビューからセグメントを削除しました。
動画
ShareablePreviewService.GenerateShareablePreviews で部分的な失敗が許可されている 部分的な障害なし 挙動のシフト リクエスト内の ID のいずれかが検証に失敗すると、リクエストは失敗し、エラーがスローされます。
ShareablePreviewError レガシーコード: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST
名前の変更 / 挙動のシフト アセット グループに対して返されるエラーコードが、広告グループの広告エラーと一致するように変更されました。検証キャッチ ロジックを更新。

機能とアップデート(非破壊的)

機能とアップデート タイプ 説明
広告
VideoResponsiveAdInfo の可変性 動作の変更 レスポンシブ動画広告の情報オブジェクトが変更可能になりました。
アセット
AssetSettravel_feed_data 新しいフィールド 旅行フィード アセットの属性(hotel_center_account_idmerchant_center_idpartner_center_idsubset_idtravel_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 新しい列挙値 / エラー 同じ類似ユーザー リストを複数作成しようとした場合に返されます。
計画
ListPlannableProductsResponseProductCoreAttributes フィールド 新しいフィールド ListPlannableProductsResponseProductCoreAttributes に、プラン可能な商品の説明、マーケティングの目標、費用モデル、購入方法を追加しました。
レポート
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.statussynthetic_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_typeBUSINESS_LOGO に設定されている CustomerAsset を取得するサポートを追加しました。
キャンペーン
AdGroupAd.start_date_time
AdGroupAd.end_date_time
新しいフィールド キャンペーンの期間について、より詳細なスケジュール設定の制約を指定します。これは、一部の広告グループ タイプでのみサポートされています。
HotelSettingInfo.disable_hotel_setting 新しいフィールド デマンド ジェネレーション キャンペーンでホテルフィードを無効にできます。
全般
CustomerClientLinkError 新しい列挙値 / エラー 2 つの新しいエラーコード(MAX_CUSTOMER_LIMIT_REACHEDACCOUNT_CREATION_POLICY_VIOLATION)を追加しました。
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS 動作の変更 この廃止されたユーザーリストの顧客タイプ カテゴリを使用しようとすると、エラーがスローされるようになりました。
計画
GenerateTrendingInsights
GenerateCreatorInsights
新機能 エンティティ、トピック、オーディエンスのカスタム AND/OR 組み合わせのサポートを追加しました。
ReachPlanService.GenerateReachForecast 新しい列挙値 AGE_RANGE_21_44AGE_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.GenerateCreatorInsightsContentCreatorInsightsService.GenerateTrendingInsights に追加しました。
レポート
biddable_indirect_install_first_in_app_conversion_micros 新しいフィールド CampaignCustomerAdGroup リソースに追加されました。
動画
ShareablePreviewService 新機能 preview_typeYOUTUBE_LIVE_PREVIEW に設定することで、YouTube ライブのプレビューをサポートするように拡張されました。UNSUPPORTED_AD_TYPETOO_MANY_RESOURCES_IN_REQUESTShareablePreviewError に追加しました。この機能は一部の広告タイプでのみサポートされています。

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_exclusionsmessaging_restrictions を定義できます。
CampaignPrimaryStatusReason 新しい列挙値 FIXED_CPM 入札戦略を使用するキャンペーンの主なステータスの理由を提供するために、CAMPAIGN_NOT_BOOKEDBOOKING_HOLD_EXPIRINGBOOKING_HOLD_EXPIREDBOOKING_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_REDEEMEDACCOUNT_TOO_OLD)を追加しました。これらのエラーは、2026 年 3 月 11 日以降に行われたリクエストに対して返される可能性があります。
計画
GenerateBenchmarksMetrics 新機能 BreakdownDefinition を使用した日付の内訳のサポートを追加しました。
ReachPlanService.GenerateReachForecast 新しい列挙値 デマンド ジェネレーションの「コンバージョン値の最大化」で、GOOGLE_DISPLAY_NETWORK をターゲット設定可能なサーフェスとして追加しました。
GenerateTrendingInsights 新しいフィールド トピックで検索したときに、TrendInsightDataPoint の過去のトレンドラインの情報を TrendInsights に追加しました。
レポート
ユニーク ユーザーのフリークエンシー指標 新しいフィールド 広告が 2 回以上、3 回以上、4 回以上、5 回以上、10 回以上表示されたユーザー数をレポートする新しい指標(unique_users_two_plusunique_users_three_plusunique_users_four_plusunique_users_five_plusunique_users_ten_plus)を追加しました。
SearchTermMatchSource 新しい列挙値 VERTICAL_ADS_DATA_FEED を追加して、旅行広告のエンティティ ターゲティングなどの業種別広告データフィードをサポートしました。
YouTubeVideoUpload
YouTubeVideoUpload 新しいサービス / リソース YouTube での動画のアップロードと管理をサポートする YouTubeVideoUpload サービスと、アップロード ステータスとメタデータの取得をサポートする YouTubeVideoUpload リソースを追加しました。この機能は、REST と Python クライアント ライブラリでのみサポートされています。

v23(2026-01-28)

Google Ads API v23(メジャー リリース)では、次の新機能、更新、互換性を破る変更が追加されました。

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

破壊的変更

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

機能とアップデート(非破壊的)

機能とアップデート タイプ 説明
広告
AdFormatType 新しい列挙値 新しい形式タイプ(TEXTVERTICAL_ADS_BOOKING_LINKVERTICAL_ADS_PROMOTION)を追加しました。
アセット
asset_group ビュー 新しいフィールド 指標として metrics.engagementsmetrics.engagement_ratemetrics.average_cpe を追加しました。
asset_group_asset ビュー 新しいフィールド metrics.average_cpemetrics.average_cpmmetrics.trueview_average_cpvmetrics.video_trueview_view_ratemetrics.video_trueview_viewsmetrics.interaction_event_types の各指標を追加しました。
Asset.orientation 新しいフィールド 画像アセットと動画アセットに読み取り専用の向きフィールドを追加しました。
CampaignAsset 新機能 field_typeHEADLINEDESCRIPTION に設定されているキャンペーン アセットを取得するためのサポートを追加しました。
ServedAssetFieldType 新しい列挙値 サイトリンクとして配信されるアセットに HEADLINE_AS_SITELINK_POSITION_ONEHEADLINE_AS_SITELINK_POSITION_TWODESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONEDESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO を追加しました。
BusinessMessageAsset 新機能 / サポート 更新されたビジネス メッセージ アセット:
課金
InvoiceService.ListInvoices 新しいオプション ListInvoicesRequestinclude_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 新しいフィールド デマンド ジェネレーション レスポンシブ動画広告でコンパニオン バナーがサポートされるようになりました。
インセンティブ
自分のデバイスを選ぶ(CYO)インセンティブのサポートを追加しました。

障害のより詳細なプログラム処理を容易にするため、今後のリリースで IncentivesService にエラーコードを追加します。アプリケーションがこれらの新しい障害モードを管理できるように、今後のアナウンスとリリースノートでこれらの新しいエラーコードをモニタリングすることをおすすめします。

計画
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST 新しい列挙値 GenerateAudienceCompositionInsightsGenerateSuggestedTargetingInsightsGenerateInsightsFinderReportGenerateCreatorInsights のライフイベントを使用してオーディエンスを作成できます。

ライフイベントは、AudienceInsightsService.GenerateAudienceOverlapAudienceInsightsService.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_dateall_conversions_by_conversion_dateconversions_value_by_conversion_dateall_conversions_value_by_conversion_datevalue_per_conversions_by_conversion_datevalue_per_all_conversions_by_conversion_datecross_device_conversions_by_conversion_datecross_device_conversions_value_by_conversion_date
縦長広告セグメント 新しいセグメント vertical_ads_event_participant_display_namesvertical_ads_hotel_classvertical_ads_listingvertical_ads_listing_brandvertical_ads_listing_cityvertical_ads_listing_countryvertical_ads_listing_regionvertical_ads_partner_accountvertical_ads_vertical のセグメントを追加しました。
PerStoreView
MatchedLocationInterestView
新しいレポート リソース 店舗の所在地に関する詳細情報を取得する PerStoreView と、関心対象地域別のパフォーマンス指標を取得する MatchedLocationInterestView(AI 最大化設定キャンペーンの場合)を追加しました。
ショッピング
ShoppingPerformanceView 新しい指標のサポート コンバージョン日別にセグメント化された指標(conversions_by_conversion_dateall_conversions_by_conversion_dateconversions_value_by_conversion_datevalue_per_conversions_by_conversion_datevalue_per_all_conversions_by_conversion_date)がサポートされるようになりました。
ShoppingPerformanceView 新しい指標のサポート search_budget_lost_impression_sharesearch_rank_lost_impression_sharesearch_budget_lost_absolute_top_impression_sharesearch_rank_lost_absolute_top_impression_share のサポートを追加しました。
ShoppingProduct.product_image_uri 新しいフィールド ShoppingProductに追加しました。
縦向き広告
AdGroup.vertical_ads_format_setting 新しいフィールド 旅行フィードを使用して検索キャンペーンで配信できる広告フォーマットを管理できます。
AdGroupCriterion
SharedCriterion
新しいフィールド / 条件 AdGroupCriterionvertical_ads_item_group_rule_list 条件タイプを追加し、SharedCriterionvertical_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.statussynthetic_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 AssetAutomationSettingFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION フラグ 取り外し / 交換 最終ページ URL の拡張のテキスト アセットの自動化設定を使用します。キャンペーン単位の URL 拡張のオプトアウト フィールドが削除されます。
計画
views trueview_views 取り外し / 交換 ReachPlanService で、views への参照を新しい 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_videosrelated_creators のサポートを追加し、video_propertiespublish_date でプロパティを監視します。
InsightsFinder の改善 新機能 GenerateInsightsFinderReportparental_statusincome_ranges、より複雑な AND/OR ターゲティングの組み合わせをサポートするようになりました。
レポート
新しいクリックタイプ 新しい列挙値 CLICK_TO_MESSAGE_THIRD_PARTY_CLICKCLICK_TO_MESSAGE_LANDING_PAGE_CLICK を追加しました。
AssetGroupAsset のセグメンテーション 新しいセグメントのサポート AssetGroupAsset は、deviceconversion_actionconversion_action_nameconversion_action_category でセグメント化できるようになりました。
AdGroupAdAssetView のレスポンシブ検索広告 新機能 / 指標のサポート AdGroupAdAssetView で、RESPONSIVE_SEARCH_AD のパフォーマンスとコンバージョンの指標が完全にサポートされるようになりました(以前はインプレッション数のみが返されていました)。
探索クエリのクラスタ指標のセグメンテーション 新しいセグメントのサポート 指標 clicks_unique_query_clustersconversions_unique_query_clustersimpressions_unique_query_clusters を日付フィールドでセグメント化できるようになりました。
TargetingExpansionView 新しいレポート リソース TargetingExpansionView を追加して、検索キャンペーン向け AI 最大化設定のキーワードレスの拡張など、手動ターゲティングの拡張に関する指標をレポートに含めることができるようになりました。
ショッピング
ショッピングのスコープの修正 バグの修正 ShoppingProduct リソースの指標のキャンペーンと広告グループのスコープ設定を修正しました。
統合された目標
「ユーザー維持」目標 新機能 既存顧客の再エンゲージメントを重視した最適化(TARGET_SPECIFIC または TARGET_ALLtarget_option を使用するなど)を行うための顧客維持目標のサポートを追加しました。
動画
動画の総再生時間に関する指標 新しいフィールド 総再生時間(video_watch_time_duration_millis)とインプレッションあたりの平均再生時間(average_video_watch_time_duration_millis)の指標を追加しました。

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

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