Google Ads API のメジャー版 v25 が公開。破壊的変更を含む新機能とフィールド更新があり、既存クライアントは最新版へのアップグレード手順に沿った移行が必要。

破壊的変更の中心は目標まわりのスキーマ刷新。Legacy の CustomerLifecycleGoal / CampaignLifecycleGoal とそのサービス、旧設定・列挙は削除され、Goal リソースの new_customer_acquisition_goal_settings と CampaignGoalConfig の campaign_new_customer_acquisition_settings へ寄せる。Incentive Service では入れ子だった type がスタンドアロン列挙へ変わり、ApplyIncentiveRequestselected_incentive_idcustomer_id は必須。Planning では GenerateCreatorInsightsRequest.search_brand の削除や reach forecast の plannable_location_id / cookie_frequency_cap からの移行、レポートの customer_metrics 型変更など。

非破壊の追加・更新:

  • Loyalty Retention Goal のサポート
  • YouTube 向けサードパーティ conversion attribution の顧客/キャンペーン設定
  • Asset.synthetic_content_info / Ad.synthetic_content_info の完全 mutable 化(v25 に加え v24・v23 にも適用)
  • Demand Gen 向け GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS、動画向け social metrics、ad_sub_format_type セグメントなど

#参考文献