現在および計画中の機能の非推奨の最新リストについては、機能の非推奨をご覧ください。
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 タイプ（
|
| 全般 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
新しいフィールド | 合成コンテンツ/AI 生成コンテンツの証明を含みます。advertiser_input（広告主様が直接提供した宣言）と system_input（システムが自動的に検出または提供した証明）に分かれています。この機能は v23 と v22 にバックポートされています。
v25 での今後の統合作業の計画に役立つよう、広告主様の証明書フィールドを変更するためのインターフェースが v22 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、 これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。 「The field attempted to be mutated is immutable」または「Field cannot be set」。 これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。 |
| マルチパーティ認可 | 新機能 |
複数当事者承認（MPA）の審査のサポートを追加しました。
この機能は、v23.3、v22.2、v21.2 にバックポートされています。 |
IncentiveService.FetchIncentive |
動作の変更 | リクエストで無効なメールアドレスが指定された場合、このメソッドは AuthenticationError.INVALID_EMAIL_ADDRESS エラーをスローする代わりに、デフォルトのインセンティブ オファーを返すようにフォールバックするようになりました。 |
| 計画 | ||
GenerateCreatorInsightsRequest.search_topics |
新しいフィールド | ContentCreatorInsightsService.GenerateCreatorInsights サービスに追加されました。このオプションでは、country_locations で指定した国で、特定のトピックについて話しているクリエイターを検索します（検索できるのは 1 つの国のみです）。 |
CREATOR_TOPIC_INSIGHTS |
新しい列挙値 | InsightsKnowledgeGraphEntityCapabilities に追加され、トピックについて話しているクリエイターを検索するためのエンティティを示します。これらのエンティティは search_topics フィールドで使用する必要があります。AudienceInsightsService.ListAudienceInsightsAttributes を使用して取得されます。 |
KnowledgeGraphEntitySearchOptions |
新しいタイプ / オプション | ListAudienceInsightsAttributes のトピックに関する追加の検索オプションが含まれます。これには、クリエイター属性としてサポートされているすべてのトピックを取得するオプションや、機能でフィルタするオプションが含まれます。 |
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data |
新しいフィールド | ContentCreatorInsightsService メソッドへの省略可能な入力。このフィールドを指定すると、レスポンスに追加の場所やクリエイターの属性が入力されます。 |
local_creator_insights related_local_creators |
新しいフィールド | supplemental_data に LOCAL_CREATOR_DATA 列挙型が含まれている場合に設定されます。選択した国で視聴された、または選択した国を拠点とする、位置情報の共有に同意したローカル クリエイターが表示されます。 |
GenerateTrendingInsightsRequest.sub_country_locations |
新しいフィールド | ContentCreatorInsightsService.GenerateTrendingInsights に追加され、国と地域を使用して急上昇の分析情報を検索できるようになりました。 |
| レポート | ||
PerformanceMaxPlacementView |
セグメント拡張機能 | ad_network_type でセグメント化可能になりました。 |
| ショッピング | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
新しいフィールド | true の場合、ショッピング広告でブランド除外が無視されます。ショッピング キャンペーンでのみサポートされています。 |
| ターゲティング | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
新しい列挙値 / エラー | 許可されていない言語をターゲットにしようとしたときに返されます。 |
| 動画 | ||
DataLink.youtube_link_metadata |
新しいフィールド | リンクされた YouTube ブランド チャンネルの ID を指定する brand_channel_id が含まれます。 |
v24.1（2026 年 5 月 13 日）
Google Ads API v24.1 では、以下の新機能とアップデートが追加されました。v24.1 などのマイナー バージョンには、互換性を破る変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 広告 | ||
DemandGenMultiAssetAdInfo.classic_display_images |
新しいフィールド | カスタム アップロードのディスプレイ画像は、追加のレスポンシブ アセットを必要とせずに配信されます。 |
| テスト | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
新しい列挙値 | 新しい ExperimentType タイプ（
|
Experiment.video_experiment |
新しいフィールド | 動画キャンペーンで構成される既存の YOUTUBE_CUSTOM テストの設定をサポートします。 |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
新しいフィールド | テスト群でアセットのテスト、アセット グループ、P-MAX の設定をサポートするフィールドを公開します。
|
| 全般 | ||
CustomerUserAccess.passkey_enabled |
新しいフィールド | ユーザーがパスキーを有効にしているかどうかを示す読み取り専用フィールド。 |
| レポート | ||
mobile_device_platform |
新しいセグメント | ユーザーのデバイスのプラットフォーム（iOS、Android など）でレポートをセグメント化できます。 |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
新しい列挙値 / エラー | リクエストされた日単位、時間単位、週単位の粒度がクエリの期間で対象外の場合に返されます（過去 37 か月間のみ使用可能）。 |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
新しいセグメント | 縦型広告に使用される新しいセグメント。 |
user_rating、venue、event_participant_display_name |
新しいフィルタ条件 | SharedCriterion リソースの VerticalAdsItemGroupRuleInfo でのフィルタリングをサポートしました。 |
| コントロール群と介入群のテスト指標 | 新しいフィールド | 7 つのコア指標ファミリ（クリック数、インプレッション数、費用、コンバージョン数、コンバージョン単価、コンバージョン値、費用あたりのコンバージョン値）全体に、コントロール値（control_clicks など）、トリートメント値（clicks など）、点推定値（clicks_point_estimate など）、誤差の範囲（clicks_margin_of_error など）、p 値（clicks_p_value など）を追加しました。 |
| コンバージョン数の絶対変化の指標 | 新しいフィールド | 点推定、許容誤差、p 値の各フィールドを使用した Conversions 絶対差の推定のサポート。 |
| ターゲティング | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
新しい列挙値 / エラー | すべてのユーザー属性のターゲットを除外しようとしたときに返されます。 |
| 動画 | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
新しい列挙値 | ZEFR を第三者の視認性統合パートナーとして公開しました。 |
DataLink.youtube_video.channel_id |
新しいフィールド | データリンクに関連付けられた YouTube チャンネル ID を公開します。 |
v24（2026 年 4 月 22 日）
Google Ads API v24（メジャー リリース）では、次の新機能、アップデート、重大な変更が追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
破壊的変更
| 初期状態 | 新しい状態 | 変更タイプ | 導入に関するアドバイス |
|---|---|---|---|
| 広告 | |||
DemandGenVideoResponsiveAdInfo の省略可能な videos と logo_images |
必須項目 | 行動の変化 | レスポンシブ デマンド ジェネレーション動画広告を作成または変更する際に、videos と logo_images を指定します。 |
VideoResponsiveAdInfo のオプションの videos、business_name、logo_images |
必須項目 | 行動の変化 | 動画レスポンシブ広告を作成または変更するときに、videos、business_name、logo_images を指定します。VideoResponsiveAdInfo は変更可能になりました。 |
| キャンペーン | |||
Campaign.video_brand_safety_suitability |
なし | 削除 | キャンペーン単位の適合性コントロールが削除されます。ブランド保護の適合性は、引き続きお客様のレベルでご利用いただけます。代わりに Customer.video_brand_safety_suitability を使用してください。 |
| コンバージョン数 | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
なし | 削除 | ポイントカード登録のユーザー カテゴリが削除されました。それへのコード参照を削除します。 |
| 計画 | |||
topic_audience_combinations の InsightsAudienceAttributeGroup 型 |
common.InsightsAudienceAttributeGroup タイプ |
行動の変化 / タイプの変更 | 型付きクライアント ライブラリの統合は、新しいリソース Namespace を使用するように更新する必要があります。 |
ReachPlanService.ListPlannableProducts の youtube_select_lineups フィールド |
なし | 削除 | youtube_select_lineup_targeting からラインナップの使用に切り替えます。 |
ContentCreatorInsightsService.GenerateCreatorInsights と GenerateTrendingInsights の is_brand_connect_creator フィールド |
なし | 削除 | 代わりに、クリエイターが partnership_opportunities で CREATOR_PARTNERSHIPS を利用できるかどうかを確認します。 |
KeywordPlanIdeaService.GenerateKeywordForecastMetrics の geo_modifiers と biddable_keywords |
geo_target_constants、keywords |
名前の変更 / 削除 | CampaignToForecast.geo_target_constants[] と ForecastAdGroup.keywords[] に置き換えられました。 |
GenerateKeywordForecastMetrics でキーワード プラン / 予測フィールドが非推奨になりました |
なし | 削除 | 次のプラン / 予測のフィールドとタイプを削除しました。 インテグレーションを適宜更新します。 |
| レポート | |||
campaign_budget の ad_sub_network_type セグメント |
なし | 削除 | campaign_budget リソースの ad_sub_network_type セグメントを削除しました。 |
アセットビューの click_type セグメント |
なし | 削除 | AdGroupAsset、CampaignAsset、CustomerAsset ビューからセグメントを削除しました。 |
| 動画 | |||
ShareablePreviewService.GenerateShareablePreviews で部分的な失敗が許可される |
部分的な失敗なし | 行動の変化 | リクエスト内の ID のいずれかが検証に失敗すると、リクエストは失敗し、エラーがスローされます。 |
ShareablePreviewError レガシーコード:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
名前の変更 / 行動の変化 | アセット グループに対して返されるエラーコードが、広告グループ広告のエラーと一致するように変更されました。検証キャッチ ロジックを更新します。 |
機能とアップデート（非破壊的）
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 広告 | ||
VideoResponsiveAdInfo の可変性 |
動作の変更 | レスポンシブ動画広告の情報オブジェクトが変更可能になりました。 |
| アセット | ||
AssetSet の travel_feed_data |
新しいフィールド | 旅行フィード アセットの属性（hotel_center_account_id、merchant_center_id、partner_center_id、subset_id、travel_feed_vertical_type）を取得するために追加されました。 |
| キャンペーン | ||
Campaign.view_through_conversion_optimization_enabled |
新しいフィールド | デマンド ジェネレーション キャンペーンとアプリ キャンペーンでビュースルー コンバージョン（VTC）の最適化を有効にできます（デフォルトは false）。 |
CampaignCriterion.gender |
新機能 | すべての Google Ads API バージョンで、P-MAX キャンペーンの性別除外を有効にしました。 |
| コンバージョン数 | ||
| 見込み顧客発掘のコンバージョン タイプ | 新しい列挙値 | ConversionActionType に新しい GA4/Firebase コンバージョン アクション タイプの列挙型を追加しました。
|
| 全般 | ||
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 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、 これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。 「The field attempted to be mutated is immutable」または「Field cannot be set」。 これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。 |
| 複数の関係者による承認 | 新機能 |
マルチパーティ承認（MPA）の審査のサポートを追加しました。
|
v23.2（2026 年 3 月 25 日）
Google Ads API v23.2 では、以下の新機能とアップデートが追加されました。v23.2 などのマイナー バージョンには、互換性を破る変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| アセット | ||
VideoEnhancement |
新しいリソース | Google 生成か広告主提供かなど、拡張機能に固有の動画広告情報が含まれます。詳しくは、動画拡張についてをご覧ください。 |
AppTopCombinationView |
新しいリソース | アプリ キャンペーンでパフォーマンスの高いアセットの組み合わせに関する分析情報を提供する読み取り専用リソース。 |
CustomerAsset |
新機能 | field_type が BUSINESS_LOGO に設定されている CustomerAsset を取得するサポートを追加しました。 |
| キャンペーン | ||
AdGroupAd.start_date_time AdGroupAd.end_date_time |
新しいフィールド | キャンペーンの期間について、より詳細なスケジュール設定の制約を指定できます。これは、一部の広告グループ タイプでのみサポートされています。 |
HotelSettingInfo.disable_hotel_setting |
新しいフィールド | デマンド ジェネレーション キャンペーンでホテルフィードを無効にできます。 |
| 全般 | ||
CustomerClientLinkError |
新しい列挙値 / エラー | 2 つの新しいエラーコード（MAX_CUSTOMER_LIMIT_REACHED と ACCOUNT_CREATION_POLICY_VIOLATION）を追加しました。 |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
動作の変更 | このユーザーリストの顧客タイプ カテゴリを使用しようとすると、エラーがスローされるようになりました。 |
| 計画 | ||
GenerateTrendingInsights GenerateCreatorInsights |
新機能 | エンティティ、トピック、オーディエンスのカスタム AND/OR 組み合わせのサポートを追加しました。 |
ReachPlanService.GenerateReachForecast |
新しい列挙値 | AGE_RANGE_21_44 や AGE_RANGE_21_49 など、新しいターゲティング可能な年齢層を追加しました。 |
youtube_select_lineup_targeting |
新しいフィールド | ReachPlanService.ListPlannableProducts に追加しました。これは youtube_select_lineups に代わるものです。現在、両方のフィールドにデータが入力されています。 |
ReachPlanSurface |
新しい列挙値 | サーフェス オプションとして IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS を追加しました。 |
Forecast |
新しいフィールド | ReachPlanService.GenerateReachForecast で、デマンド ジェネレーションのクリック数の最大化（CPC）に clicks を追加しました。 |
partnership_opportunities |
新しいフィールド | ContentCreatorInsightsService.GenerateCreatorInsights と ContentCreatorInsightsService.GenerateTrendingInsights に追加しました。 |
| レポート | ||
biddable_indirect_install_first_in_app_conversion_micros |
新しいフィールド | Campaign、Customer、AdGroup リソースに追加されました。 |
| 動画 | ||
ShareablePreviewService |
新機能 | preview_type を YOUTUBE_LIVE_PREVIEW に設定することで、YouTube ライブ プレビューをサポートするように拡張されました。UNSUPPORTED_AD_TYPE と TOO_MANY_RESOURCES_IN_REQUEST を ShareablePreviewError に追加しました。この機能は一部の広告タイプでのみサポートされています。 |
v23.1（2026-02-25）
Google Ads API v23.1 では、以下の新機能とアップデートが追加されました。v23.1 などのマイナー バージョンには、互換性を損なう変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| アカウント管理 | ||
advertising_partner_properties.allowed_domain |
新しいフィールド | ProductLinkInvitation リソースと ProductLink リソースに追加されました。広告パートナーは、このドメインでのみ広告を掲載できます。 |
Customer.contains_eu_political_advertising |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatus を返します。 |
| キャンペーン | ||
Campaign.text_guidelines |
新しいフィールド | テキストのガイドラインのサポートを追加しました。P-MAX キャンペーンと検索キャンペーンで使用して、AI によって生成されたテキスト アセットをプログラムで制御できます。text_guidelines 内で、term_exclusions と messaging_restrictions を定義できます。 |
CampaignPrimaryStatusReason |
新しい列挙値 | FIXED_CPM 入札戦略を使用するキャンペーンの主なステータスの理由を提供するために、CAMPAIGN_NOT_BOOKED、BOOKING_HOLD_EXPIRING、BOOKING_HOLD_EXPIRED、BOOKING_CANCELLED を追加しました。 |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
新しいフィールド | 純広告カテゴリの自己開示と読み取り専用の予約詳細のサポートを追加しました。 |
Campaign.missing_eu_political_advertising_declaration |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。 |
| コンバージョン数 | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
新しい列挙値 | 広告を視聴した後に同じチャンネルの動画を視聴したユーザーのトラッキングをサポートします。 |
| 全般 | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
新しい列挙値 / エラー | ユーザー属性ディメンションで不明なカテゴリのみをターゲットにしようとした場合に返されます。 |
| インセンティブ | ||
IncentiveErrorEnum |
新しい列挙値 / エラー | 2 つの新しいエラーコード（MAX_INCENTIVES_REDEEMED と ACCOUNT_TOO_OLD）を追加しました。これらのエラーは、2026 年 3 月 11 日以降に行われたリクエストに対して返される可能性があります。 |
| 計画 | ||
GenerateBenchmarksMetrics |
新機能 | BreakdownDefinition を使用した日付の内訳のサポートを追加しました。 |
ReachPlanService.GenerateReachForecast |
新しい列挙値 | デマンド ジェネレーションの「コンバージョン数の最大化」で、GOOGLE_DISPLAY_NETWORK をターゲットに設定できるサーフェスとして追加しました。 |
GenerateTrendingInsights |
新しいフィールド | トピックで検索したときに、TrendInsightDataPoint の過去のトレンドライン情報を TrendInsights に追加しました。 |
| レポート | ||
| ユニーク ユーザーのフリークエンシー指標 | 新しいフィールド | 広告を 2 回以上、3 回以上、4 回以上、5 回以上、10 回以上見たユーザーの数をレポートする新しい指標（unique_users_two_plus、unique_users_three_plus、unique_users_four_plus、unique_users_five_plus、unique_users_ten_plus）を追加しました。 |
SearchTermMatchSource |
新しい列挙値 | VERTICAL_ADS_DATA_FEED を追加して、旅行広告のエンティティ ターゲティングなどの業種別広告データフィードをサポートしました。 |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
新しいサービス / リソース | YouTube での動画のアップロードと管理をサポートする YouTubeVideoUpload サービスと、アップロード ステータスとメタデータの取得をサポートする YouTubeVideoUpload リソースを追加しました。この機能は、REST と Python クライアント ライブラリでのみサポートされています。 |
v23（2026 年 1 月 28 日）
Google Ads API v23（メジャー リリース）では、次の新機能、アップデート、互換性を損なう変更が追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
破壊的変更
| 初期状態 | 新しい状態 | 変更タイプ | 導入に関するアドバイス |
|---|---|---|---|
| 広告 | |||
| 広告の共有が許可されている | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
行動の変化 | 複数の広告グループ間での広告の共有は許可されなくなりました。広告を共有しようとするリクエストは、AD_SHARING_NOT_ALLOWED エラーを返します。 |
CallAd と CallAdInfo のサポート |
なし | 削除 | 電話専用広告のサポートが終了しました。電話専用広告についてのヘルプセンター記事を参照してください。 |
| キャンペーン | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
名前の変更 / 交換 | 新しい日時フィールドを使用して、キャンペーンの時間コンポーネントを指定します。元の日付専用フィールドは削除されます。 |
| デマンド ジェネレーション | |||
DemandGenMultiAssetAdInfo.lead_form_only |
なし | 削除 | lead_form_only フィールドが削除されました。コード内の参照を更新します。 |
| レポート | |||
| アセットのパフォーマンス ラベルの指標と列挙型を集計する | なし | 削除 | アセットのパフォーマンス ラベルの集計指標を削除しました。検索とディスプレイでパフォーマンス ラベルの列挙型が返されなくなりました。 |
機能とアップデート（非破壊的）
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 広告 | ||
AdFormatType |
新しい列挙値 | 新しい形式タイプ TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION を追加しました。 |
| アセット | ||
asset_group 回視聴 |
新しいフィールド | 指標として metrics.engagements、metrics.engagement_rate、metrics.average_cpe を追加しました。 |
asset_group_asset 回視聴 |
新しいフィールド | 指標として metrics.average_cpe、metrics.average_cpm、metrics.trueview_average_cpv、metrics.video_trueview_view_rate、metrics.video_trueview_views、metrics.interaction_event_types を追加しました。 |
Asset.orientation |
新しいフィールド | 画像アセットと動画アセットに読み取り専用の向きフィールドが追加されました。 |
CampaignAsset |
新機能 | field_type が HEADLINE と DESCRIPTION に設定されているキャンペーン アセットを取得するサポートを追加しました。 |
ServedAssetFieldType |
新しい列挙値 | サイトリンクとして配信されるアセットに HEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO を追加しました。 |
BusinessMessageAsset |
新機能 / サポート | 更新されたビジネス メッセージ アセット:
|
| 課金 | ||
InvoiceService.ListInvoices |
新しいオプション | ListInvoicesRequest で include_granular_level_invoice_details を設定すると、Invoice でより詳細な情報を取得できるようになりました。たとえば、キャンペーン単位の費用の内訳、規制費用の明細、調整情報などです。 |
RegulatoryFeeType UnitOfMeasure |
新しい列挙型 | 規制手数料と測定単位のヘルパー列挙型を追加しました。 |
| キャンペーン | ||
CampaignError |
新しい列挙値 / エラー | DURATION_TOO_LONG_FOR_TOTAL_BUDGET エラーコードと END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET エラーコードを追加しました。 |
| コンバージョン数 | ||
| ConversionActionCategory | 新しい列挙値 | 広告を視聴した後に同じチャンネルの動画を視聴したユーザーをトラッキングするための YOUTUBE_FOLLOW_ON_VIEWS を追加しました。 |
| デマンド ジェネレーション | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
新しいフィールド | デマンド ジェネレーションのレスポンシブ動画広告でコンパニオン バナーがサポートされるようになりました。 |
| インセンティブ | ||
Choose Your Own（CYO）インセンティブのサポートを追加しました。
障害のより詳細なプログラマティック処理を容易にするため、今後のリリースで |
||
| 計画 | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
新しい列挙値 | GenerateAudienceCompositionInsights、GenerateSuggestedTargetingInsights、GenerateInsightsFinderReport、GenerateCreatorInsights のライフイベントを使用してオーディエンスを作成できます。ライフサイクル イベントは、 |
ReachPlanService.GenerateConversionRates |
新しいフィールド / オプション | レスポンスに、サーフェス コントロール（Gmail、ショート動画など）に基づいてコンバージョン率の提案をサポートするサーフェスが含まれるようになりました。デマンド ジェネレーション キャンペーンでのみサポートされています。 |
LanguageDistribution |
新しいフィールド / タイプ | YouTube チャンネルのコンテンツの言語分布の詳細を提供するために、YouTubeChannelInsights に追加されました。 |
BenchmarksService |
新しいサービス | YouTube 広告のデータを業界のベンチマークと比較します。 |
AudienceInsightsService.GenerateAudienceDefinition |
新しいメソッド | 生成 AI を使用して、ターゲット ユーザーの自由形式の説明を一致するオーディエンス属性に変換します。 |
YouTubeChannelInsights.relevance_score |
新しいフィールド | 視聴回数で重み付けされたトピックに対するクリエイターの関連性を評価します。 |
TrendInsightMetrics.trend_change_percent |
新しいフィールド | 比較期間におけるトレンドの値の変化率を表します。 |
| 推奨事項 | ||
GenerateRecommendationsRequest |
新しいフィールド | is_new_customer を追加しました。CAMPAIGN_BUDGET の最適化案で true に設定すると、新規顧客向けに最適化されたモデルが使用されます（キャンペーンがないお客様にのみ推奨）。 |
| レポート | ||
AdGroupAdAssetView |
新機能 / 指標のサポート | RESPONSIVE_DISPLAY_AD のインプレッション数、パフォーマンス、コンバージョン数の指標をサポートしました。 |
ad_sub_network_type セグメント |
新しいセグメント | 広告ネットワーク内のパフォーマンスを詳細に分類します。最初は YouTube のデマンド ジェネレーション キャンペーン（インストリーム、インフィード、ショート動画）で利用できます。ad_network_type とともに選択する必要があります。 |
| P-MAX のレポート | 新機能 | P-MAX キャンペーンで有効になっている広告ネットワークのタイプの内訳。 |
UserLocationView GeographicView |
新しいセグメントのサポート | コンバージョン日別に分類された指標（conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date、cross_device_conversions_by_conversion_date、cross_device_conversions_value_by_conversion_date）をサポート。 |
| 縦型広告セグメント | 新しいセグメント | セグメントとして vertical_ads_event_participant_display_names、vertical_ads_hotel_class、vertical_ads_listing、vertical_ads_listing_brand、vertical_ads_listing_city、vertical_ads_listing_country、vertical_ads_listing_region、vertical_ads_partner_account、vertical_ads_vertical を追加しました。 |
PerStoreView MatchedLocationInterestView |
新しいレポート リソース | 店舗の所在地に関する詳細情報を取得する PerStoreView と、関心対象地域別のパフォーマンス指標を取得する MatchedLocationInterestView（AI 最大化設定キャンペーンの場合）を追加しました。 |
| ショッピング | ||
ShoppingPerformanceView |
新しい指標のサポート | コンバージョン日別にセグメント化された指標（conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date）がサポートされるようになりました。 |
ShoppingPerformanceView |
新しい指標のサポート | search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share、search_rank_lost_absolute_top_impression_share のサポートを追加しました。 |
ShoppingProduct.product_image_uri |
新しいフィールド | ShoppingProductに追加しました。 |
| 縦向き広告 | ||
AdGroup.vertical_ads_format_setting |
新しいフィールド | 旅行フィードを使用する検索キャンペーンで配信できる広告フォーマットを制御できます。 |
AdGroupCriterion SharedCriterion |
新しいフィールド / 条件 | AdGroupCriterion に vertical_ads_item_group_rule_list 条件タイプを追加し、SharedCriterion に vertical_ads_item_group_rule を追加して、旅行フィードを使用する検索キャンペーンでアイテム グループをターゲットに設定できるようにしました。 |
| 縦長広告のデータフィード統合 | 新機能 | AI 最大化設定で実行されている検索キャンペーンに業種別広告のデータフィードを接続して、テキスト広告とともに物件プロモーション広告と予約リンクの旅行広告を表示できるようになりました。vertical_ads_format_setting で形式を制御し、vertical_ads_item_group_rule を使用してルールを定義します。AdFormatType と業種別広告データフィードのディメンションでレポートを分割します。 |
| 動画 | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
新しいフィールド | 動画広告アセットの機能制御オプションを追加しました。 |
CampaignCriterionError |
新しい列挙値 / エラー | エラーコード INVALID_VIDEO_LINEUP_ID を追加しました。 |
| YouTube の音声指標 | 新しい指標 | YouTube のオーディオ広告の聴取可能性に関する指標を追加しました。広告が聴取可能だったかどうかと、聴取可能性を測定できたインプレッション数をレポートします。 |
v22 のメジャー バージョンとマイナー バージョン
Google Ads API v22 には、以下の新機能、更新、互換性を損なう変更が含まれています。
v22.2（2026 年 6 月 24 日）
Google Ads API v22.2 では、以下の新機能とアップデートが追加されました。v22.2 などのマイナー バージョンには、互換性を破る変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 全般 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
新しいフィールド | 合成コンテンツ/AI 生成コンテンツの証明を含みます。advertiser_attestation（広告主が直接提供した宣言）と system_attestation（Google のシステムが自動的に検出または提供した証明）に分かれています。v25 での今後の統合作業の計画に役立つよう、広告主様の証明書フィールドを変更するためのインターフェースが v22 以降で早期に導入されます。これらのバージョンではインターフェースは表示されますが、 これらのフィールドのいずれかで変更リクエストを試みると、次のいずれかのエラーが返されます。 「The field attempted to be mutated is immutable」または「Field cannot be set」。 これらのフィールドは、v25 以降で完全に変更可能になります。v25 のリリース時にシステムが完全な書き込み機能に対応できるように、今すぐインターフェースを使用して内部ロジックを構築し、テストすることをおすすめします。 |
| 複数の関係者による承認 | 新機能 |
マルチパーティ承認（MPA）の審査のサポートを追加しました。
|
v22.1（2026 年 2 月 25 日）
Google Ads API v22.1 では、次の新機能が追加されました。v22.1 などのマイナー バージョンには、互換性を破る変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| アカウント管理 | ||
Customer.contains_eu_political_advertising |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatus を返します。 |
| キャンペーン | ||
Campaign.missing_eu_political_advertising_declaration |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。 |
v22（2025-10-15）
Google Ads API v22（メジャー リリース）では、次の新機能、アップデート、互換性を破る変更が追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
破壊的変更
| 初期状態 | 新しい状態 | 変更タイプ | 導入に関するアドバイス |
|---|---|---|---|
| デマンド ジェネレーション | |||
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros |
minimum_budget_amount_micros |
名前の変更 / スペルの修正 | 修正されたフィールド名を使用するように参照の名前を変更します。 |
| 全般 | |||
AddBatchJobOperations のオペレーションの上限なし |
リクエストあたりのオペレーション数の上限: 10,000 | 行動の変化 | 1 つの AddBatchJobOperations リクエストに 10,000 を超えるオペレーションが含まれないようにします。 |
ListBatchJobResultsRequest でページサイズを 1,000 に自動的に制限 |
INVALID_PAGE_SIZE エラーを返します |
行動の変化 | ListBatchJobResultsRequest.page_size が 1,000 以下に設定されていることを確認してください。これより大きいページサイズをリクエストすると、エラーが発生します。 |
| P-MAX | |||
| アセットのパフォーマンス ラベル | なし | 削除 | P-MAX キャンペーンでは、アセットのパフォーマンス ラベルのサポートと関連するパフォーマンス ラベルの列挙型が削除されました。統合を適宜更新します。 |
Campaign.url_expansion_opt_out |
AssetAutomationSetting の FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION フラグ |
取り外し / 交換 | 最終ページ URL の拡張のテキスト アセットの自動化設定を使用します。キャンペーン単位の URL 拡張のオプトアウト フィールドが削除されます。 |
| 計画 | |||
views |
trueview_views |
取り外し / 交換 | views への参照を ReachPlanService の新しい trueview_views フィールドに置き換えます。 |
| 動画 | |||
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts |
trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts |
名前の変更 | TrueView 動画視聴回数を表す新しい指標名を使用するように、クエリ文字列と統合を更新します。 |
機能とアップデート（非破壊的）
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| アセット | ||
AssetFieldType.LANDING_PAGE_PREVIEW |
新しい列挙値 | 新しい画像アセット フィールド タイプとして追加されました。 |
AssetGenerationService |
新しいサービス（ベータ版） | 生成 AI を使用してテキスト アセットと画像アセットを生成できます。
|
| キャンペーン | ||
AppCampaignBiddingStrategyGoalType |
新しい列挙値 | アプリ インストール キャンペーン（ACi）の新しい目標を追加しました。目標を指定せずに最適化できます。
|
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 のアセットの自動化に関する新しいオプションを追加しました。
|
| P-MAX のレポート セグメント | 新しいセグメント | P-MAX キャンペーンに固有の新しいセグメントを追加しました。
|
| 計画 | ||
| CRM パートナー データリスト | 新機能 / 列挙値 | CRM データソースに THIRD_PARTY_PARTNER_DATA を追加しました。また、パートナー オーディエンスの検証エラーコード（利用規約への同意、リンクがないなど）も追加しました。 |
| ライブ配信のクリエイター指標 | 新しいフィールド | YouTubeMetrics.is_active_live_stream_creator を追加しました。これは、クリエイターが過去 90 日間にライブ配信を公開したかどうかを示すためにクリエイター分析によって返されます。 |
| プランニング可能な CRM ソースのメタデータ | 新着メッセージ | ReachPlanService.ListPlannableUserLists によって返される PlannableUserList 内に PlannableUserListMetadata を追加し、CRM データソースのタイプを表示するようにしました。 |
| TrendInsight で関連動画とクリエイターをサポート | 新しいフィールド | TrendInsight で related_videos と related_creators のサポートを追加し、video_properties と publish_date でプロパティを監視します。 |
| InsightsFinder の改善 | 新機能 | GenerateInsightsFinderReport が parental_status、income_ranges、より複雑な AND/OR ターゲティングの組み合わせをサポートするようになりました。 |
| レポート | ||
| 新しいクリックタイプ | 新しい列挙値 | CLICK_TO_MESSAGE_THIRD_PARTY_CLICK と CLICK_TO_MESSAGE_LANDING_PAGE_CLICK を追加しました。 |
| AssetGroupAsset のセグメンテーション | 新しいセグメントのサポート | AssetGroupAsset は、device、conversion_action、conversion_action_name、conversion_action_category でセグメント化できるようになりました。 |
| AdGroupAdAssetView のレスポンシブ検索広告 | 新機能 / 指標のサポート | AdGroupAdAssetView が RESPONSIVE_SEARCH_AD のパフォーマンスとコンバージョンの指標を完全にサポートするようになりました（以前はインプレッション数のみが返されていました）。 |
| 探索クエリのクラスタ指標のセグメンテーション | 新しいセグメントのサポート | 指標 clicks_unique_query_clusters、conversions_unique_query_clusters、impressions_unique_query_clusters を日付フィールドでセグメント化できるようになりました。 |
| TargetingExpansionView | 新しいレポート リソース | TargetingExpansionView を追加して、検索キャンペーン向け AI 最大化設定のキーワードレスの拡張など、手動ターゲティングの拡張に関するレポート指標を表示できるようになりました。 |
| ショッピング | ||
| ショッピングのスコープの修正 | バグの修正 | ShoppingProduct リソースの指標のキャンペーンと広告グループのスコープ設定を修正しました。 |
| 統合された目標 | ||
| 「ユーザー維持」目標 | 新機能 | 既存顧客の再エンゲージメントを重視して最適化するための顧客維持目標のサポートを追加しました（例: TARGET_SPECIFIC または TARGET_ALL で target_option を使用）。 |
| 動画 | ||
| 動画の総再生時間に関する指標 | 新しいフィールド | 総再生時間（video_watch_time_duration_millis）とインプレッションあたりの平均再生時間（average_video_watch_time_duration_millis）の指標を追加しました。 |
v21 のメジャー バージョンとマイナー バージョン
Google Ads API v21 には、次の新機能、更新、重大な変更が含まれています。
v21.2（2026 年 6 月 24 日）
Google Ads API v21.2 では、以下の新機能とアップデートが追加されました。v21.2 などのマイナー バージョンには、互換性を損なう変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 全般 | ||
| 複数の関係者による承認 | 新機能 |
マルチパーティ承認（MPA）の審査のサポートを追加しました。
|
v21.1（2026 年 2 月 25 日）
Google Ads API v21.1 では、以下の新機能とアップデートが追加されました。v21.1 などのマイナー バージョンには、互換性を損なう変更は含まれていません。
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| アカウント管理 | ||
Customer.contains_eu_political_advertising |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかのアカウント単位の申告ステータスを取得し、EuPoliticalAdvertisingStatusEnum を返します。 |
| キャンペーン | ||
Campaign.missing_eu_political_advertising_declaration |
新しいフィールド | EU を対象とした政治広告が含まれているかどうかについての申告がないキャンペーンのクエリとフィルタリングをサポートします。 |
v21（2025-08-06）
Google Ads API v21（メジャー リリース）では、次の新機能、アップデート、重大な変更が追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
破壊的変更
| 初期状態 | 新しい状態 | 変更タイプ | 導入に関するアドバイス |
|---|---|---|---|
| キャンペーン | |||
CriterionError.INVALID_LISTING_GROUP_HIERARCHY を返します |
CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION を返します |
エラーコードの変更 | 部分的な失敗が有効になっているリクエストの場合は、元の階層エラーコードではなく、新しいエラーコードを処理します。 |
| コンバージョン数 | |||
ConversionUploadService での debug_enabled モードへのアクセス |
なし | 削除 | debug_enabled フィールドが削除されます。このパラメータを設定またはクエリしないように、このパラメータを参照するコードを更新します。 |
| EU の政治広告に関する変更 | |||
| EU の政治広告に関するキャンペーンの自己申告（任意） | 新しいキャンペーンの必須の contains_eu_political_advertising フィールド |
検証ルール / 動作の変更 | このフィールドが設定されていない場合、新しいキャンペーンを作成する API 呼び出しは FieldError.REQUIRED エラーで失敗します。2025 年 9 月 22 日以降、CONTAINS_EU_POLITICAL_ADVERTISING と申告されたキャンペーンは EU で配信されなくなります。 |
| 自己申告なしで変更可能な条件 | CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION で更新が失敗する |
検証ルール / 動作の変更 | 既存のキャンペーンのキャンペーン単位または広告グループ単位の近接地域、地域、地域グループのターゲティング条件を作成または更新する前に、自己申告ステータスを設定します。 |
| 自己申告の要件がないテスト | ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION で更新が失敗する |
検証ルール / 動作の変更 | テストのキャンペーンで自己申告が完了していることを確認します。 |
| P-MAX | |||
brand_guidelines_enabled のデフォルトは false です |
デフォルトは true です |
行動の変化 | 新しい P-MAX キャンペーンでは、ブランド ガイドラインはデフォルトで有効になっています。無効にする場合は、フィールドを明示的に false に設定します。 |
| 計画 | |||
AudienceInsightsService.GenerateTargetingSuggestionMetrics の元の入力引数の型 |
InsightsAudience 型の入力 |
型の変更 | 実装を更新して、ユーザーの興味 / 関心の OR の AND の組み合わせをサポートする新しい入力タイプを渡します。これにより、カスタム オーディエンス定義のリーチ指標の可能性が許可されます。 |
機能とアップデート（非破壊的）
| 機能とアップデート | タイプ | 説明 |
|---|---|---|
| 検索キャンペーン向け AI 最大化設定 | ||
Campaign の ai_max_setting.enable_ai_max |
新しいフィールド | AI 最大化設定で検索語句とのマッチングを拡大できます（以前のテキスト アセットの自動作成とブランドリストは、無効にするまで維持されます）。フィールド Campaign.ai_max_setting.bundling_required は、これらの設定を尊重または変更するために AI 最大化設定を有効にする必要があるかどうかを示します。また、AdGroup.ai_max_ad_group_setting.disable_search_term_matching は、広告グループ単位でマッチングを無効にできます。検索キャンペーン向け AI 最大化設定でパフォーマンスを飛躍的に高めるをご覧ください。 |
CampaignError.AI_MAX_MUST_BE_ENABLED |
新しい列挙値 / エラー | AI 最大化設定を有効にせずに、検索キャンペーンで URL 拡張テキスト アセットの自動作成を有効にしようとした場合にスローされます。 |
| 広告グループ単位のターゲティング | 新機能 | 検索キャンペーン向け AI 最大化設定で、広告グループ単位のブランド リスト、地域、ウェブページ（URL ルール）がサポートされるようになりました。 |
ai_max_search_term_ad_combination_view |
新しいレポート リソース | 検索語句、広告見出し、ランディング ページの組み合わせのパフォーマンスをレポートします。 |
search_term_match_type セグメント |
新しい列挙値 | 検索語句のマッチタイプのオプションとして AI_MAX を追加しました。 |
| アセット | ||
PromotionAsset |
新しいフィールド | terms_and_conditions_text、terms_and_conditions_uri、oneof promotion_trigger オプション（promotion_barcode_info、promotion_qr_code_info）を追加しました。プロモーション アセットについてをご覧ください。 |
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION |
新しい列挙値 | 検索キャンペーンの最終ページ URL からの自動テキストとランディング ページの生成を制御するために AssetAutomationType に追加されました。 |
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset |
新しいサービス / メソッド | 自動作成された最終ページ URL の拡張アセットをキャンペーンから削除できます。 |
ServedAssetFieldType.DESCRIPTION_PREFIX |
新しい列挙値 | ad_group_ad_asset_combination_view で型が UNKNOWN として返されるレポートの問題を修正するために追加されました。 |
| キャンペーン | ||
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING |
新しい列挙値 | 地域制限付きキャンペーンに地域ターゲティングがない場合に返されます（許可された地域外をターゲットに設定すると、LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN がスローされます）。 |
| サードパーティ製アプリ解析との連携 | 新しいフィールド | VideoCustomer.third_party_integration_partners と Campaign.third_party_integration_partners のサポートを追加しました。サードパーティ製アプリ解析を使ってアプリ コンバージョンをトラッキングするをご覧ください。 |
Campaign.advertising_partner_ids |
新しいフィールドのサポート | このフィールドは既存のキャンペーンに設定できるようになりました（設定後は変更できません）。 |
| クライアント センター（MCC）アカウント単位の除外プレースメント | 新機能 | CustomerNegativeCriterion を使用して、個々の広告主アカウントでプレースメント リストを除外できます。 |
| 目標広告費用対効果戦略の許容範囲の設定 | 新しいフィールド | MaximizeConversionValue と TargetRoas で TargetRoas.target_roas_tolerance_percent_millis（検索キャンペーンのポートフォリオ戦略用）のサポートを追加しました。 |
LocationInterestView |
新しいレポート リソース | 広告グループの地域関心条件のパフォーマンスを要約します。 |
| コンバージョン数 | ||
conversion_attribution_event_type セグメント |
新しい列挙値 | コンバージョン アトリビューション タイプのオプションに ENGAGED_VIEW を追加しました。 |
| デマンド ジェネレーション | ||
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM |
新しい列挙値 / エラー | デマンド ジェネレーション キャンペーンの 1 日の最低予算額の適用に備えて追加されました。詳細は budgetDailyMinimumErrorDetails を使用して公開されます。 |
| P-MAX | ||
campaign_search_term_view |
新しいレポート リソース | 検索語句の指標をキャンペーン単位で集計し、P-MAX の検索語句の分析とレポート作成を可能にします。 |
| 計画 | ||
ReachPlanService.ListPlannableUserInterests |
新しいメソッド | generateReachForecast のプラン可能なアフィニティと購買意向の強いインタレストを検出できます。 |
AdditionalApplicationInfo |
新しいフィールド | ReachPlanService.ListPlannableUserLists のオプション入力として追加されました。 |
| AudienceInsights 属性のリスト | 新機能 | AudienceInsightsService.ListAudienceInsightsAttributes で、利用可能な 1P ユーザーリストが取得されるようになりました。 |
| AudienceCompositionInsights で CRM リストをターゲットに設定する | 新機能 | AudienceInsightsService.GenerateAudienceCompositionInsights で、AudienceInsightsDimension ディメンション（AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST）のユーザーリスト インデックスの詳細が返されるようになりました。 |
TrendInsightMetrics 視聴者の占有率 |
新しいフィールド | トレンドのオーディエンスの割合を表します。 |
KnowledgeGraphAttributeMetadata カテゴリ |
新しいフィールド | 一致するカテゴリでナレッジグラフの属性をフィルタします。 |
| レポート | ||
| アセットビューの指標 | 新機能 / 指標 | AssetGroupAsset、ChannelAggregateAssetView、CampaignAggregateAssetView に複数の新しい指標を追加しました。また、P-MAX キャンペーンで impressions の実際の値がレポートされるようになりました。 |
| セレクタ拡張機能 | 新機能 | ChangeStatus 内で AssetSet と CampaignAssetSet を一緒にクエリできるようにしました。 |
search_term_targeting_status |
新しいセグメント | キャンペーンの検索語句ビューで選択可能なセグメント。 |
final_url_expansion_asset_view |
新しいレポート リソース | 最終ページ URL の拡張アセットのパフォーマンスの詳細をレポートします。 |
| AssetGroup の値の調整 | 新しいフィールド | AssetGroup レポートで value_adjustment 指標と all_value_adjustment 指標がサポートされるようになりました。 |
landing_page_source |
新しいセグメント | landing_page_view でランディング ページのソース セグメントを提供します。 |
search_term_match_source |
新しいセグメント | 検索語句ビューとキャンペーン検索語句ビューで選択可能なセグメント。 |
match_type |
新しいセグメント | キーワード ビューで選択可能なセグメントキー。 |
| 固有の検索語句の意図クラスタ レポート | 新しいフィールド | 一意のクエリ インテント クラスタをレポートするために、clicks_unique_query_clusters、conversions_unique_query_clusters、impressions_unique_query_clusters を追加しました。 |
ClickType.VEHICLE_ASSETS |
新しい列挙値 | click_view レポートで、車両広告フォーマットに固有のクリック数をトラッキングしてレポートします。 |
| スマート自動入札の入札範囲拡大機能 | ||
| 検索戦略の許容範囲の設定 | 新しいフィールド / 設定 | target_roas_tolerance_percent_millis を 10,000（10%）から 30,000（30%）の範囲で設定することで、検索キャンペーンでスマート自動入札の入札範囲拡大機能を有効にできます（コンバージョン数の最大化には target_roas の設定が必要です）。詳しくは、スマート自動入札の入札範囲拡大機能に関するブログ投稿と、ヘルプセンターの記事をご覧ください。 |
| 多様性レポートの互換性 | 新機能 | ユニークなクエリ インテント クラスタの次の指標で、集計された多様性レポートがサポートされるようになりました。Google 広告の管理画面で、期間でセグメント化したビューを利用できます。
|
| 動画 | ||
YouTubeVideoListAsset |
新しいリソース / フィールド | Asset.youtube_video_list_asset を使用して、キャンペーンと動画リスト アセット間のリンクを確立できます。関連動画を使用するをご覧ください。 |
| 分析情報のメタデータ拡張機能 | 新しいフィールド | YouTubeChannelInsights と YouTubeVideoAttributeMetadata に新しいメタデータを追加しました。 |
| インタラクティブ クリックタイプ | 新しい列挙値 | クリックタイプ VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK、PRODUCT_ASSETS を追加しました。 |
VideoAdInventoryControl.allow_non_skippable_in_stream |
新しいフィールド | スキップ可能なフォーマットとスキップ不可のフォーマットを組み合わせたキャンペーンで、レスポンシブ動画広告をスキップ不可のインストリーム広告として配信できます。 |
| 動画シーケンスの設定 | 新しいフィールド | 読み取り専用のシーケンス設定 Campaign.VideoCampaignSettings.video_ad_sequence と VideoAdSequenceStepSetting を追加しました。動画広告シーケンスについてをご覧ください。 |
| 動画ラインナップ ターゲティング | 新しい条件タイプ / フィールド | CampaignCriterion と AdGroupCriterion に VIDEO_LINEUP 条件タイプと対応するフィールドを追加しました。この機能は、許可リストに登録されたアカウントでのみご利用いただけます。 |
| コンテンツの適合性のプレースメントのビュー数 | 新しいレポート リソース | 詳細レベル（detail_content_suitability_placement_view）とグループ レベル（group_content_suitability_placement_view）の両方で、コンテンツの適合性レポートが追加されました。「コンテンツの適合性」レポートについてをご覧ください。 |
リリースノートのアーカイブ
アーカイブされたリリースノートについては、サポート終了バージョンをご覧ください。