リリースノート

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

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

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

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 最大化設定への自動移行の予定を確認します。
コンバージョン数
ブランド効果測定	新機能	以下の更新により、ブランド効果測定のサポートを追加しました。 リフト調査の結果用の新しい読み取り専用のディメンション リソース LiftMeasurementAgeRange、LiftMeasurementCampaign、LiftMeasurementDevice、LiftMeasurementGender、LiftMeasurementVideo を追加しました。 LiftMeasurementConfig と新しいディメンション リソースによるブランド効果測定分析をサポートするために、新しいセグメントと指標を追加しました。 BrandLiftMeasurementType、LiftMeasurementFlightStatus、SurveyIntendedAction、SurveyLiftFlightTargetResponseMode、SurveySubjectType の列挙型を追加しました。
コンバージョン リフト測定	新機能	以下の更新により、コンバージョン リフト測定のサポートを追加しました。 リフトアップ調査を表す新しい読み取り専用リソース LiftMeasurementConfig を追加しました。 リフト結果をセグメント化してフィルタするための新しい選択可能なセグメントを追加しました。 リフト パフォーマンスの詳細な統計分析をサポートする 24 個の新しいコンバージョン リフト測定指標と勝者スコア指標を追加しました。 キャンペーンの詳細とコンバージョン目標を取得するサポートを追加しました。 新しいオプション フィールド Experiment.lift_measurement_config を追加しました。 ConversionLiftIncludedConversionActionTypes 列挙型を追加しました。
LiftMeasurementFlight	新しいリソース	リフト測定の設定のフライトの詳細を表す新しい読み取り専用リソース。測定されたフライトの開始日と終了日（start_date と end_date）が含まれます。
全般
SmartCampaignError	新しい列挙値	P-MAX の生成制約に関する新しい特定のエラーコードを追加しました。 VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	新しい列挙値 / エラー	TEST アクセスレベルの Google Cloud プロジェクトがテスト以外のアカウントに対してリクエストを試みた場合に返されます。
計画
ブランド センチメントに関する分析情報	新機能	ContentCreatorInsightsService でブランドの感情分析情報のサポートを追加しました。 BrandSentimentInsight、SentimentInsightDistribution、SentimentInsightSummary のメッセージを追加しました。 Sentiment 列挙型を追加しました。 ContentCreatorInsightsSupplementalData 列挙型に BRAND_SENTIMENT_DATA 値を追加しました。 InsightsKnowledgeGraphEntityCapabilities 列挙型に BRAND 値を追加しました。
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	新しい条件タイプ	AdGroupCriterion.criterion に新しい vertical_ads_item_bid 条件タイプを追加しました。

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）	なし	削除	刷新された統一目標スキーマを使用します。 Goal リソースの new_customer_acquisition_goal_settings フィールドを使用します。 CampaignGoalConfig リソースの campaign_new_customer_acquisition_settings フィールドを使用して、キャンペーン固有のオーバーライドを構成します。
全般
インセンティブ サービスのリクエスト メッセージとレスポンス メッセージのネストされた列挙型フィールド: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	スタンドアロン列挙型フィールド: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_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 を使用するように切り替えます。
レポート
Metrics 型の GenerateBenchmarksMetricsResponse と BreakdownMetrics の customer_metrics フィールド	CustomerMetrics 型のフィールド	型の変更 / 挙動のシフト	統合を更新して、顧客の広告のパフォーマンスを表す指標のみを含む新しい CustomerMetrics タイプを使用します。

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

