リリースノート

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

v26 メジャー バージョン

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

v26(2026 年 10 月 14 日)

Google Ads API v26 はメジャー リリースであり、以下の新機能、更新、互換性を破る変更が追加されました。

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

破壊的変更

初期状態 新しい状態 変更タイプ 導入に関するアドバイス
キャンペーン
LocalServicesPmaxCampaignSettings の省略可能な country_code フィールド ローカル サービスの P-MAX キャンペーンの作成時に必須のフィールド(LocalServicesPmaxCampaignSettings.country_code) 挙動のシフト ローカル サービスの P-MAX キャンペーンを作成する際は、country_code(および新しく必須となった listing_id)を必ず指定してください。
コンバージョン数
ConversionTrackingSetting(Customer.conversion_tracking_setting)の enhanced_conversions_for_leads_enabled フィールド なし 削除 代わりに Customer.conversion_tracking_setting で ConversionTrackingSetting.enablement_setting を使用して、アカウント単位の拡張コンバージョン設定を検査します。
ターゲティング
AdGroupBidModifier のホテル固有の条件フィールド:
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay(min_nights、max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
AdGroupBidModifier の業種に依存しない条件フィールド: 名前の変更 / 削除 ホテル以外の旅行カテゴリ(おすすめスポットなど)を対象としたターゲティングをサポートする、カテゴリに依存しない条件フィールドを使用するように参照を更新します。条件 ID、ターゲティング行動、既存の単価調整比はそのままです。min_nights と max_nights の値は、そのまま min_days と max_days に引き継がれます。
HotelDateSelectionType と segments.user_set_dates のタイプ DateSelectionType 名前変更 / タイプの変更 HotelDateSelectionType ではなく DateSelectionType を使用します。
CriterionError のホテル固有のエラー理由:
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
CriterionError の業種に依存しないエラー理由: 名前を変更 新しい業種に依存しないエラー理由を確認するように、エラー処理を更新します。

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

機能とアップデート タイプ 説明
アセット
LINE と SMS のビジネス メッセージ プロバイダ 新しいフィールドと列挙値 BusinessMessageAsset でメッセージ プロバイダとして LINE と SMS のサポートを追加しました。これには、新しいフィールド BusinessMessageAsset.line_info と BusinessMessageAsset.sms_info、BusinessMessageProvider.LINE と BusinessMessageProvider.SMS が含まれます。
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY 新しい列挙値 / エラー AssetGroupError に追加され、GoogleLocalServicesInfo(AssetGroup.google_local_services_info)で指定されたカテゴリがローカル サービスの P-MAX キャンペーンでサポートされていないことを示します。
キャンペーン
ローカル サービス P-MAX キャンペーンの作成 新機能、フィールド、エラー

PmaxCampaignSettings.local_services_enabled を OUTPUT_ONLY から IMMUTABLE に更新し、外部 API クライアントが新しいローカル サービスの P-MAX キャンペーンを作成するときに local_services_enabled = true を指定できるようにしました。

また、ローカル サービス P-MAX キャンペーンにリンクされている Google ビジネス プロフィールのリスティング ID(ローカル サービス P-MAX キャンペーンの作成時に必須としてマークされる)を公開するために LocalServicesPmaxCampaignSettings.listing_id を追加し、CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID エラーコードを追加しました。

ローカル サービス キャンペーンの検証エラー 新しい列挙値とエラー ローカル サービス キャンペーンに新しい検証エラーを追加しました。
Hotel Center アカウントのリンクの検証 新しい列挙値 / エラー CampaignError に CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED エラーコードを追加しました。これは、ホテル物件アセット セット(Campaign.hotel_property_asset_set)を旅行関連の目標達成のための P-MAX キャンペーンにリンクするには、有効な Hotel Center アカウントのリンクが必要であることを示します。
デマンド ジェネレーションの 1 日あたりの最小予算 新しいフィールド CurrencyConstant に demand_gen_info.minimum_budget_per_day_micros フィールドを追加しました。このフィールドでは、その通貨でのデマンド ジェネレーション キャンペーンに必要な 1 日あたりの最小予算を指定します。このフィールドの値は、API によって適用される最小予算が変更されると更新されます。
キャンペーンのリフト測定の設定 新しいフィールド Campaign.lift_measurement_config を追加して、キャンペーンにリンクされているリフト測定構成のリソース名を公開しました。
AI 最大化設定テストの検証 新しい列挙値 / エラー AI 最大化設定がすでに有効になっている(またはテスト群の作成前に同じリクエスト内で有効になっている)キャンペーンに対して ADOPT_AI_MAX テストを作成しようとした場合に、ExperimentArmError に ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED エラーコードを追加しました。
ショッピング キャンペーンのリスティング タイプ サポートの拡大 ショッピング キャンペーンへの Campaign.listing_type のサポートを拡大しました。
EU の政治広告に関する自己申告の更新 更新された動作と新しいフィールド

欧州連合を積極的にターゲットに設定していない一部のキャンペーンでは、Campaign.contains_eu_political_advertising がオプションになりました。

  • アップグレードされたターゲティングを使用する DEMAND_GEN キャンペーンの場合を除き、リクエストの実行後にキャンペーンが次のすべての条件を満たす場合、このフィールドは省略可能です。
    • EU 内の地域を対象とするポジティブなキャンペーン条件が含まれていない
    • 近隣地域または地域グループのキャンペーン条件が設定されていない
    • EU 以外の地域を対象とするポジティブな地域キャンペーン条件が 1 つ以上含まれている
  • upgraded_targeting を含む DEMAND_GEN キャンペーンの場合、リクエストの実行後にキャンペーン内のすべてのアクティブな広告グループが次のすべての条件を満たしている場合、このフィールドは省略可能です。
    • EU 内の地域を対象とする広告グループの条件が含まれていない
    • 非除外の近接または地域グループの広告グループの条件が含まれていません
    • EU 以外の地域を対象とする非除外地域広告グループの条件が 1 つ以上含まれている
    有効な広告グループがないキャンペーンの場合も、このフィールドは省略可能です。これらの条件を満たさない広告グループを作成するリクエストを送信すると、AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION が返されます。
  • これらの変更は、新規と既存のキャンペーンの両方に適用されます。場合によっては、同じリクエストに条件が追加されている場合にのみ、新しいキャンペーンを作成できます。GoogleAdsService.Mutate を使用して、変更をグループ化します。
  • Campaign.contains_eu_political_advertising の変更に合わせて Campaign.missing_eu_political_advertising_declaration を更新しました。
  • GeoTargetConstant.require_eu_political_advertising_declaration を追加して、場所が EU 内か EU 外かを示すようにしました。
  • CampaignCriterion.require_eu_political_advertising_declaration と AdGroupCriterion.require_eu_political_advertising_declaration を追加しました。このフィールドがキャンペーン内のキャンペーン単位の条件(または、ターゲティングがアップグレードされた DEMAND_GEN キャンペーン内の有効な広告グループ単位の条件)で true の場合は、Campaign.contains_eu_political_advertising が必要です。条件の negative フィールドが false で、条件が EU 内の地域、近接(EU 領域と重複するかどうかに関係なく)、または地域グループ(EU 領域と重複するかどうかに関係なく)の場合、フィールドは true を返します。
コンバージョン数
統合された拡張コンバージョンの設定 新しいフィールドと列挙型 ConversionTrackingSetting.enablement_setting と ConversionTrackingSetting.effective_enablement_setting(Customer.conversion_tracking_setting)を追加して、新しい EnhancedConversionsConfig 列挙型で表される、アカウントの統合された拡張コンバージョン設定を公開しました。
ConversionActionCategory.MESSAGE_LEAD 新しい列挙値 ConversionActionCategory に追加され、広告主の商品やサービスへの関心を示すメッセージやチャットのやり取りをサポートします。
ConversionAttributionEventType.CLICK 新しい列挙値 ConversionAttributionEventType に追加され、広告クリックに貢献度が割り当てられたコンバージョンを表します。以前は UNKNOWN 列挙値に含まれていました。
全般
ローカル サービスの見込み顧客に関する最新情報 新しいフィールドと列挙値
推奨事項
検索の予算引き上げに関する最適化案 新しい最適化案 検索キャンペーンの 1 日の予算が低すぎる場合に予算を引き上げられるよう、RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW、Recommendation.raise_budget_performance_too_low_recommendation、ApplyRecommendationOperation.raise_budget_performance_too_low を追加しました。
レポート
検索数の増加測定 新機能、リソース、セグメント、指標 「検索数の増加」測定のサポートを追加しました。
ショッピング キャンペーンの最終ページ URL の拡張アセットビュー サポートの拡大 final_url_expansion_asset_view を拡張し、ショッピング キャンペーンをサポートしました(ad_group を final_url_expansion_asset_view.ad_group とともにアトリビューション リソースとして選択可能)。
動画
YouTube の生成コンテンツの開示 新しいフィールドと列挙型 YouTube へのアップロードで、生成コンテンツの開示のサポートを追加しました。VideoContentMetadata 型の新しいフィールド YouTubeVideoUpload.video_content_metadata が YouTubeVideoUpload に追加されました。これには、YouTubeVideoUploadGenerativeContentDisclosure 型の VideoContentMetadata.generative_content_disclosure の開示設定が含まれています。

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_template、final_urls、final_mobile_urls で URL カスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。
  • AssetGroup.final_url_suffix: パラレル トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。
キャンペーン
動画の自動クロールに関する情報 新しいフィールドと列挙型 Campaign.AssetAutomationSetting に AutomatedVideoCrawlSetting と AssetAutomationType.AUTOMATED_VIDEO_CRAWL を追加しました。これにより、P-MAX キャンペーンの自動動画クロール設定を指定できるようになりました。AutomatedVideoCrawlSetting.automated_video_crawl_infos には AutomatedVideoCrawlInfo エントリのリストが含まれています。各エントリは、クロールの url、source_platform(VideoCrawlSourcePlatform: LANDING_PAGE、SOCIAL、YOUTUBE)、enabled のオプトイン ステータスを構成します。
顧客ライフサイクルの最適化の価値の調整比に関するエラー 新しい列挙値とエラー 顧客ライフサイクル最適化の価値の乗数(value_multiplier と high_lifetime_value_multiplier)を設定する際の検証エラーの理由を追加しました。
SmartCampaignSettingService.GeneratePMaxDraftCampaign 新機能 SmartCampaignSettingService.GeneratePMaxDraftCampaign を追加し、既存のスマート キャンペーンから P-MAX の下書きキャンペーンを生成できるようにしました。このキャンペーンは、ステータス CampaignStatus.PAUSED、作成ステータス CampaignCreationStatus.INCOMPLETE で初期化されます(スマート キャンペーンを P-MAX キャンペーンに変換するをご覧ください)。
コンバージョン数
Firebase 広告のインプレッション数 新しいコンバージョン アクションのタイプとカテゴリ FIREBASE_ANDROID_APP_AD_IMPRESSION と FIREBASE_IOS_APP_AD_IMPRESSION のコンバージョン アクション タイプを公開し、これらのコンバージョン アクションを取得、変更できるようにしました。また、アプリ内広告の収益化による収益をトラッキングするために、ConversionActionCategory で IN_APP_AD_REVENUE カテゴリを公開しました。
全般
BusinessProfileLocationSyncError 新しい列挙型とエラー LOCATION_SYNC 型の AssetSet でビジネス情報を同期する際に、ビジネス プロフィールのビジネス情報の同期エラーの理由を追加しました。API は、一般的な UNKNOWN エラーを返す代わりに、特定の理由(EMAIL_INVALID、OAUTH_TOKEN_INVALID、ACCOUNT_REMOVED、NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT)とともに BusinessProfileLocationSyncError を返すようになりました。
計画
BenchmarksService.GenerateBenchmarksMetrics パーセンタイル指標 新機能

BenchmarksService.GenerateBenchmarksMetrics を更新し、他の広告主と比較したお客様の競合状況を示す指標をパーセンタイル階層形式で提供するようにしました。指標は、新しい CustomerMetrics.percentile_metrics フィールド(GenerateBenchmarksMetricsResponse.customer_metrics と BreakdownMetrics.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_recommendation(RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW)と Recommendation.lower_target_roas_performance_bid_too_low_recommendation(LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)に加えて、ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low と ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low を追加しました。
レポート
ホテル宿泊プランのディメンション セグメント 新しいセグメント Segments に、次のホテルと旅行予約の旅程ディメンション セグメントを追加しました(campaign、ad_group、customer で選択可能)。
縦長広告の指標 新しい指標 ホテルと旅行のバーティカル広告レポートに、次の指標を Metrics に追加しました(campaign、ad_group、customer で選択可能)。
縦長広告セグメント 新しいセグメント ホテルと旅行業種の広告のレポートに、次のセグメントを Segments に追加しました(campaign、ad_group、customer で選択可能)。

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_date と end_date)など、測定期間の詳細を表す新しい読み取り専用リソース。
全般
SmartCampaignError 新しい列挙値 P-MAX の生成制約に関する新しい特定のエラーコードを追加しました。
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 新しい列挙値 / エラー TEST アクセスレベルの Google Cloud プロジェクトがテスト用以外のアカウントに対してリクエストを試みた場合に返されます。
計画
ブランド センチメントに関する分析情報 新機能 ContentCreatorInsightsService でブランド センチメント分析情報のサポートを追加しました。
BenchmarksService の拡張機能 新機能 ベンチマーク分析の範囲設定のフィルタとしてカテゴリがサポートされるようになりました。ビジネス クリティカルな指標も追加でサポートされています。
  • BenchmarksService.GenerateBenchmarksMetrics と category_filter を使用して、1 つ以上の商品 / サービス カテゴリで広告を掲載しているすべての広告主様と比較するオプションを追加しました。
  • 顧客の合計費用や視聴回数などの顧客広告指標や、share_of_voice などのシェア指標がより多く表示されるようになりました。指標は AggregateMetrics と ShareMetrics を使用して返されます。
  • サポートされているカテゴリのリストは、CATEGORY ソースタイプを指定して BenchmarksService.ListBenchmarksSources を使用することで取得できます。
子供の有無によるターゲティング 新機能 リーチ プランニングで、子供の有無のターゲティングのサポートを追加しました。サービス ReachPlanService.GenerateReachForecast の Targeting に新しいフィールド parental_statuses を追加し、サービス ReachPlanService.ListPlannableProducts の PlannableTargeting に parental_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_value と additional_high_lifetime_value それぞれ value_adjustment と high_lifetime_value_adjustment の oneof の一部。新しい value_multiplier フィールドと high_lifetime_value_multiplier フィールドも含まれます。 構造の変更 これらのフィールドは oneof の一部になったため、参照を更新します。
以前の CustomerLifecycleGoal リソースと CampaignLifecycleGoal リソース、それらに対応するサービス CustomerLifecycleGoalService と CampaignLifecycleGoalService、以前の設定/列挙型(CustomerAcquisitionGoalSettings、CustomerAcquisitionOptimizationModeEnum、LifecycleGoalValueSettings) なし 削除 刷新された統一目標スキーマを使用します。
全般
インセンティブ サービスのリクエスト メッセージとレスポンス メッセージのネストされた列挙型フィールド:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
スタンドアロンの列挙型フィールド: 名前の変更 / 削除 以前の type フィールドではなく、新しいスタンドアロン列挙型フィールドを使用します。
ApplyIncentiveRequest の省略可能な selected_incentive_id フィールドと customer_id フィールド 必須項目 挙動のシフト ApplyIncentive を呼び出すときは、両方のフィールドを指定してください。
LocalServicesLead リソースの消費者のメールアドレス フィールド ContactDetails.email なし 削除 このフィールドはサポートされなくなったため、このフィールドへの参照を削除します。
AdvertisingPartnerLinkInvitationProperties の省略可能な allowed_domain フィールド 広告パートナーの CreateProductLinkInvitation を呼び出す場合の必須フィールド 挙動のシフト 広告パートナーのプロダクト リンクの招待を作成する際は、必ず allowed_domain を指定してください。
計画
GenerateCreatorInsightsRequest の search_brand フィールド なし 削除 代わりに search_topics を使用してください。
Targeting の plannable_location_id フィールドと GenerateReachForecastRequest の cookie_frequency_cap フィールド なし 削除 plannable_location_ids と cookie_frequency_cap_setting の使用に切り替えます。
レポート
GenerateBenchmarksMetricsResponse の customer_metrics フィールドと Metrics 型の BreakdownMetrics CustomerMetrics 型のフィールド タイプの変更 / 動作のシフト 統合を更新して、顧客の広告のパフォーマンスを表す指標のみを含む新しい CustomerMetrics 型を使用します。

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

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

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.status と synthetic_content_info.advertiser_attestation.source はこれらのバージョンで不変のままです。

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

「変更しようとしたフィールドは変更できません」または「フィールドを設定できません」。

これらのフィールドは、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-04-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 はこれらのバージョンで不変のままです。

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

「変更しようとしたフィールドは変更できません」または「フィールドを設定できません」。

これらのフィールドは、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 で、デマンド ジェネレーションのクリック数の最大化(クリック単価)の 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-01-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 新しいフィールド / タイプ YouTubeChannelInsights に追加され、YouTube チャンネルのコンテンツの言語分布の詳細が提供されるようになりました。
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 のオーディオ広告の聴取可能性に関する指標が追加されました。広告が聴取可能だったかどうかと、聴取可能性を測定できたインプレッション数をレポートします。

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

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