機能とアップデート	タイプ	説明
広告
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	新しい列挙値 / 動作	DemandGenMultiAssetAds で使用できます。有効にすると、アニメーション以外の画像を入力として使用してアニメーション画像が生成されます。この API バージョン以降、新しい DemandGenMultiAssetAds はデフォルトでオプトインされます。
合成コンテンツ情報の変更可能性	行動の変更	Asset.synthetic_content_info と Ad.synthetic_content_info は、v25、v24、v23 で完全に変更可能になりました。
キャンペーン
「ユーザー維持」目標	新機能 / 設定	ポイント プログラム メンバーの維持を目的としたキャンペーンの最適化を可能にする「ポイント プログラム メンバーの維持」目標のサポートを追加しました。 GoalType 列挙型に LOYALTY_RETENTION を追加しました。 CampaignGoalConfig.campaign_loyalty_retention_settings を追加しました。これにより、入札単価調整や PLA 形式でのメンバー特典の表示など、キャンペーン固有のポイント プログラムのユーザー維持設定を構成できます。 アカウント単位のロイヤルティ維持目標の設定を構成する Goal.loyalty_retention_goal_settings を追加しました。 新しいエラーコードを追加しました。 LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
「新規顧客の獲得」目標	新機能 / 設定	Google Ads API での「新規顧客の獲得」目標のサポートを更新し、統合型の目標のスキーマの変更を反映しました。 new_customer_acquisition_goal_settings フィールドを使用して新規顧客の獲得設定をサポートするように Goal リソースを拡張しました。 campaign_new_customer_acquisition_settings フィールドを使用して、新規顧客の獲得のキャンペーン固有のオーバーライドをサポートするように CampaignGoalConfig リソースを拡張しました。 サポートされている目標のサブタイプを定義するために、新しい CustomerLifecycleOptimizationGoalSubType 列挙型を追加しました。 GoalType 列挙型に NEW_CUSTOMER_ACQUISITION を追加しました。 GoalError に新しい検証エラーの理由を追加しました。 NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError に新しい検証エラーの理由を追加しました。 CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS 検証エラーの新しい IncompatibleCloGoalsErrorDetails 構造を公開するために ErrorDetails.incompatible_clo_goal_error_details を追加しました。
コンバージョン数
YouTube のサードパーティ コンバージョン アトリビューション	新しいフィールド	サードパーティ パートナーを使用した YouTube コンバージョン アトリビューション検証のサポートを追加しました。 CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners を追加し、顧客レベルで統合パートナーを構成できるようにしました。 キャンペーン単位で統合パートナーを設定できるように CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners を追加しました。 詳しくは、ヘルプセンターの記事をご覧ください。
全般
ContactDetails.phone_number_extension	新しいフィールド	LocalServicesLead リソースに追加されました。
IncentiveError	新しい列挙値 / エラー	特典の利用失敗に関する新しい特定のエラーコードを追加しました。 BILLING_COUNTRY_NOT_ELIGIBLE（お客様の請求先住所の国がインセンティブの対象外） USER_IS_MCC_MANAGER（ユーザーが MCC アカウントで、インセンティブを利用できない） USER_SUSPENDED（お客様のアカウントが停止されている） MAX_PENDING_INCENTIVES（保留中のインセンティブが上限数に達している） ACCOUNT_HAD_RECENT_SPEND（アカウントで最近費用が発生しており、対象外） MAX_INCENTIVES_REDEEMED_FROM_OFFER（お客様はすでにこの特典のインセンティブを上限まで利用しています） MISMATCHING_BILLING_COUNTRY_CODE（リクエストで指定された請求先住所の国コードがお客様のアカウントの国と一致しない）
計画
急上昇の分析情報の YouTube チャンネルの詳細	新しいフィールド	急上昇ワードの分析時に、関連動画の YouTube チャンネルの詳細情報をさらにサポートしました。新しいフィールド channel_id、channel_name、channel_url が YouTubeVideoAttributeMetadata に追加されました。
YouTubeChannelInsights.data_sharing_consent_given	新しいフィールド	YouTubeChannelInsights に追加しました。これは、クリエイターが非公開データの共有に同意している場合に当てはまります。その場合、次のフィールドに値が入力されます。 average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
レポート
ad_sub_format_type	新しいセグメント	YouTube のインストリーム スキップ不可広告を長さ別に分類したデータを提供します。 INSTREAM_NON_SKIPPABLE_STANDARD（標準の長さのインストリーム スキップ不可広告） INSTREAM_NON_SKIPPABLE_MAX30_SEC（30.99 秒以下のインストリーム スキップ不可広告） INSTREAM_NON_SKIPPABLE_MAX60_SEC（インストリーム スキップ不可広告、60.99 秒以下） このセグメントは、常に ad_format_type と一緒に選択する必要があります。AdGroup、AdGroupAd、Campaign、Customer、Video、VideoEnhancement で選択できます。
動画固有のソーシャル指標	新しいフィールド / 指標	YouTube のショート動画広告に対するユーザー エンゲージメント（コメント、高評価、共有）を広告主様がトラッキングできるように、動画固有のソーシャル指標を追加しました。 Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares 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 はこれらのバージョンでは変更できません。 これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。 「The field attempted to be mutated is immutable」または「Field cannot be set」。 これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。
マルチパーティ認可	新機能	ベータ版: この機能は現在ベータ版であり、今後のリリースで変更される可能性があります。 複数の関係者による承認（MPA）の審査のサポートを追加しました。 MultiPartyAuthReview リソースと対応する MultiPartyAuthReviewService を追加しました。 レビューのステータスを追跡する MultiPartyAuthReviewStatus 列挙型を追加しました。 保留中の審査にリンクする CustomerUserAccess.pending_multi_party_auth_review を追加しました。 関連付けられたクチコミのリソース名を返すために、MutateCustomerUserAccessResult.multi_party_auth_review と MutateCustomerUserAccessInvitationResult.multi_party_auth_review を追加しました。 検証エラー用に MultiPartyAuthReviewError を追加しました。 この機能は、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 でキーワード プラン / 予測フィールドが非推奨になりました	なし	削除	次のプラン / 予測のフィールドとタイプを削除しました。 CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords、ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate インテグレーションを適宜更新します。
レポート
campaign_budget の ad_sub_network_type セグメント	なし	削除	campaign_budget リソースの ad_sub_network_type セグメントを削除しました。
アセットビューの click_type セグメント	なし	削除	AdGroupAsset、CampaignAsset、CustomerAsset ビューからセグメントを削除しました。
動画
ShareablePreviewService.GenerateShareablePreviews で部分的な失敗が許可されている	部分的な失敗なし	挙動のシフト	リクエスト内の ID のいずれかが検証に失敗すると、リクエストは失敗し、エラーがスローされます。
ShareablePreviewError レガシーコード: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	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	新しいレポート リソース	クリックされた商品に加えて、販売された特定の商品（ブランドなど）別にコンバージョン指標を分割したレポートを表示します。
入札不可の指標	新しいフィールド	入札不可の指標（キャンペーンで最適化されていないコンバージョンを示す指標）を、一致するすべてのリソースに追加しました。 all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	新しいセグメント	ShoppingPerformanceViewに追加しました。
ショッピング
ShoppingProduct のアプリ キャンペーン	新機能	ShoppingProduct リソース内でサポートされているアプリ キャンペーン。メモのステータスと問題はサポートされていません。
タグベースの商品フィルタリング	新機能	論理セット式を使用した動的なフィルタリングを導入しました。 RETAIL_FILTER_BUNDLE と RETAIL_FILTER の条件タイプを追加しました。 RETAIL_FILTER 共有設定タイプを追加しました。 AdGroupCriterion に retail_filter_bundle フィールドを追加しました。 SharedCriterion に retail_filter フィールドを追加しました。 ListingGroupFilterListingSource に RETAIL を追加しました。 AssetGroupListingGroupFilter に RetailFilter ディメンションを追加しました。 CriterionError と AssetGroupListingGroupFilterError に関連する新しい検証エラーを追加しました。 この機能は、許可リストに登録されたアカウントのみ利用可能です。

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）の審査のサポートを追加しました。 MultiPartyAuthReview リソースと対応する MultiPartyAuthReviewService を追加しました。 レビューのステータスを追跡する MultiPartyAuthReviewStatus 列挙型を追加しました。 保留中の審査にリンクする CustomerUserAccess.pending_multi_party_auth_review を追加しました。 関連付けられたクチコミのリソース名を返すために、MutateCustomerUserAccessResult.multi_party_auth_review と MutateCustomerUserAccessInvitationResult.multi_party_auth_review を追加しました。 検証エラー用に MultiPartyAuthReviewError を追加しました。

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-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	新機能 / サポート	更新されたビジネス メッセージ アセット: プロバイダとして Facebook Messenger と Zalo のサポートを追加しました。 BusinessMessageProvider に FACEBOOK_MESSENGER と ZALO を追加しました。 facebook_messenger_info フィールドと zalo_info フィールドを追加しました。 AssetError に CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS を追加しました。
課金
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）インセンティブのサポートを追加しました。 ユーザーが利用できるパーソナライズされたインセンティブを取得するための FetchIncentive メソッドを追加しました。 選択したインセンティブを顧客アカウントに適用する ApplyIncentive メソッドを追加しました。 特典利用の詳細を提供するために、AppliedIncentive リソース（Search と SearchStream を使用してクエリ可能）を追加しました。 IncentiveError と AuthenticationError.INVALID_EMAIL_ADDRESS に新しいエラーコードを追加しました。 障害のより詳細なプログラマティック処理を容易にするため、今後のリリースで 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 条件タイプを追加し、vertical_ads_item_group_rule を SharedCriterion に追加して、旅行フィードを使用する検索キャンペーンでアイテム グループをターゲットに設定できるようにしました。
縦長広告のデータフィード統合	新機能	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）の審査のサポートを追加しました。 MultiPartyAuthReview リソースと対応する MultiPartyAuthReviewService を追加しました。 レビューのステータスを追跡する MultiPartyAuthReviewStatus 列挙型を追加しました。 保留中の審査にリンクする CustomerUserAccess.pending_multi_party_auth_review を追加しました。 関連付けられたクチコミのリソース名を返すために、MutateCustomerUserAccessResult.multi_party_auth_review と MutateCustomerUserAccessInvitationResult.multi_party_auth_review を追加しました。 検証エラー用に MultiPartyAuthReviewError を追加しました。

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）の指標を追加しました。

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

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