یادداشت های انتشار

برای مشاهده‌ی فهرست به‌روز شده‌ی ویژگی‌های منسوخ‌شده‌ی فعلی و برنامه‌ریزی‌شده، به بخش منسوخ‌شده‌ها مراجعه کنید.

نسخه‌های اصلی و فرعی v25

نسخه ۲۵ رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) شامل ویژگی‌ها، به‌روزرسانی‌ها و تغییرات اساسی زیر است.

نسخه ۲۵.۱ (۲۰۲۶-۰۸-۱۹)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۵.۱ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۵.۱ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
دارایی‌ها
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	مقادیر شمارشی جدید	پشتیبانی از فایل‌های سلب مسئولیت متنی اضافه شد.
کمپین‌ها
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	فیلدهای جدید	مهاجرت خودکار آتی به AI Max را پیگیری کنید.
تبدیل‌ها
اندازه گیری های برند لیفت	ویژگی‌های جدید	پشتیبانی از اندازه‌گیری‌های Brand Lift با به‌روزرسانی‌های زیر اضافه شد: منابع ابعادی فقط خواندنی جدید برای نتایج مطالعه لیفت اضافه شد: LiftMeasurementAgeRange ، LiftMeasurementCampaign ، LiftMeasurementDevice ، LiftMeasurementGender و LiftMeasurementVideo . بخش‌ها و معیارهای جدیدی برای پشتیبانی از تحلیل Brand Lift با LiftMeasurementConfig و منابع ابعادی جدید اضافه شد. enumهای زیر اضافه شده‌اند: BrandLiftMeasurementType ، LiftMeasurementFlightStatus ، SurveyIntendedAction ، SurveyLiftFlightTargetResponseMode و SurveySubjectType .
اندازه‌گیری‌های لیفت تبدیلی	ویژگی‌های جدید	پشتیبانی از اندازه‌گیری‌های Conversion Lift با به‌روزرسانی‌های زیر اضافه شد: یک منبع فقط خواندنی جدید LiftMeasurementConfig اضافه شد که نشان‌دهنده‌ی مطالعه‌ی لیفت است. بخش‌های قابل انتخاب جدیدی به بخش‌بندی و فیلتر کردن نتایج لیفت اضافه شد. ۲۴ معیار جدید Conversion Lift و معیارهای امتیاز برنده اضافه شده است که از تجزیه و تحلیل آماری دقیق عملکرد Lift پشتیبانی می‌کنند. پشتیبانی برای بازیابی جزئیات کمپین و اهداف تبدیل اضافه شد. یک فیلد اختیاری جدید به نام Experiment.lift_measurement_config اضافه شد. شمارشگر ConversionLiftIncludedConversionActionTypes اضافه شد.
LiftMeasurementFlight	منبع جدید	یک منبع فقط خواندنی جدید که جزئیات پرواز را برای پیکربندی اندازه‌گیری لیفت، از جمله تاریخ‌های شروع و پایان اندازه‌گیری شده پرواز ( start_date و end_date ) نشان می‌دهد.
عمومی
SmartCampaignError	مقادیر شمارشی جدید	کدهای خطای خاص جدیدی برای محدودیت‌های تولید Performance 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	مقدار / خطای شمارشی جدید	زمانی برمی‌گردد که یک پروژه Google Cloud با سطح دسترسی TEST تلاش می‌کند درخواست‌هایی را علیه یک حساب کاربری غیرتست ارسال کند.
برنامه‌ریزی
بینش‌های مربوط به احساسات برند	ویژگی‌های جدید	پشتیبانی از بینش‌های مربوط به احساسات برند در ContentCreatorInsightsService اضافه شد: پیام‌های BrandSentimentInsight ، SentimentInsightDistribution و SentimentInsightSummary اضافه شد. Sentiment enum) اضافه شد. مقدار BRAND_SENTIMENT_DATA به شمارشگر ContentCreatorInsightsSupplementalData اضافه شد. مقدار BRAND به enum مربوط به InsightsKnowledgeGraphEntityCapabilities اضافه شد.
بهبودهای BenchmarksService	ویژگی‌های جدید	پشتیبانی از دسته‌ها به عنوان فیلتر برای تعیین محدوده تحلیل معیارها اضافه شد. همچنین از معیارهای حیاتی تجاری بیشتری پشتیبانی می‌شود: گزینه‌ای برای مقایسه با همه تبلیغ‌کنندگانی که تبلیغات را در یک یا چند دسته محصول و خدمات اجرا می‌کنند، با استفاده BenchmarksService.GenerateBenchmarksMetrics و category_filter اضافه شده است. معیارهای بیشتری برای تبلیغات مشتری مانند هزینه کل مشتری، تعداد بازدیدها و غیره و معیارهای اشتراک‌گذاری مانند share_of_voice ارائه شده است. معیارها با استفاده از AggregateMetrics و ShareMetrics بازگردانده می‌شوند. فهرست دسته‌بندی‌های پشتیبانی‌شده را می‌توان با استفاده از BenchmarksService.ListBenchmarksSources با نوع منبع CATEGORY بازیابی کرد.
هدف‌گیری وضعیت والدین	ویژگی جدید	پشتیبانی از هدف‌گیری وضعیت والدین در برنامه‌ریزی دسترسی اضافه شده است. فیلد جدید parental_statuses برای سرویس ReachPlanService.GenerateReachForecast به Targeting اضافه شده است و parental_statuses برای سرویس ReachPlanService.ListPlannableProducts به PlannableTargeting اضافه شده است.
توصیه‌ها
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 اضافه شد.

نسخه ۲۵ (۲۰۲۶-۰۷-۲۲)

ویژگی‌های جدید، به‌روزرسانی‌ها و تغییرات اساسی زیر در Google Ads API v25 اضافه شده‌اند که یک نسخه اصلی محسوب می‌شود.

برای راهنمایی به بخش ارتقا به آخرین نسخه مراجعه کنید.

شکستن تغییرات

حالت اولیه	ایالت جدید	نوع تغییر	راهنمای پیاده‌سازی
کمپین‌ها
فیلدهای مستقل additional_value و additional_high_lifetime_value در CustomerLifecycleOptimizationValueSettings	به ترتیب بخشی از value_adjustment و high_lifetime_value_adjustment ، در کنار فیلدهای جدید value_multiplier و high_lifetime_value_multiplier	تغییر ساختاری	ارجاعات به این فیلدها را به‌روزرسانی کنید، زیرا اکنون بخشی از oneofs هستند.
منابع قدیمی CustomerLifecycleGoal و CampaignLifecycleGoal ، سرویس‌های متناظر آنها CustomerLifecycleGoalService و CampaignLifecycleGoalService ، و تنظیمات/enumهای قدیمی ( CustomerAcquisitionGoalSettings ، CustomerAcquisitionOptimizationModeEnum ، LifecycleGoalValueSettings )	هیچکدام	حذف	از طرحواره اهداف یکپارچه اصلاح‌شده استفاده کنید: از فیلد new_customer_acquisition_goal_settings در منبع Goal استفاده کنید. از فیلد campaign_new_customer_acquisition_settings در منبع CampaignGoalConfig برای پیکربندی لغوهای خاص کمپین استفاده کنید.
عمومی
فیلدهای شمارشی تو در تو در پیام‌های درخواست و پاسخ سرویس تشویقی: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	فیلدهای شمارشی مستقل: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	تغییر نام / حذف	به جای فیلدهای type قدیمی، از فیلدهای enum مستقل جدید استفاده کنید.
فیلدهای selected_incentive_id و customer_id اختیاری در ApplyIncentiveRequest	فیلدهای مورد نیاز	تغییر رفتاری	هنگام فراخوانی ApplyIncentive مطمئن شوید که هر دو فیلد را ارائه می‌دهید.
فیلد آدرس ایمیل مصرف‌کننده ContactDetails.email در منبع LocalServicesLead	هیچکدام	حذف	ارجاعات به این فیلد را حذف کنید زیرا دیگر پشتیبانی نمی‌شود.
فیلد اختیاری allowed_domain در AdvertisingPartnerLinkInvitationProperties	فیلدهای ضروری هنگام فراخوانی CreateProductLinkInvitation برای یک شریک تبلیغاتی	تغییر رفتاری	هنگام ایجاد دعوتنامه لینک محصول برای یک شریک تبلیغاتی، مطمئن شوید که allowed_domain را ارائه می‌دهید.
برنامه‌ریزی
فیلد search_brand در GenerateCreatorInsightsRequest	هیچکدام	حذف	به جای آن search_topics استفاده کنید.
فیلد plannable_location_id در Targeting و فیلد cookie_frequency_cap در GenerateReachForecastRequest	هیچکدام	حذف	به استفاده از plannable_location_ids و cookie_frequency_cap_setting تغییر دهید.
گزارش‌ها
فیلد customer_metrics در GenerateBenchmarksMetricsResponse و BreakdownMetrics از نوع Metrics	فیلد از نوع CustomerMetrics	تغییر نوع / تغییر رفتاری	ادغام‌های خود را به‌روزرسانی کنید تا از نوع جدید CustomerMetrics استفاده کنید، که فقط شامل معیارهایی است که عملکرد تبلیغ مشتری را نشان می‌دهند.

ویژگی‌ها و به‌روزرسانی‌ها (غیر قابل شکستن)

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
تبلیغات
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	مقدار/رفتار جدید enum	برای DemandGenMultiAssetAds موجود است. در صورت فعال بودن، با استفاده از تصاویر غیرمتحرک به عنوان ورودی، تصاویر متحرک تولید می‌کند. DemandGenMultiAssetAds جدید به طور پیش‌فرض از این نسخه API انتخاب می‌شوند.
تغییرپذیری اطلاعات محتوای مصنوعی	تغییر رفتار	Asset.synthetic_content_info و Ad.synthetic_content_info اکنون در نسخه‌های ۲۵، ۲۴ و ۲۳ کاملاً قابل تغییر هستند.
کمپین‌ها
هدف حفظ وفاداری	ویژگی‌ها/تنظیمات جدید	پشتیبانی از هدف حفظ وفاداری اضافه شد، که به تبلیغ‌کنندگان اجازه می‌دهد کمپین‌ها را برای حفظ اعضای برنامه وفاداری بهینه کنند. LOYALTY_RETENTION به شمارش GoalType اضافه شد. برای پیکربندی تنظیمات حفظ وفاداری مختص کمپین، از جمله تنظیمات پیشنهاد قیمت و نمایش مزایای اعضا در قالب PLA، CampaignGoalConfig.campaign_loyalty_retention_settings اضافه شد. برای پیکربندی تنظیمات هدف حفظ وفاداری در سطح حساب، Goal.loyalty_retention_goal_settings اضافه شد. کدهای خطای جدید اضافه شد: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
هدف جذب مشتری جدید	ویژگی‌ها/تنظیمات جدید	پشتیبانی از هدف جذب مشتری جدید در API گوگل ادز به‌روزرسانی شد تا طرحواره اهداف یکپارچه اصلاح‌شده را منعکس کند: منبع Goal را برای پشتیبانی از تنظیمات جذب مشتری جدید (New Customer Acquisition) با استفاده از فیلد new_customer_acquisition_goal_settings گسترش دادیم. منبع CampaignGoalConfig را گسترش دادیم تا از لغوهای مختص کمپین برای جذب مشتری جدید با استفاده از فیلد campaign_new_customer_acquisition_settings پشتیبانی کند. enum جدید CustomerLifecycleOptimizationGoalSubType برای تعریف زیرگروه‌های هدف پشتیبانی‌شده اضافه شد. NEW_CUSTOMER_ACQUISITION به GoalType enum اضافه شد. دلایل خطای اعتبارسنجی جدیدی به 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 ErrorDetails.incompatible_clo_goal_error_details برای نمایش ساختار جدید IncompatibleCloGoalsErrorDetails برای خطاهای اعتبارسنجی اضافه شد.
تبدیل‌ها
انتساب تبدیل شخص ثالث یوتیوب	فیلدهای جدید	پشتیبانی از تأیید انتساب تبدیل YouTube با استفاده از شرکای شخص ثالث اضافه شد: CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners اضافه شد تا امکان پیکربندی شرکای ادغام در سطح مشتری فراهم شود. برای پیکربندی شرکای ادغام در سطح کمپین CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners اضافه شد. برای کسب اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.
عمومی
ContactDetails.phone_number_extension	میدان جدید	به منبع LocalServicesLead اضافه شد.
IncentiveError	مقادیر/خطاهای جدید enum	کدهای خطای خاص جدیدی برای شکست‌های بازخرید تشویقی اضافه شد: BILLING_COUNTRY_NOT_ELIGIBLE (کشوری که مشتری از آن صورتحساب صادر می‌کند واجد شرایط دریافت این طرح تشویقی نیست) USER_IS_MCC_MANAGER (کاربر یک حساب مدیر است و نمی‌تواند از طرح تشویقی استفاده کند) USER_SUSPENDED (حساب مشتری به حالت تعلیق درآمده است) MAX_PENDING_INCENTIVES (مشتری به حداکثر تعداد مشوق‌های در انتظار رسیده است) ACCOUNT_HAD_RECENT_SPEND (حساب اخیراً خرج شده و واجد شرایط نیست) MAX_INCENTIVES_REDEEMED_FROM_OFFER (مشتری قبلاً حداکثر تعداد مشوق‌های این پیشنهاد را استفاده کرده است) MISMATCHING_BILLING_COUNTRY_CODE (کد کشور صورتحساب ارائه شده در درخواست با کشور حساب مشتری مطابقت ندارد)
برنامه‌ریزی
جزئیات کانال یوتیوب در بخش بینش‌های پرطرفدار	فیلدهای جدید	پشتیبانی از جزئیات بیشتر کانال یوتیوب مربوط به ویدیوهای مرتبط هنگام جستجوی اطلاعات مربوط به ترندها اضافه شد. فیلدهای جدید 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	بخش جدید	تفکیکی از تبلیغات غیرقابل رد شدن در پخش زنده یوتیوب بر اساس مدت زمان ارائه می‌دهد: INSTREAM_NON_SKIPPABLE_STANDARD (تبلیغ درون استریم با مدت زمان استاندارد و غیرقابل رد شدن) INSTREAM_NON_SKIPPABLE_MAX30_SEC (تبلیغات غیرقابل رد شدن در استریم که بیش از 30.99 ثانیه نباشد) INSTREAM_NON_SKIPPABLE_MAX60_SEC (تبلیغ غیرقابل رد شدن در استریم که بیش از ۶۰.۹۹ ثانیه نباشد) این بخش همیشه باید همراه با ad_format_type انتخاب شود. این بخش با AdGroup ، AdGroupAd ، Campaign ، Customer ، Video و VideoEnhancement قابل انتخاب است.
معیارهای اجتماعی مختص ویدیو	فیلدها/معیارهای جدید	معیارهای اجتماعی مختص ویدیو اضافه شده است تا به تبلیغ‌کنندگان کمک کند تا میزان مشارکت کاربران (نظرات، لایک‌ها و اشتراک‌گذاری‌ها) را برای تبلیغات Shorts در یوتیوب ردیابی کنند: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares آنها در AdGroup ، AdGroupAd ، Asset ، Campaign ، Customer و Video در دسترس هستند.

نسخه‌های اصلی و فرعی v24

نسخه ۲۴ رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) شامل ویژگی‌ها، به‌روزرسانی‌ها و تغییرات اساسی زیر است.

نسخه ۲۴.۲ (۲۴-۰۶-۲۰۲۶)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۴.۲ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۴.۲ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
تبلیغات
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	مقدار شمارشی جدید	اطلاعات متنی را از صفحه فرود تولید می‌کند تا در پنل تعامل برای نمونه‌های DemandGenVideoResponsiveAd (که به طور پیش‌فرض از این نسخه API انتخاب شده‌اند) نمایش داده شود.
دارایی‌ها
AssetGroup.google_local_services_info	میدان جدید	برای پشتیبانی از اطلاعات تبلیغات خدمات محلی (شناسه دسته و توضیحات) در کمپین‌های Performance Max اضافه شد.
AssetGroupSignal.local_services_id	میدان جدید	برای پشتیبانی از سیگنال‌های شناسه سرویس تبلیغات خدمات محلی در کمپین‌های Performance Max اضافه شد.
AssetGroupSignal.vertical_ads_item_group_rule_list	میدان جدید	برای پشتیبانی از قوانین گروه آیتم‌های تبلیغات عمودی برای انتخاب آیتم‌ها از فیدهای عمودی پیوست‌شده در کمپین‌های Performance 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	فیلدهای جدید	از شناسایی کمپین‌های «حداکثر عملکرد خدمات محلی» پشتیبانی کنید.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	میدان جدید	نقشه‌های گوگل را در کانال‌های قابل انتخاب برای گروه‌های تبلیغاتی Demand Gen قرار می‌دهد.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	مقدار / خطای شمارشی جدید	هنگام تلاش برای حذف همه مکان‌ها از یک کمپین خدمات محلی با حداکثر عملکرد، این خطا بازگردانده شد.
SmartCampaignErrorEnum.CREATION_FAILED	مقدار / خطای شمارشی جدید	هنگام تلاش برای ایجاد کمپین‌های هوشمند جدید، این خطا برمی‌گشت.
تبدیل‌ها
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	مقادیر شمارشی جدید	تبدیل‌هایی را نشان می‌دهد که وقتی کاربر روی یک تبلیغ خدمات محلی کلیک می‌کند و با تبلیغ‌کننده تماس می‌گیرد، پیام می‌دهد یا رزرو می‌کند، رخ می‌دهد.
آزمایش‌ها
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	مقادیر شمارشی جدید	پشتیبانی از انواع جدید ExperimentType اضافه شد: COMPARE_CAMPAIGNS : برای آزمایش‌های ترکیبی کمپین و آزمایش‌های سفارشی حداکثر عملکرد که چندین کمپین از انواع یکسان یا متفاوت را در یک آزمایش واحد مقایسه می‌کنند. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : برای آزمایش‌های بهینه‌سازی Performance Max برای سفارشی‌سازی متن و بسط نهایی URL.
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	فیلدهای جدید	شامل گواهی‌هایی برای محتوای مصنوعی/تولید شده توسط هوش مصنوعی است که به دو بخش advertiser_attestation (اعلان‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه می‌شوند) و system_attestation (گواهی‌هایی که به‌طور خودکار توسط سیستم شناسایی یا ارائه می‌شوند) تقسیم می‌شوند. این ویژگی به نسخه‌های ۲۳ و ۲۲ بک‌پورت شده است. برای کمک به شما در برنامه‌ریزی کارهای ادغام آینده‌تان برای نسخه ۲۵، رابط کاربری برای تغییر فیلدهای گواهی تبلیغ‌کننده برای نسخه ۲۲ و بالاتر، زودتر معرفی می‌شود. این رابط کاربری در این نسخه‌ها قابل مشاهده است، اما synthetic_content_info.advertiser_attestation.status و synthetic_content_info.advertiser_attestation.source برای این نسخه‌ها تغییرناپذیر باقی خواهند ماند. اگر درخواست تغییر (mutate) را در هر یک از این فیلدها امتحان کنید، یکی از این خطاها برگردانده خواهد شد: «فیلدی که تلاش برای تغییر آن شده است، تغییرناپذیر است» یا «فیلد قابل تنظیم نیست». این فیلدها از نسخه ۲۵ به بعد کاملاً قابل تغییر خواهند بود. توصیه می‌کنیم همین حالا از رابط کاربری برای ساخت و آزمایش منطق داخلی خود استفاده کنید تا سیستم شما هنگام راه‌اندازی نسخه ۲۵ برای قابلیت‌های کامل نوشتن آماده باشد.
مجوز چندجانبه	ویژگی‌های جدید	نسخه بتا: این ویژگی در حال حاضر در نسخه بتا است و ممکن است در نسخه‌های بعدی تغییر کند. پشتیبانی از بررسی‌های مجوز چندجانبه (MPA) اضافه شد: منبع MultiPartyAuthReview و MultiPartyAuthReviewService مربوطه اضافه شد. برای پیگیری وضعیت بررسی، شمارشگر MultiPartyAuthReviewStatus اضافه شد. CustomerUserAccess.pending_multi_party_auth_review برای پیوند به یک بررسی در حال بررسی اضافه شد. اضافه شدن MutateCustomerUserAccessResult.multi_party_auth_review و MutateCustomerUserAccessInvitationResult.multi_party_auth_review برای برگرداندن نام منبع بررسی مرتبط. MultiPartyAuthReviewError برای خطاهای اعتبارسنجی اضافه شد. این ویژگی به نسخه‌های ۲۳.۳ ، ۲۲.۲ و ۲۱.۲ بک‌پورت شده است.
IncentiveService.FetchIncentive	تغییر رفتاری	وقتی یک آدرس ایمیل نامعتبر در درخواست ارائه می‌شود، این متد اکنون به جای نمایش خطای AuthenticationError.INVALID_EMAIL_ADDRESS ، پیشنهادات تشویقی پیش‌فرض را برمی‌گرداند.
برنامه‌ریزی
GenerateCreatorInsightsRequest.search_topics	میدان جدید	به سرویس ContentCreatorInsightsService.GenerateCreatorInsights اضافه شد. این گزینه به دنبال سازندگانی می‌گردد که در مورد موضوعی در کشور مشخص شده در country_locations صحبت می‌کنند (فقط از جستجوی یک کشور پشتیبانی می‌کند).
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	میدان جدید	اگر درست باشد، استثنائات برند برای تبلیغات خرید نادیده گرفته می‌شوند. فقط برای کمپین‌های خرید پشتیبانی می‌شوند.
هدف‌گیری
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	مقدار / خطای شمارشی جدید	هنگام تلاش برای هدف قرار دادن زبانی که مجاز نیست، برگردانده می‌شود.
ویدیوها
DataLink.youtube_link_metadata	میدان جدید	شامل brand_channel_id برای مشخص کردن شناسه کانال برند یوتیوب لینک‌شده است.

نسخه ۲۴.۱ (۲۰۲۶-۰۵-۱۳)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۴.۱ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۴.۱ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
تبلیغات
DemandGenMultiAssetAdInfo.classic_display_images	میدان جدید	تصاویر نمایشی آپلود شده سفارشی بدون نیاز به فایل‌های واکنش‌گرای اضافی ارائه می‌شوند.
آزمایش‌ها
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	مقادیر شمارشی جدید	پشتیبانی از انواع جدید ExperimentType اضافه شد: ADOPT_AI_MAX : برای آزمایش‌هایی که بررسی می‌کنند چگونه AI Max می‌تواند به شما در جذب مشتریان بیشتر با استفاده از هوش مصنوعی گوگل و کلمات کلیدی با تطابق گسترده کمک کند. ADOPT_BROAD_MATCH_KEYWORDS : برای آزمایش‌هایی که بررسی می‌کنند کلمات کلیدی با تطابق گسترده چگونه می‌توانند بر تعداد جستجوهایی که تبلیغات شما در آنها ظاهر می‌شود تأثیر بگذارند. OPTIMIZE_ASSETS : برای آزمایش‌های سفارشی جهت بهینه‌سازی دارایی‌ها. PMAX_REPLACEMENT_SHOPPING : برای آزمایش‌هایی که عملکرد کمپین‌های خرید شما را در مقایسه با Performance Max بررسی می‌کنند.
Experiment.video_experiment	میدان جدید	پشتیبانی از پیکربندی برای آزمایش‌های موجود YOUTUBE_CUSTOM شامل کمپین‌های ویدیویی.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	فیلدهای جدید	فیلدهایی را برای پشتیبانی از آزمایش دارایی‌ها، گروه‌های دارایی و تنظیمات حداکثر عملکرد در بازوهای آزمایش در معرض نمایش قرار می‌دهد: asset_testing_info : جزئیات دارایی‌های مرتبط با نسخه‌های آزمایشی تبلیغات. asset_groups : فهرست گروه‌های دارایی در بازوی آزمایش برای آزمایش‌های Optimize Assets. performance_max_experiment_arm_info : تنظیمات مربوط به کمپین‌های Performance Max در آزمایش‌های PMAX_REPLACEMENT_SHOPPING .
عمومی
CustomerUserAccess.passkey_enabled	میدان جدید	فیلد فقط خواندنی که نشان می‌دهد آیا کاربر رمز عبور را فعال کرده است یا خیر.
گزارش‌ها
mobile_device_platform	بخش جدید	امکان تقسیم‌بندی گزارش‌ها بر اساس پلتفرم دستگاه کاربر (مانند iOS یا اندروید) را فراهم می‌کند.
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	مقدار / خطای شمارشی جدید	زمانی برگردانده می‌شود که جزئیات زمانی روزانه، ساعتی یا هفتگی درخواستی برای محدوده‌های تاریخ پرس‌وجو پشتیبانی نمی‌شود (فقط برای ۳۷ ماه گذشته در دسترس است).
vertical_ads_listing_user_rating vertical_ads_listing_venue	بخش‌های جدید	بخش‌های جدیدی که برای تبلیغات عمودی استفاده خواهند شد.
user_rating ، venue ، event_participant_display_name	معیارهای فیلتر جدید	فیلترینگ پشتیبانی شده در VerticalAdsItemGroupRuleInfo برای منبع SharedCriterion .
معیارهای آزمایش کنترل/درمان	فیلدهای جدید	مقادیر کنترل ( control_clicks و غیره)، مقادیر درمان ( clicks و غیره)، تخمین‌های نقطه‌ای ( clicks_point_estimate و غیره)، حاشیه‌های خطا ( clicks_margin_of_error و غیره) و مقادیر p ( clicks_p_value و غیره) در هفت خانواده اصلی معیار (کلیک‌ها، نمایش‌ها، هزینه، تبدیل‌ها، هزینه به ازای هر تبدیل، مقدار تبدیل، مقدار تبدیل به ازای هر هزینه) اضافه شد.
معیارهای تغییر مطلق تبدیل‌ها	فیلدهای جدید	پشتیبانی از Conversions برای تخمین تفاضل مطلق با استفاده از تخمین نقطه‌ای، حاشیه خطا و فیلدهای مقدار p.
هدف‌گیری
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	مقدار / خطای شمارشی جدید	هنگام تلاش برای حذف همه اهداف جمعیتی، بازگردانده شد.
ویدیوها
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	مقدار شمارشی جدید	ZEFR را به عنوان شریک شخص ثالث برای ادغام قابلیت مشاهده منتشر کرد.
DataLink.youtube_video.channel_id	میدان جدید	شناسه کانال یوتیوب مرتبط با لینک داده را افشا می‌کند.

نسخه ۲۴ (۲۰۲۶-۰۴-۲۲)

ویژگی‌های جدید، به‌روزرسانی‌ها و تغییرات اساسی زیر در Google Ads API v24 اضافه شده‌اند که یک نسخه اصلی است.

برای راهنمایی به بخش ارتقا به آخرین نسخه مراجعه کنید.

شکستن تغییرات

حالت اولیه	ایالت جدید	نوع تغییر	راهنمای پیاده‌سازی
تبلیغات
videos و logo_images اختیاری در DemandGenVideoResponsiveAdInfo	فیلدهای مورد نیاز	تغییر رفتاری	هنگام ایجاد یا تغییر تبلیغات ویدیویی واکنش‌گرای Demand Gen، videos و logo_images را ارائه دهید.
videos ، business_name و logo_images اختیاری در VideoResponsiveAdInfo	فیلدهای مورد نیاز	تغییر رفتاری	هنگام ایجاد یا تغییر تبلیغات ویدیویی واکنش‌گرا، videos ، business_name و logo_images را ارائه دهید. توجه داشته باشید که VideoResponsiveAdInfo اکنون قابل تغییر است.
کمپین‌ها
Campaign.video_brand_safety_suitability	هیچکدام	حذف	کنترل مناسب بودن در سطح کمپین حذف شده است. مناسب بودن برای ایمنی برند هنوز در سطح مشتری موجود است. به جای آن Customer.video_brand_safety_suitability استفاده کنید.
تبدیل‌ها
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	هیچکدام	حذف	دسته بندی کاربران ثبت نام شده در طرح وفاداری حذف شده است. ارجاعات کد به آن را حذف کنید.
برنامه‌ریزی
InsightsAudienceAttributeGroup نوع گروه برای topic_audience_combinations	common. InsightsAudienceAttributeGroup گروه	تغییر رفتار / تغییر نوع	ادغام‌های کتابخانه‌های کلاینت تایپ‌شده باید برای استفاده از فضاهای نام منابع جدید به‌روزرسانی شوند.
فیلد youtube_select_lineups در ReachPlanService.ListPlannableProducts	هیچکدام	حذف	به استفاده از ترکیب‌های بازی از youtube_select_lineup_targeting تغییر دهید.
فیلد is_brand_connect_creator در ContentCreatorInsightsService.GenerateCreatorInsights و GenerateTrendingInsights	هیچکدام	حذف	در عوض، بررسی کنید که آیا سازنده، CREATOR_PARTNERSHIPS را در partnership_opportunities در دسترس دارد یا خیر.
geo_modifiers و biddable_keywords در KeywordPlanIdeaService.GenerateKeywordForecastMetrics	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 بر این اساس، ادغام‌ها را به‌روزرسانی کنید.
گزارش‌ها
بخش ad_sub_network_type در campaign_budget	هیچکدام	حذف	بخش ad_sub_network_type برای منبع campaign_budget حذف شد.
بخش click_type در نماهای دارایی	هیچکدام	حذف	بخش از نماهای AdGroupAsset ، CampaignAsset و CustomerAsset حذف شد.
ویدیوها
خطای جزئی در ShareablePreviewService.GenerateShareablePreviews مجاز است.	بدون خرابی جزئی	تغییر رفتاری	اگر اعتبارسنجی هر یک از شناسه‌های درون درخواست با شکست مواجه شود، درخواست‌ها با شکست مواجه شده و خطا می‌دهند.
کدهای خطای قدیمی 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	تغییر رفتاری	اشیاء اطلاعاتی تبلیغات ویدیویی واکنش‌گرا اکنون قابل تغییر هستند.
دارایی‌ها
travel_feed_data در AssetSet	میدان جدید	برای بازیابی ویژگی‌های دارایی‌های فید مسافرتی ( hotel_center_account_id ، merchant_center_id ، partner_center_id ، subset_id ، travel_feed_vertical_type ) اضافه شد.
کمپین‌ها
Campaign.view_through_conversion_optimization_enabled	میدان جدید	امکان فعال‌سازی بهینه‌سازی تبدیل از طریق نمایش (VTC) (پیش‌فرض false ) را در کمپین‌های Demand Gen و App فراهم می‌کند.
CampaignCriterion.gender	ویژگی جدید	امکان حذف جنسیت برای کمپین‌های Performance Max در تمام نسخه‌های API گوگل ادز.
تبدیل‌ها
انواع تبدیل سرنخ (لید جنریشن)	مقادیر شمارشی جدید	enum های نوع عمل تبدیل GA4/Firebase جدید در ConversionActionType اضافه شد: 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	مقدار / خطای شمارشی جدید	هنگام تلاش برای ایجاد چندین لیست مشابه، بازگردانده می‌شود.
برنامه‌ریزی
فیلدهای ProductCoreAttributes در ListPlannableProductsResponse	فیلدهای جدید	توضیحات قابل برنامه‌ریزی محصول، هدف بازاریابی، مدل هزینه و روش خرید به ProductCoreAttributes در بخش ListPlannableProductsResponse اضافه شد.
گزارش‌ها
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 اضافه شد. فیلد retail_filter_bundle به AdGroupCriterion اضافه شد. فیلد retail_filter به SharedCriterion اضافه شد. RETAIL به ListingGroupFilterListingSource اضافه شد. بُعد RetailFilter به AssetGroupListingGroupFilter اضافه شد. خطاهای اعتبارسنجی جدید مرتبط در CriterionError و AssetGroupListingGroupFilterError اضافه شد. این ویژگی فقط برای حساب‌های موجود در لیست مجاز در دسترس است.

نسخه‌های اصلی و فرعی v23

نسخه ۲۳ رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) شامل ویژگی‌ها، به‌روزرسانی‌ها و تغییرات اساسی زیر است.

نسخه ۲۳.۳ (۲۴-۰۶-۲۰۲۶)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۳ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۳.۳ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	فیلدهای جدید	حاوی گواهی‌هایی برای محتوای مصنوعی/تولید شده توسط هوش مصنوعی، که به دو بخش advertiser_attestation (اعلان‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه می‌شوند) و system_attestation (گواهی‌هایی که به‌طور خودکار توسط سیستم‌های گوگل شناسایی یا ارائه می‌شوند) تقسیم می‌شوند. برای کمک به شما در برنامه‌ریزی کارهای ادغام آینده‌تان برای نسخه ۲۵، رابط کاربری برای تغییر فیلدهای گواهی تبلیغ‌کننده برای نسخه ۲۲ و بالاتر، زودتر معرفی می‌شود. این رابط کاربری در این نسخه‌ها قابل مشاهده است، اما synthetic_content_info.advertiser_attestation.status و synthetic_content_info.advertiser_attestation.source برای این نسخه‌ها تغییرناپذیر باقی خواهند ماند. اگر درخواست تغییر (mutate) را در هر یک از این فیلدها امتحان کنید، یکی از این خطاها برگردانده خواهد شد: «فیلدی که تلاش برای تغییر آن شده است، تغییرناپذیر است» یا «فیلد قابل تنظیم نیست». این فیلدها از نسخه ۲۵ به بعد کاملاً قابل تغییر خواهند بود. توصیه می‌کنیم همین حالا از رابط کاربری برای ساخت و آزمایش منطق داخلی خود استفاده کنید تا سیستم شما هنگام راه‌اندازی نسخه ۲۵ برای قابلیت‌های کامل نوشتن آماده باشد.
مصوبات چندجانبه	ویژگی‌های جدید	نسخه بتا: این ویژگی در حال حاضر در نسخه بتا است و ممکن است در نسخه‌های بعدی تغییر کند. پشتیبانی از بررسی‌های تایید چندجانبه (MPA) اضافه شد: منبع MultiPartyAuthReview و MultiPartyAuthReviewService مربوطه اضافه شد. برای پیگیری وضعیت بررسی، شمارشگر MultiPartyAuthReviewStatus اضافه شد. CustomerUserAccess.pending_multi_party_auth_review برای پیوند به یک بررسی در حال بررسی اضافه شد. اضافه شدن MutateCustomerUserAccessResult.multi_party_auth_review و MutateCustomerUserAccessInvitationResult.multi_party_auth_review برای برگرداندن نام منبع بررسی مرتبط. MultiPartyAuthReviewError برای خطاهای اعتبارسنجی اضافه شد.

نسخه ۲۳.۲ (۲۰۲۶-۰۳-۲۵)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۲ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۳.۲ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
دارایی‌ها
VideoEnhancement	منبع جدید	حاوی اطلاعات مربوط به تبلیغات ویدیویی مربوط به بهبودها است، مانند اینکه آیا توسط گوگل تولید شده یا توسط تبلیغ‌کننده ارائه شده است. برای کسب اطلاعات بیشتر به « درباره بهبودهای ویدیویی» مراجعه کنید.
AppTopCombinationView	منبع جدید	منبع فقط خواندنی برای ارائه بینش‌هایی در مورد ترکیب‌های دارایی با عملکرد بالا در کمپین‌های اپلیکیشن.
CustomerAsset	ویژگی جدید	پشتیبانی برای بازیابی CustomerAsset با تنظیم field_type روی BUSINESS_LOGO اضافه شد.
کمپین‌ها
AdGroupAd.start_date_time AdGroupAd.end_date_time	فیلدهای جدید	محدودیت‌های زمان‌بندی جزئی‌تری را برای تاریخ‌های کمپین ارائه دهید. این فقط برای برخی از انواع گروه‌های تبلیغاتی پشتیبانی می‌شود.
HotelSettingInfo.disable_hotel_setting	میدان جدید	امکان غیرفعال کردن فید هتل در کمپین‌های Demand Gen را فراهم می‌کند.
عمومی
CustomerClientLinkError	مقادیر/خطاهای جدید enum	دو کد خطای جدید اضافه شد: 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	میدان جدید	clicks مربوط به «حداکثر کلیک‌های مبتنی بر تقاضا» (CPC) در ReachPlanService.GenerateReachForecast اضافه شد.
partnership_opportunities	میدان جدید	به ContentCreatorInsightsService.GenerateCreatorInsights و ContentCreatorInsightsService.GenerateTrendingInsights اضافه شد.
گزارش‌ها
biddable_indirect_install_first_in_app_conversion_micros	میدان جدید	به منابع Campaign ، Customer و AdGroup اضافه شد.
ویدیوها
ShareablePreviewService	ویژگی جدید	با تنظیم preview_type روی YOUTUBE_LIVE_PREVIEW ، پشتیبانی از پیش‌نمایش‌های YouTube Live نیز گسترش یافت. UNSUPPORTED_AD_TYPE و TOO_MANY_RESOURCES_IN_REQUEST به ShareablePreviewError اضافه شد. این مورد فقط برای برخی از انواع تبلیغات پشتیبانی می‌شود.

نسخه ۲۳.۱ (۲۰۲۶-۰۲-۲۵)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API نسخه ۲۳.۱ اضافه شده‌اند. نسخه‌های فرعی مانند نسخه ۲۳.۱ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
مدیریت حساب
advertising_partner_properties.allowed_domain	میدان جدید	به منابع ProductLinkInvitation و ProductLink اضافه شد. شریک تبلیغاتی فقط می‌تواند در این دامنه تبلیغ کند.
Customer.contains_eu_political_advertising	میدان جدید	وضعیت اعلان سطح حساب را بازیابی می‌کند که آیا حاوی تبلیغات سیاسی هدفمند علیه اتحادیه اروپا است یا خیر، و یک EuPoliticalAdvertisingStatus برمی‌گرداند.
کمپین‌ها
Campaign.text_guidelines	میدان جدید	پشتیبانی از دستورالعمل‌های متنی اضافه شده است که می‌تواند با کمپین‌های Performance Max و Search برای کنترل برنامه‌نویسی‌شده‌ی دارایی‌های متنی تولیدشده توسط هوش مصنوعی استفاده شود. در text_guidelines ، می‌توانید term_exclusions و messaging_restrictions را تعریف کنید.
CampaignPrimaryStatusReason	مقادیر شمارشی جدید	CAMPAIGN_NOT_BOOKED ، BOOKING_HOLD_EXPIRING ، BOOKING_HOLD_EXPIRED و BOOKING_CANCELLED برای ارائه دلایل اصلی وضعیت کمپین‌ها با استراتژی پیشنهاد قیمت FIXED_CPM اضافه شدند.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	فیلدهای جدید	پشتیبانی از افشای خودکار دسته‌بندی آگهی رزرو و جزئیات رزرو فقط خواندنی اضافه شد.
Campaign.missing_eu_political_advertising_declaration	میدان جدید	از جستجو و فیلتر کردن کمپین‌هایی که فاقد اعلامیه‌هایی در مورد وجود تبلیغات سیاسی هدفمند علیه اتحادیه اروپا هستند، پشتیبانی می‌کند.
تبدیل‌ها
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	مقدار شمارشی جدید	از ردیابی کاربرانی که یک تبلیغ را تماشا می‌کنند و بعداً ویدیویی از همان کانال را تماشا می‌کنند، پشتیبانی می‌کند.
عمومی
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	مقدار / خطای شمارشی جدید	هنگام تلاش برای هدف قرار دادن فقط دسته نامشخص در ابعاد جمعیتی، بازگردانده می‌شود.
مشوق‌ها
IncentiveErrorEnum	مقادیر/خطاهای جدید enum	دو کد خطای جدید اضافه شد: MAX_INCENTIVES_REDEEMED و ACCOUNT_TOO_OLD . این خطاها برای درخواست‌هایی که در تاریخ ۱۱ مارس ۲۰۲۶ یا بعد از آن انجام شده‌اند، قابل بازگشت هستند.
برنامه‌ریزی
GenerateBenchmarksMetrics	ویژگی جدید	پشتیبانی از تفکیک تاریخ با استفاده از BreakdownDefinition اضافه شد.
ReachPlanService.GenerateReachForecast	مقدار شمارشی جدید	GOOGLE_DISPLAY_NETWORK به عنوان یک سطح قابل هدف‌گیری برای تبدیل‌های نسل حداکثر تقاضا اضافه شد.
GenerateTrendingInsights	فیلدهای جدید	اطلاعات خط روند تاریخی در TrendInsightDataPoint به TrendInsights هنگام جستجو بر اساس موضوع اضافه شد.
گزارش‌ها
معیارهای منحصر به فرد فراوانی کاربر	فیلدهای جدید	معیارهای جدیدی اضافه شده است که گزارش می‌دهند چند کاربر تبلیغ شما را حداقل دو، سه، چهار، پنج یا ده بار دیده‌اند: 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 برای پشتیبانی از آپلود و مدیریت ویدیوها در یوتیوب، و منبع YouTubeVideoUpload برای پشتیبانی از دریافت وضعیت آپلود و فراداده اضافه شد. این ویژگی فقط برای REST و کتابخانه کلاینت پایتون پشتیبانی می‌شود.

نسخه ۲۳ (۲۰۲۶-۰۱-۲۸)

ویژگی‌های جدید، به‌روزرسانی‌ها و تغییرات اساسی زیر در Google Ads API نسخه ۲۳ اضافه شده‌اند که یک نسخه اصلی محسوب می‌شود.

برای راهنمایی به بخش ارتقا به آخرین نسخه مراجعه کنید.

شکستن تغییرات

حالت اولیه	ایالت جدید	نوع تغییر	راهنمای پیاده‌سازی
تبلیغات
اشتراک گذاری تبلیغات مجاز است	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 حذف شده است. ارجاعات را در کد خود به‌روزرسانی کنید.
گزارش‌ها
Aggregate asset performance label metrics and enum	هیچکدام	Removal	Removed aggregate asset performance label metrics. The performance label enum is no longer returned for Search and Display.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
تبلیغات
AdFormatType	New enum values	Added new format types: TEXT , VERTICAL_ADS_BOOKING_LINK , and VERTICAL_ADS_PROMOTION .
دارایی‌ها
asset_group view	New fields	Added the following metrics: metrics.engagements , metrics.engagement_rate , and metrics.average_cpe .
asset_group_asset view	New fields	Added the following metrics: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , and metrics.interaction_event_types .
Asset.orientation	New field	Read-only orientation field added to image and video assets.
CampaignAsset	ویژگی جدید	Added support to retrieve campaign assets with field_type set to HEADLINE and DESCRIPTION .
ServedAssetFieldType	New enum values	Added HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , and DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO for assets served as sitelinks.
BusinessMessageAsset	New features / support	Updated Business Message assets: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
صورتحساب
InvoiceService.ListInvoices	New options	Can now return more granular details in Invoice , including campaign-level cost breakdown, itemized regulatory costs, and adjustment information, by setting include_granular_level_invoice_details in ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	New enums	Added helper enums for regulatory fees and units of measure.
کمپین‌ها
CampaignError	New enum values / errors	Added DURATION_TOO_LONG_FOR_TOTAL_BUDGET and END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET error codes.
تبدیل‌ها
ConversionActionCategory	New enum value	Added YOUTUBE_FOLLOW_ON_VIEWS to support tracking users who watch an ad and later watch a video from the same channel.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner	New field	Added support for companion banners in Demand Gen responsive video ads.
مشوق‌ها
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.
برنامه‌ریزی
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	New enum value	Allows building audiences using Life Events in GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , and GenerateCreatorInsights . Life Events are not supported for other AudienceInsightsService methods such as AudienceInsightsService.GenerateAudienceOverlap and AudienceInsightsService.GenerateTargetingSuggestionMetrics .
ReachPlanService.GenerateConversionRates	New fields / options	The response now includes surfaces to support conversion rate suggestions based on surface controls (eg, Gmail, Shorts). Only supported for Demand Gen campaigns.
LanguageDistribution	New field / type	Added to YouTubeChannelInsights to provide language distribution details in YouTube channel content.
BenchmarksService	سرویس جدید	Compares YouTube advertisement data against industry benchmarks.
AudienceInsightsService.GenerateAudienceDefinition	New method	Translates a free text description of a target audience into matching audience attributes using generative AI.
YouTubeChannelInsights.relevance_score	New field	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	New field	Represents the percentage change in a trend's value over the comparison period.
توصیه‌ها
GenerateRecommendationsRequest	New field	Added is_new_customer . When set to true for CAMPAIGN_BUDGET recommendations, it uses a model optimized for new customers (only recommended for customers with no campaigns).
گزارش‌ها
AdGroupAdAssetView	New feature / metrics support	Now supports impression, performance, and conversion metrics for RESPONSIVE_DISPLAY_AD .
ad_sub_network_type segment	New segment	Provides granular performance breakdown within an ad network. Initially available for Demand Gen campaigns on YouTube (In-stream, In-feed, Shorts). Must be selected along with ad_network_type .
Performance Max reporting	ویژگی جدید	Enabled ad network type breakdown for Performance Max campaigns.
UserLocationView GeographicView	New segments support	Support metrics segmented by conversion date: 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 , and cross_device_conversions_value_by_conversion_date .
Vertical ads segments	New segments	Added the following segments: 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 , and vertical_ads_vertical .
PerStoreView MatchedLocationInterestView	New reporting resources	Added PerStoreView to query store location details, and MatchedLocationInterestView (for AI Max campaigns) to provide performance metrics by geographic locations of interest.
خرید
ShoppingPerformanceView	New metrics support	Now supports the following metrics segmented by conversion date: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , and value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView	New metrics support	Added support for: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share , and search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri	New field	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	New field	Allows control over which ad formats can serve in Search campaigns using travel feeds.
AdGroupCriterion SharedCriterion	New fields / criteria	Added vertical_ads_item_group_rule_list criterion type to AdGroupCriterion and vertical_ads_item_group_rule to SharedCriterion to permit targeting item groups in Search campaigns with travel feeds.
Vertical ads data feed integration	ویژگی جدید	Can now connect a vertical ads data feed to a search campaign running AI Max to show property promotion and booking link travel ads alongside text ads. Control formats with vertical_ads_format_setting and define rules using vertical_ads_item_group_rule . Segment reporting by AdFormatType and vertical ads data feed dimensions.
ویدیوها
AdVideoAssetInfo.ad_video_asset_feature_control	New field	Added feature control options for video ad assets.
CampaignCriterionError	New enum value / error	Added the INVALID_VIDEO_LINEUP_ID error code.
YouTube audibility metrics	New metrics	Added audibility metrics for audio ads on YouTube, reporting whether an ad was audible and on how many impressions audibility could be measured.

v22 major and minor versions

Google Ads API v22 includes the following new features, updates, and breaking changes.

v22.2 (2026-06-24)

The following new features and updates were added in Google Ads API v22.2. Minor versions like v22.2 don't contain breaking changes.

Features and updates	نوع	توضیحات
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems). To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-party approvals	ویژگی‌های جدید	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

v22.1 (2026-02-25)

The following new feature was added in Google Ads API v22.1. Minor versions like v22.1 don't contain breaking changes.

Features and updates	نوع	توضیحات
مدیریت حساب
Customer.contains_eu_political_advertising	New field	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
کمپین‌ها
Campaign.missing_eu_political_advertising_declaration	New field	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v22 (2025-10-15)

The following new features, updates, and breaking changes were added in Google Ads API v22, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Rename / spelling fix	Rename references to use the corrected field name.
عمومی
No operations limit in AddBatchJobOperations	10,000 operations limit per request	Behavioral shift	Ensure that no single AddBatchJobOperations request contains more than 10,000 operations.
Silently capped page size at 1,000 in ListBatchJobResultsRequest	Returns INVALID_PAGE_SIZE error	Behavioral shift	Ensure ListBatchJobResultsRequest.page_size is set to 1,000 or less, as requesting a larger page size will now result in an error.
Performance Max
Asset performance labels	هیچکدام	Removal	Asset performance labels support and the associated performance label enum have been removed for Performance Max campaigns. Update integrations accordingly.
Campaign.url_expansion_opt_out	FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION flag in AssetAutomationSetting	Removal / replacement	Use the final URL expansion text asset automation setting. The Campaign-level URL expansion opt-out field is removed.
برنامه‌ریزی
views	trueview_views	Removal / replacement	Replace references to views with the new trueview_views field in ReachPlanService .
ویدیوها
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	Renames	Update query strings and integrations to use the new metric names representing TrueView video views.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
دارایی‌ها
AssetFieldType.LANDING_PAGE_PREVIEW	New enum value	Added as a new image asset field type.
AssetGenerationService	New service (Beta)	Allows generating text and image assets using generative AI: GenerateText : Generates text based on final URL, prompts, keywords, etc. GenerateImages : Generates images based on final URL, prompts, or recontextualizing product images. Errors are returned with codes from AssetGenerationError . Initially available only to a limited set of closed beta participants.
کمپین‌ها
AppCampaignBiddingStrategyGoalType	New enum values	Added new goals for App campaigns for installs (ACi) to optimize without specifying a target: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : Use with standard Maximize Conversions. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : Use with standard Maximize Conversion Value.
BiddingStrategyType	ویژگی جدید	Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types	New field	Shows the types of feeds attached to a campaign. For Performance Max campaigns, this can indicate the business vertical, such as MERCHANT_CENTER_FEED for retail.
Shared set targeting	ویژگی جدید	Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Demand Gen
TargetCPC bidding	ویژگی جدید	Added bidding strategy to maximize clicks at target CPC: set campaign-level target CPC using Campaign.target_cpc and override at ad group level using AdGroup.target_cpc_micros .
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	New enum value	If enabled for DemandGenMultiAssetAdInfo , this adds design elements and embeds text assets into image assets to create new image assets with different aspect ratios (enabled by default).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	New enum value	If enabled for DemandGenMultiAssetAdInfo , it generates videos using other assets like images and text, which can then be used to create new DemandGenVideoResponsiveAdInfo instances (enabled by default).
عمومی
ListBatchJobResultsRequest page size fallback	Behavioral change	If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE ).
QuotaError	New enum value / error	Added PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when payment profile activation rate limit is exceeded.
Performance Max
Asset automation settings	New enum values	Added new PMax asset automation options: GENERATE_IMAGE_ENHANCEMENT : Enables automatic creation of enhanced images (auto-cropping). Enabled by default. GENERATE_IMAGE_EXTRACTION : Sourced images from final URLs. Defaults to account Dynamic Image Extension setting.
PMax reporting segments	New segments	Added new segments unique to Performance Max campaigns: ad_using_product_data : Indicates if an ad uses Google Merchant Center product data. ad_using_video : Indicates if an ad uses a video asset.
برنامه‌ریزی
CRM partner data lists	New feature / enum value	Added THIRD_PARTY_PARTNER_DATA to CRM data sources, along with partner audience validation error codes (such as tos acceptance, Link missing, etc.).
Livestream creator metrics	New field	Added YouTubeMetrics.is_active_live_stream_creator , returned by creator insights to indicate if a creator published a livestream in the past 90 days.
Plannable CRM source metadata	پیام جدید	Added PlannableUserListMetadata inside PlannableUserList , returned by ReachPlanService.ListPlannableUserLists , to show CRM data source types.
Support for related videos and creators in TrendInsight	New fields	Added support for related_videos and related_creators on TrendInsight , and watch properties in video_properties and publish_date .
InsightsFinder improvements	ویژگی جدید	GenerateInsightsFinderReport now supports parental_status , income_ranges , and more complex AND/OR targeting combinations.
گزارش‌ها
New click types	New enum values	Added CLICK_TO_MESSAGE_THIRD_PARTY_CLICK and CLICK_TO_MESSAGE_LANDING_PAGE_CLICK .
AssetGroupAsset segmentation	New segments support	AssetGroupAsset is now segmentable by device , conversion_action , conversion_action_name , and conversion_action_category .
RSAs in AdGroupAdAssetView	New feature / metrics support	AdGroupAdAssetView now fully supports performance and conversion metrics for RESPONSIVE_SEARCH_AD (previously only impressions were returned).
Exploration query cluster metric segmentations	New segments support	Metrics clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters are now segmentable by date fields.
TargetingExpansionView	New reporting resource	Added TargetingExpansionView to report metrics for expansions over manual targeting, such as keywordless expansion for AI Max for Search Campaigns.
خرید
Shopping scope fix	Bug fix	Fixed the campaign and ad group scoping of metrics in the ShoppingProduct resource.
Unified goals
Retention goals	ویژگی جدید	Added support for customer retention goals to optimize for re-engaging existing customers (eg, using target_option with TARGET_SPECIFIC or TARGET_ALL ).
ویدیوها
Video watch time metrics	New fields	Added watch time duration metrics: video_watch_time_duration_millis (total duration) and average_video_watch_time_duration_millis (average duration per impression).

Archived release notes

See Sunsetted versions for archived release notes.

،

Refer to Feature deprecations for an up to date list of current and planned feature deprecations.

v25 major and minor versions

Google Ads API v25 includes the following new features, updates, and breaking changes.

v25.1 (2026-08-19)

The following new features and updates were added in Google Ads API v25.1. Minor versions like v25.1 don't contain breaking changes.

Features and updates	نوع	توضیحات
دارایی‌ها
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	New enum values	Added support for text disclaimer assets.
کمپین‌ها
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	New fields	Track the upcoming auto-migration to AI Max.
تبدیل‌ها
Brand Lift measurements	ویژگی‌های جدید	Added support for Brand Lift measurements with the following updates: Added new read-only dimensional resources for lift study results: LiftMeasurementAgeRange , LiftMeasurementCampaign , LiftMeasurementDevice , LiftMeasurementGender , and LiftMeasurementVideo . Added new segments and metrics to support Brand Lift analysis with LiftMeasurementConfig and the new dimensional resources. Added the following enums: BrandLiftMeasurementType , LiftMeasurementFlightStatus , SurveyIntendedAction , SurveyLiftFlightTargetResponseMode , and SurveySubjectType .
Conversion Lift measurements	ویژگی‌های جدید	Added support for Conversion Lift measurements with the following updates: Added a new read-only resource LiftMeasurementConfig representing a lift study. Added new selectable segments to segment and filter lift results. Added 24 new Conversion Lift metrics and winner score metrics supporting detailed statistical analysis of lift performance. Added support to retrieve campaign details and conversion goals. Added a new optional field Experiment.lift_measurement_config . Added the ConversionLiftIncludedConversionActionTypes enum.
LiftMeasurementFlight	New resource	A new read-only resource representing flight details for a lift measurement configuration, including measured flight start and end dates ( start_date and end_date ).
عمومی
SmartCampaignError	New enum values	Added new specific error codes for Performance Max generation constraints: 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	New enum value / error	Returned when a Google Cloud project with TEST access level attempts to make requests against a non-test account.
برنامه‌ریزی
Brand sentiment insights	ویژگی‌های جدید	Added support for brand sentiment insights in ContentCreatorInsightsService : Added the BrandSentimentInsight , SentimentInsightDistribution , and SentimentInsightSummary messages. Added the Sentiment enum. Added the BRAND_SENTIMENT_DATA value to the ContentCreatorInsightsSupplementalData enum. Added the BRAND value to the InsightsKnowledgeGraphEntityCapabilities enum.
BenchmarksService enhancements	ویژگی‌های جدید	Added support for categories as filters for scoping a benchmarks analysis. Also supported additional business critical metrics: Added an option to benchmark against all advertisers running Ads in one or more Product & Service Categories using BenchmarksService.GenerateBenchmarksMetrics and the category_filter . Surfaced more customer ad metrics such as the customer's aggregate cost, views, etc. and share metrics such as share_of_voice . Metrics are returned using AggregateMetrics and ShareMetrics . The list of supported categories can be retrieved using BenchmarksService.ListBenchmarksSources with the CATEGORY source type.
Parental status targeting	ویژگی جدید	Added support for parental status targeting in reach planning. The new field parental_statuses has been added to Targeting for service ReachPlanService.GenerateReachForecast , and parental_statuses has been added to PlannableTargeting for service ReachPlanService.ListPlannableProducts .
توصیه‌ها
Recommendation.campaign_specific_app_goal_recommendation	New recommendation	Suggests adding a campaign-specific app conversion goal. The new EffectiveAutomaticGoal resource is used to represent current goals within this recommendation.
گزارش‌ها
Metrics.original_conversion_value	New field	Represents the original conversion value from biddable conversions. This is the unadjusted value of conversions before any value rule adjustments, such as conversion value rules or lifecycle goals adjustments are applied.
Loyalty membership stats	ویژگی‌های جدید	Added support for segmenting stats by user loyalty membership program status, and added loyalty membership primary dimension for conversion value rules: Added the Segments.loyalty_membership segment to support segmenting report metrics by the loyalty program tier of the converting user. Added the LOYALTY_MEMBERSHIP primary dimension to identify when a loyalty membership condition was satisfied for a conversion value rule.
هدف‌گیری
vertical_ads_item_bid	New criterion type	Added the new vertical_ads_item_bid criterion type to AdGroupCriterion.criterion .

نسخه ۲۵ (۲۰۲۶-۰۷-۲۲)

The following new features, updates, and breaking changes were added in Google Ads API v25, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
کمپین‌ها
Standalone fields additional_value and additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings	Part of value_adjustment and high_lifetime_value_adjustment oneofs respectively, alongside the new value_multiplier and high_lifetime_value_multiplier fields	Structural change	Update references to these fields as they are now part of oneofs.
Legacy CustomerLifecycleGoal and CampaignLifecycleGoal resources, their corresponding services CustomerLifecycleGoalService and CampaignLifecycleGoalService , and legacy settings/enums ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings )	هیچکدام	Removal	Use the revamped unified goals schema: Use the new_customer_acquisition_goal_settings field in the Goal resource. Use the campaign_new_customer_acquisition_settings field in the CampaignGoalConfig resource to configure campaign-specific overrides.
عمومی
Nested enum fields in Incentive Service request and response messages: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Standalone enum fields: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Rename / removal	Use the new standalone enum fields instead of the legacy type fields.
Optional selected_incentive_id and customer_id fields in ApplyIncentiveRequest	فیلدهای مورد نیاز	Behavioral shift	Ensure you provide both fields when calling ApplyIncentive .
The consumer email address field ContactDetails.email in the LocalServicesLead resource	هیچکدام	Removal	Remove references to this field because it is no longer supported.
Optional allowed_domain field in AdvertisingPartnerLinkInvitationProperties	Required field when calling CreateProductLinkInvitation for an advertising partner	Behavioral shift	Ensure you provide allowed_domain when creating a product link invitation for an advertising partner.
برنامه‌ریزی
The search_brand field in GenerateCreatorInsightsRequest	هیچکدام	Removal	Use search_topics instead.
The plannable_location_id field in Targeting and cookie_frequency_cap field in GenerateReachForecastRequest	هیچکدام	Removal	Switch to using plannable_location_ids and cookie_frequency_cap_setting .
گزارش‌ها
customer_metrics field in GenerateBenchmarksMetricsResponse and BreakdownMetrics of type Metrics	Field of type CustomerMetrics	Type change / behavioral shift	Update your integrations to use the new CustomerMetrics type, which only contains metrics representing the customer's ad performance.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
تبلیغات
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	New enum value / behavior	Available for DemandGenMultiAssetAds . If enabled, it generates animated images using non-animated images as input. New DemandGenMultiAssetAds are opted in by default starting with this API version.
Synthetic content info mutability	Behavior change	Asset.synthetic_content_info and Ad.synthetic_content_info are now fully mutable in v25, v24, and v23.
کمپین‌ها
Loyalty Retention Goal	New features / settings	Added support for Loyalty Retention Goal, which allows advertisers to optimize campaigns for retaining loyalty program members. Added LOYALTY_RETENTION to the GoalType enum. Added CampaignGoalConfig.campaign_loyalty_retention_settings to configure campaign-specific loyalty retention settings, including bid adjustments and showing member benefits in PLA format. Added Goal.loyalty_retention_goal_settings to configure account-level loyalty retention goal settings. Added new error codes: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
New Customer Acquisition Goal	New features / settings	Updated New Customer Acquisition Goal support in the Google Ads API to reflect the revamped unified goals schema: Extended the Goal resource to support New Customer Acquisition settings using the new_customer_acquisition_goal_settings field. Extended the CampaignGoalConfig resource to support campaign-specific overrides for New Customer Acquisition using the campaign_new_customer_acquisition_settings field. Added the new CustomerLifecycleOptimizationGoalSubType enum to define supported goal subtypes. Added NEW_CUSTOMER_ACQUISITION to the GoalType enum. Added new validation error reasons to GoalError : NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Added new validation error reasons to 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 Added ErrorDetails.incompatible_clo_goal_error_details to expose the new IncompatibleCloGoalsErrorDetails structure for validation errors.
تبدیل‌ها
YouTube third-party conversion attribution	New fields	Added support for YouTube conversion attribution verification using third-party partners: Added CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the customer level. Added CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the campaign level. See the Help Center article to learn more.
عمومی
ContactDetails.phone_number_extension	New field	Added to the LocalServicesLead resource.
IncentiveError	New enum values / errors	Added new specific error codes for incentive redemption failures: BILLING_COUNTRY_NOT_ELIGIBLE (the customer's billing country is not eligible for the incentive) USER_IS_MCC_MANAGER (the user is a manager account and cannot redeem the incentive) USER_SUSPENDED (the customer account is suspended) MAX_PENDING_INCENTIVES (the customer has reached the maximum number of pending incentives) ACCOUNT_HAD_RECENT_SPEND (the account had recent spend and is not eligible) MAX_INCENTIVES_REDEEMED_FROM_OFFER (the customer has already redeemed the maximum number of incentives from this offer) MISMATCHING_BILLING_COUNTRY_CODE (the billing country code provided in the request does not match the customer's account country)
برنامه‌ریزی
YouTube channel details in trending insights	New fields	Added support for more YouTube channel details of related videos when searching trending insights. The new fields channel_id , channel_name , and channel_url have been added to YouTubeVideoAttributeMetadata .
YouTubeChannelInsights.data_sharing_consent_given	New field	Added to YouTubeChannelInsights . This is true if a creator has consented to sharing non-public data. If so, the following fields are populated: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
گزارش‌ها
ad_sub_format_type	New segment	Provides a breakdown of YouTube instream non-skippable ads by duration: INSTREAM_NON_SKIPPABLE_STANDARD (standard duration instream non-skippable ad) INSTREAM_NON_SKIPPABLE_MAX30_SEC (instream non-skippable ad no longer than 30.99 seconds) INSTREAM_NON_SKIPPABLE_MAX60_SEC (instream non-skippable ad no longer than 60.99 seconds) This segment must always be selected together with ad_format_type . It is selectable with AdGroup , AdGroupAd , Campaign , Customer , Video , and VideoEnhancement .
Video-specific social metrics	New fields / metrics	Added video-specific social metrics to help advertisers track user engagement (comments, likes, and shares) for Shorts ads on YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares They are available in AdGroup , AdGroupAd , Asset , Campaign , Customer , and Video .

v24 major and minor versions

Google Ads API v24 includes the following new features, updates, and breaking changes.

v24.2 (2026-06-24)

The following new features and updates were added in Google Ads API v24.2. Minor versions like v24.2 don't contain breaking changes.

Features and updates	نوع	توضیحات
تبلیغات
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	New enum value	Generates text information from the landing page to be shown in the engagement panel for DemandGenVideoResponsiveAd instances (which are opted in by default starting with this API version).
دارایی‌ها
AssetGroup.google_local_services_info	New field	Added to support Local Services Ads information (category ID and callouts) in Performance Max campaigns.
AssetGroupSignal.local_services_id	New field	Added to support Local Services Ads service ID signals in Performance Max campaigns.
AssetGroupSignal.vertical_ads_item_group_rule_list	New field	Added to support vertical ads item group rules for selecting items from attached vertical feeds in Performance Max campaigns. This feature is only available to accounts on the allowlist.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	New enum value / error	Returned when attempting to remove all asset groups from a campaign.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	New enum value / error	Returned when attempting to remove all signals from an asset group.
کمپین‌ها
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	New fields	Support identifying Local Services Performance Max campaigns.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	New field	Includes Google Maps in the selectable channels for Demand Gen ad groups.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	New enum value / error	Returned when attempting to remove all locations from a local services Performance Max campaign.
SmartCampaignErrorEnum.CREATION_FAILED	New enum value / error	Returned when attempting to create new Smart Campaigns.
تبدیل‌ها
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	New enum values	Represent conversions that occur when a user clicks on a local services ad and calls, messages, or books the advertiser.
آزمایش‌ها
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	New enum values	Added support for new ExperimentType types: COMPARE_CAMPAIGNS : For campaign mix experiments and custom Performance Max experiments that compare multiple campaigns of the same or different types in a single experiment. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : For Performance Max optimization experiments for text customization and Final URL expansion.
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by the system). This feature has been backported to v23 and v22. To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-Party Authorization	ویژگی‌های جدید	Beta: This feature is currently in beta and is subject to change in future releases. Added support for Multi-Party Authorization (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors. This feature has been backported to v23.3 , v22.2 , and v21.2 .
IncentiveService.FetchIncentive	Behavioral change	When an invalid email address is provided in the request, the method now gracefully falls back to returning the default incentive offers instead of throwing an AuthenticationError.INVALID_EMAIL_ADDRESS error.
برنامه‌ریزی
GenerateCreatorInsightsRequest.search_topics	New field	Added to the ContentCreatorInsightsService.GenerateCreatorInsights service. This option searches for creators talking about a topic in the country specified in country_locations (supports searching for one country only).
CREATOR_TOPIC_INSIGHTS	New enum value	Added to InsightsKnowledgeGraphEntityCapabilities to signify entities for searching creators talking about a topic. These entities should be used in the search_topics field. Retrieved using AudienceInsightsService.ListAudienceInsightsAttributes .
KnowledgeGraphEntitySearchOptions	New type / options	Contains additional search options for topics in ListAudienceInsightsAttributes , including options to retrieve all topics supported as creator attributes, and filtering by capabilities.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	New fields	Optional inputs to the ContentCreatorInsightsService methods. Supplying this field populates additional locations or creator attributes in the response.
local_creator_insights related_local_creators	New fields	Populated when supplemental_data contains the LOCAL_CREATOR_DATA enum. Exposes local creators viewed in or based in the chosen country who consented to share location data.
GenerateTrendingInsightsRequest.sub_country_locations	New field	Added to ContentCreatorInsightsService.GenerateTrendingInsights , allowing searches for trending insights using country location and sub country locations.
گزارش‌ها
PerformanceMaxPlacementView	Segments extension	Made segmentable by ad_network_type .
خرید
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	New field	If true, brand exclusions are ignored for Shopping ads. Only supported for Shopping campaigns.
هدف‌گیری
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	New enum value / error	Returned when attempting to target a language that is not allowed.
ویدیوها
DataLink.youtube_link_metadata	New field	Contains brand_channel_id to specify the ID of the linked YouTube brand channel.

v24.1 (2026-05-13)

The following new features and updates were added in Google Ads API v24.1. Minor versions like v24.1 don't contain breaking changes.

Features and updates	نوع	توضیحات
تبلیغات
DemandGenMultiAssetAdInfo.classic_display_images	New field	Custom uploaded display images served without requiring extra responsive assets.
آزمایش‌ها
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	New enum values	Added support for new ExperimentType types: ADOPT_AI_MAX : For experiments that test how AI Max can help you engage more customers with Google AI and broad match keywords. ADOPT_BROAD_MATCH_KEYWORDS : For experiments that test how broad match keywords can impact the number of searches your ads appear in. OPTIMIZE_ASSETS : For custom experiments for optimizing assets. PMAX_REPLACEMENT_SHOPPING : For experiments that test how your Shopping campaigns perform compared to Performance Max.
Experiment.video_experiment	New field	Configuration support for existing YOUTUBE_CUSTOM experiments consisting of Video campaigns.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	New fields	Exposes fields to support asset testing, asset groups, and Performance Max settings in experiment arms: asset_testing_info : Details of assets associated with the experimental copies of ads. asset_groups : List of asset groups in the experiment arm for Optimize Assets experiments. performance_max_experiment_arm_info : Settings for Performance Max campaigns in PMAX_REPLACEMENT_SHOPPING experiments.
عمومی
CustomerUserAccess.passkey_enabled	New field	Read-only field indicating whether the user has a passkey enabled.
گزارش‌ها
mobile_device_platform	New segment	Allows segmenting reports by the user device's platform (such as iOS or Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	New enum value / error	Returned when the requested daily, hourly, or weekly time granularity is not supported for query date ranges (only available for the last 37 months).
vertical_ads_listing_user_rating vertical_ads_listing_venue	New segments	New segments to be used for vertical ads.
user_rating , venue , event_participant_display_name	New filter criteria	Supported filtering in VerticalAdsItemGroupRuleInfo for the SharedCriterion resource.
Control/treatment experiment metrics	New fields	Added control values ( control_clicks , etc.), treatment values ( clicks , etc.), point estimates ( clicks_point_estimate , etc.), margins of error ( clicks_margin_of_error , etc.), and p-values ( clicks_p_value , etc.) across seven core metric families (Clicks, Impressions, Cost, Conversions, Cost per conversion, Conversion value, Conversion value per cost).
Conversions absolute change metrics	New fields	Support for Conversions absolute difference estimations using point estimate, margin of error, and p-value fields.
هدف‌گیری
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	New enum value / error	Returned when attempting to exclude all demographics targets.
ویدیوها
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	New enum value	Published ZEFR as a third party viewability integration partner.
DataLink.youtube_video.channel_id	New field	Exposes the YouTube channel ID associated with the data link.

v24 (2026-04-22)

The following new features, updates, and breaking changes were added in Google Ads API v24, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
تبلیغات
Optional videos and logo_images in DemandGenVideoResponsiveAdInfo	فیلدهای مورد نیاز	Behavioral shift	Provide videos and logo_images when creating or mutating responsive Demand Gen video ads.
Optional videos , business_name , and logo_images in VideoResponsiveAdInfo	فیلدهای مورد نیاز	Behavioral shift	Provide videos , business_name , and logo_images when creating or mutating video responsive ads. Note that VideoResponsiveAdInfo is now mutable.
کمپین‌ها
Campaign.video_brand_safety_suitability	هیچکدام	Removal	Campaign-level suitability control is removed. Brand safety suitability is still available on the customer level. Use Customer.video_brand_safety_suitability instead.
تبدیل‌ها
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	هیچکدام	Removal	The loyalty sign ups user category has been removed. Remove code references to it.
برنامه‌ریزی
InsightsAudienceAttributeGroup type for topic_audience_combinations	common. InsightsAudienceAttributeGroup type	Behavioral shift / type change	Typed client libraries integrations must be updated to use the new resource namespaces.
youtube_select_lineups field in ReachPlanService.ListPlannableProducts	هیچکدام	Removal	Switch to using lineups from youtube_select_lineup_targeting .
is_brand_connect_creator field in ContentCreatorInsightsService.GenerateCreatorInsights and GenerateTrendingInsights	هیچکدام	Removal	Instead, check if a creator has CREATOR_PARTNERSHIPS available in partnership_opportunities .
geo_modifiers and biddable_keywords in KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants and keywords	Rename / removal	Replaced by CampaignToForecast.geo_target_constants[] and ForecastAdGroup.keywords[] .
Deprecated keywords plan / forecast fields in GenerateKeywordForecastMetrics	هیچکدام	Removal	Removed the following plan / forecast fields and types: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords and ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Update integrations accordingly.
گزارش‌ها
ad_sub_network_type segment in campaign_budget	هیچکدام	Removal	Removed ad_sub_network_type segment for the campaign_budget resource.
click_type segment in asset views	هیچکدام	Removal	Removed segment from AdGroupAsset , CampaignAsset , and CustomerAsset views.
ویدیوها
Partial failure allowed in ShareablePreviewService.GenerateShareablePreviews	No partial failure	Behavioral shift	Requests will fail and throw an error if any ID within it fails validation.
ShareablePreviewError legacy codes: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Rename / behavioral shift	Error codes returned for asset groups are modified to align with ad group ad errors. Update validation catch logic.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
تبلیغات
Mutability of VideoResponsiveAdInfo	Behavioral change	Responsive video ads information objects are now mutable.
دارایی‌ها
travel_feed_data in AssetSet	New field	Added to retrieve travel feed assets attributes ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ).
کمپین‌ها
Campaign.view_through_conversion_optimization_enabled	New field	Allows enabling View-Through Conversion (VTC) Optimization (default false ) in Demand Gen and App campaigns.
CampaignCriterion.gender	ویژگی جدید	Enabled gender exclusions for Performance Max campaigns on all Google Ads API versions.
تبدیل‌ها
Lead Gen conversion types	New enum values	Added new GA4/Firebase conversion action type enums in ConversionActionType : 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	New enum value / error	Returned when attempting to create multiple identical lookalike lists.
برنامه‌ریزی
ProductCoreAttributes fields in ListPlannableProductsResponse	New fields	Added plannable product description, marketing objective, cost model, and buying method to ProductCoreAttributes under ListPlannableProductsResponse .
گزارش‌ها
CartDataSalesView	New reporting resource	Exposes reports segmenting conversions metrics by the specific product sold (brand, etc.) in addition to the clicked product.
Non-biddable metrics	New fields	Added non-biddable metrics (metrics showing conversions that campaigns are not optimizing for) to all matching resources: 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	New segment	Added to ShoppingPerformanceView .
خرید
App campaigns in ShoppingProduct	ویژگی جدید	Supported App campaigns inside the ShoppingProduct resource. Note status and issues are not supported.
Tag-based product filtering	ویژگی جدید	Introduced filtering using logical set expressions dynamically: Added RETAIL_FILTER_BUNDLE and RETAIL_FILTER criterion types. Added RETAIL_FILTER shared set type. Added the retail_filter_bundle field to AdGroupCriterion . Added the retail_filter field to SharedCriterion . Added RETAIL to ListingGroupFilterListingSource . Added RetailFilter dimension to AssetGroupListingGroupFilter . Added related new validation errors in CriterionError and AssetGroupListingGroupFilterError . This feature is only available to accounts on the allowlist.

v23 major and minor versions

Google Ads API v23 includes the following new features, updates, and breaking changes.

v23.3 (2026-06-24)

The following new features and updates were added in Google Ads API v23.3. Minor versions like v23.3 don't contain breaking changes.

Features and updates	نوع	توضیحات
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems). To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-party approvals	ویژگی‌های جدید	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

v23.2 (2026-03-25)

The following new features and updates were added in Google Ads API v23.2. Minor versions like v23.2 don't contain breaking changes.

Features and updates	نوع	توضیحات
دارایی‌ها
VideoEnhancement	New resource	Contains enhancement-specific video ad information, such as whether it's Google-generated or advertiser-provided. See the About video enhancements to learn more.
AppTopCombinationView	New resource	Read-only resource to provide insights into top-performing asset combinations in App campaigns.
CustomerAsset	ویژگی جدید	Added support to retrieve CustomerAsset with field_type set to BUSINESS_LOGO .
کمپین‌ها
AdGroupAd.start_date_time AdGroupAd.end_date_time	New fields	Provide more granular scheduling constraints over the campaign's dates. This is only supported for some ad group types.
HotelSettingInfo.disable_hotel_setting	New field	Allows disabling the hotel feed in Demand Gen campaigns.
عمومی
CustomerClientLinkError	New enum values / errors	Added two new error codes: MAX_CUSTOMER_LIMIT_REACHED and ACCOUNT_CREATION_POLICY_VIOLATION .
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Behavioral change	An error is now thrown when attempting to use this sunsetted user list customer type category.
برنامه‌ریزی
GenerateTrendingInsights GenerateCreatorInsights	ویژگی‌های جدید	Added support for custom AND/OR combinations of entities, topics, and audiences.
ReachPlanService.GenerateReachForecast	New enum values	Added new targetable age ranges, such as AGE_RANGE_21_44 or AGE_RANGE_21_49 .
youtube_select_lineup_targeting	New field	Added to ReachPlanService.ListPlannableProducts , which will replace youtube_select_lineups . Both fields are currently populated.
ReachPlanSurface	New enum value	Added IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS as a surface option.
Forecast	New field	Added clicks for Demand Gen Max Clicks (CPC) in ReachPlanService.GenerateReachForecast .
partnership_opportunities	New field	Added to ContentCreatorInsightsService.GenerateCreatorInsights and ContentCreatorInsightsService.GenerateTrendingInsights .
گزارش‌ها
biddable_indirect_install_first_in_app_conversion_micros	New field	Added to Campaign , Customer , and AdGroup resources.
ویدیوها
ShareablePreviewService	ویژگی جدید	Extended to support YouTube Live previews by setting preview_type to YOUTUBE_LIVE_PREVIEW . Added UNSUPPORTED_AD_TYPE and TOO_MANY_RESOURCES_IN_REQUEST to ShareablePreviewError . This is only supported for some ad types.

v23.1 (2026-02-25)

The following new features and updates were added in Google Ads API v23.1. Minor versions like v23.1 don't contain breaking changes.

Features and updates	نوع	توضیحات
مدیریت حساب
advertising_partner_properties.allowed_domain	New field	Added to ProductLinkInvitation and ProductLink resources. The advertising partner will only be able to advertise on this domain.
Customer.contains_eu_political_advertising	New field	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
کمپین‌ها
Campaign.text_guidelines	New field	Added support for text guidelines, which can be used with Performance Max and Search campaigns to programmatically control AI-generated text assets. Within text_guidelines , you can define term_exclusions and messaging_restrictions .
CampaignPrimaryStatusReason	New enum values	Added CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED , and BOOKING_CANCELLED to provide primary status reasons for campaigns with the FIXED_CPM bidding strategy.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	New fields	Added support for reservation ad category self disclosure and read-only booking details.
Campaign.missing_eu_political_advertising_declaration	New field	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.
تبدیل‌ها
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	New enum value	Supports tracking users who watch an ad and later watch a video from the same channel.
عمومی
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	New enum value / error	Returned when attempting to target only the undetermined category in demographics dimensions.
مشوق‌ها
IncentiveErrorEnum	New enum values / errors	Added two new error codes: MAX_INCENTIVES_REDEEMED and ACCOUNT_TOO_OLD . These errors can be returned for requests made on or after March 11, 2026.
برنامه‌ریزی
GenerateBenchmarksMetrics	ویژگی جدید	Added support for date breakdowns using a BreakdownDefinition .
ReachPlanService.GenerateReachForecast	New enum value	Added GOOGLE_DISPLAY_NETWORK as a targetable surface for Demand Gen Max Conversions.
GenerateTrendingInsights	New fields	Added historical trend line information in TrendInsightDataPoint to TrendInsights when searching by topic.
گزارش‌ها
Unique user frequency metrics	New fields	Added new metrics that report how many users saw your ad at least two, three, four, five or ten times: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus , and unique_users_ten_plus .
SearchTermMatchSource	New enum value	Added VERTICAL_ADS_DATA_FEED to support vertical ad data feeds, such as Travel Ads entity targeting.
YouTubeVideoUpload
YouTubeVideoUpload	New service / resource	Added the YouTubeVideoUpload service to support uploading and managing videos on YouTube, and the YouTubeVideoUpload resource to support fetching upload status and metadata. This feature is only supported for REST and the Python client library.

v23 (2026-01-28)

The following new features, updates, and breaking changes were added in Google Ads API v23, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
تبلیغات
Ad sharing permitted	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Behavioral shift	Ad sharing among multiple ad groups is no longer permitted. Requests attempting to share ads will return an AD_SHARING_NOT_ALLOWED error.
Support for CallAd and CallAdInfo	هیچکدام	Removal	Support for call ads has been removed. Refer to the About call ads help center article.
کمپین‌ها
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Rename / replacement	Use the new date-time fields to specify time components for campaigns. The original date-only fields are removed.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only	هیچکدام	Removal	The lead_form_only field has been removed. Update references in your code.
گزارش‌ها
Aggregate asset performance label metrics and enum	هیچکدام	Removal	Removed aggregate asset performance label metrics. The performance label enum is no longer returned for Search and Display.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
تبلیغات
AdFormatType	New enum values	Added new format types: TEXT , VERTICAL_ADS_BOOKING_LINK , and VERTICAL_ADS_PROMOTION .
دارایی‌ها
asset_group view	New fields	Added the following metrics: metrics.engagements , metrics.engagement_rate , and metrics.average_cpe .
asset_group_asset view	New fields	Added the following metrics: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , and metrics.interaction_event_types .
Asset.orientation	New field	Read-only orientation field added to image and video assets.
CampaignAsset	ویژگی جدید	Added support to retrieve campaign assets with field_type set to HEADLINE and DESCRIPTION .
ServedAssetFieldType	New enum values	Added HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , and DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO for assets served as sitelinks.
BusinessMessageAsset	New features / support	Updated Business Message assets: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
صورتحساب
InvoiceService.ListInvoices	New options	Can now return more granular details in Invoice , including campaign-level cost breakdown, itemized regulatory costs, and adjustment information, by setting include_granular_level_invoice_details in ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	New enums	Added helper enums for regulatory fees and units of measure.
کمپین‌ها
CampaignError	New enum values / errors	Added DURATION_TOO_LONG_FOR_TOTAL_BUDGET and END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET error codes.
تبدیل‌ها
ConversionActionCategory	New enum value	Added YOUTUBE_FOLLOW_ON_VIEWS to support tracking users who watch an ad and later watch a video from the same channel.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner	New field	Added support for companion banners in Demand Gen responsive video ads.
مشوق‌ها
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.
برنامه‌ریزی
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	New enum value	Allows building audiences using Life Events in GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , and GenerateCreatorInsights . Life Events are not supported for other AudienceInsightsService methods such as AudienceInsightsService.GenerateAudienceOverlap and AudienceInsightsService.GenerateTargetingSuggestionMetrics .
ReachPlanService.GenerateConversionRates	New fields / options	The response now includes surfaces to support conversion rate suggestions based on surface controls (eg, Gmail, Shorts). Only supported for Demand Gen campaigns.
LanguageDistribution	New field / type	Added to YouTubeChannelInsights to provide language distribution details in YouTube channel content.
BenchmarksService	سرویس جدید	Compares YouTube advertisement data against industry benchmarks.
AudienceInsightsService.GenerateAudienceDefinition	New method	Translates a free text description of a target audience into matching audience attributes using generative AI.
YouTubeChannelInsights.relevance_score	New field	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	New field	Represents the percentage change in a trend's value over the comparison period.
توصیه‌ها
GenerateRecommendationsRequest	New field	Added is_new_customer . When set to true for CAMPAIGN_BUDGET recommendations, it uses a model optimized for new customers (only recommended for customers with no campaigns).
گزارش‌ها
AdGroupAdAssetView	New feature / metrics support	Now supports impression, performance, and conversion metrics for RESPONSIVE_DISPLAY_AD .
ad_sub_network_type segment	New segment	Provides granular performance breakdown within an ad network. Initially available for Demand Gen campaigns on YouTube (In-stream, In-feed, Shorts). Must be selected along with ad_network_type .
Performance Max reporting	ویژگی جدید	Enabled ad network type breakdown for Performance Max campaigns.
UserLocationView GeographicView	New segments support	Support metrics segmented by conversion date: 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 , and cross_device_conversions_value_by_conversion_date .
Vertical ads segments	New segments	Added the following segments: 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 , and vertical_ads_vertical .
PerStoreView MatchedLocationInterestView	New reporting resources	Added PerStoreView to query store location details, and MatchedLocationInterestView (for AI Max campaigns) to provide performance metrics by geographic locations of interest.
خرید
ShoppingPerformanceView	New metrics support	Now supports the following metrics segmented by conversion date: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , and value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView	New metrics support	Added support for: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share , and search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri	New field	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	New field	Allows control over which ad formats can serve in Search campaigns using travel feeds.
AdGroupCriterion SharedCriterion	New fields / criteria	Added vertical_ads_item_group_rule_list criterion type to AdGroupCriterion and vertical_ads_item_group_rule to SharedCriterion to permit targeting item groups in Search campaigns with travel feeds.
Vertical ads data feed integration	ویژگی جدید	Can now connect a vertical ads data feed to a search campaign running AI Max to show property promotion and booking link travel ads alongside text ads. Control formats with vertical_ads_format_setting and define rules using vertical_ads_item_group_rule . Segment reporting by AdFormatType and vertical ads data feed dimensions.
ویدیوها
AdVideoAssetInfo.ad_video_asset_feature_control	New field	Added feature control options for video ad assets.
CampaignCriterionError	New enum value / error	Added the INVALID_VIDEO_LINEUP_ID error code.
YouTube audibility metrics	New metrics	Added audibility metrics for audio ads on YouTube, reporting whether an ad was audible and on how many impressions audibility could be measured.

v22 major and minor versions

Google Ads API v22 includes the following new features, updates, and breaking changes.

v22.2 (2026-06-24)

The following new features and updates were added in Google Ads API v22.2. Minor versions like v22.2 don't contain breaking changes.

Features and updates	نوع	توضیحات
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems). To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-party approvals	ویژگی‌های جدید	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

v22.1 (2026-02-25)

The following new feature was added in Google Ads API v22.1. Minor versions like v22.1 don't contain breaking changes.

Features and updates	نوع	توضیحات
مدیریت حساب
Customer.contains_eu_political_advertising	New field	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
کمپین‌ها
Campaign.missing_eu_political_advertising_declaration	New field	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v22 (2025-10-15)

The following new features, updates, and breaking changes were added in Google Ads API v22, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Rename / spelling fix	Rename references to use the corrected field name.
عمومی
No operations limit in AddBatchJobOperations	10,000 operations limit per request	Behavioral shift	Ensure that no single AddBatchJobOperations request contains more than 10,000 operations.
Silently capped page size at 1,000 in ListBatchJobResultsRequest	Returns INVALID_PAGE_SIZE error	Behavioral shift	Ensure ListBatchJobResultsRequest.page_size is set to 1,000 or less, as requesting a larger page size will now result in an error.
Performance Max
Asset performance labels	هیچکدام	Removal	Asset performance labels support and the associated performance label enum have been removed for Performance Max campaigns. Update integrations accordingly.
Campaign.url_expansion_opt_out	FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION flag in AssetAutomationSetting	Removal / replacement	Use the final URL expansion text asset automation setting. The Campaign-level URL expansion opt-out field is removed.
برنامه‌ریزی
views	trueview_views	Removal / replacement	Replace references to views with the new trueview_views field in ReachPlanService .
ویدیوها
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	Renames	Update query strings and integrations to use the new metric names representing TrueView video views.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
دارایی‌ها
AssetFieldType.LANDING_PAGE_PREVIEW	New enum value	Added as a new image asset field type.
AssetGenerationService	New service (Beta)	Allows generating text and image assets using generative AI: GenerateText : Generates text based on final URL, prompts, keywords, etc. GenerateImages : Generates images based on final URL, prompts, or recontextualizing product images. Errors are returned with codes from AssetGenerationError . Initially available only to a limited set of closed beta participants.
کمپین‌ها
AppCampaignBiddingStrategyGoalType	New enum values	Added new goals for App campaigns for installs (ACi) to optimize without specifying a target: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : Use with standard Maximize Conversions. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : Use with standard Maximize Conversion Value.
BiddingStrategyType	ویژگی جدید	Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types	New field	Shows the types of feeds attached to a campaign. For Performance Max campaigns, this can indicate the business vertical, such as MERCHANT_CENTER_FEED for retail.
Shared set targeting	ویژگی جدید	Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Demand Gen
TargetCPC bidding	ویژگی جدید	Added bidding strategy to maximize clicks at target CPC: set campaign-level target CPC using Campaign.target_cpc and override at ad group level using AdGroup.target_cpc_micros .
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	New enum value	If enabled for DemandGenMultiAssetAdInfo , this adds design elements and embeds text assets into image assets to create new image assets with different aspect ratios (enabled by default).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	New enum value	If enabled for DemandGenMultiAssetAdInfo , it generates videos using other assets like images and text, which can then be used to create new DemandGenVideoResponsiveAdInfo instances (enabled by default).
عمومی
ListBatchJobResultsRequest page size fallback	Behavioral change	If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE ).
QuotaError	New enum value / error	Added PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when payment profile activation rate limit is exceeded.
Performance Max
Asset automation settings	New enum values	Added new PMax asset automation options: GENERATE_IMAGE_ENHANCEMENT : Enables automatic creation of enhanced images (auto-cropping). Enabled by default. GENERATE_IMAGE_EXTRACTION : Sourced images from final URLs. Defaults to account Dynamic Image Extension setting.
PMax reporting segments	New segments	Added new segments unique to Performance Max campaigns: ad_using_product_data : Indicates if an ad uses Google Merchant Center product data. ad_using_video : Indicates if an ad uses a video asset.
برنامه‌ریزی
CRM partner data lists	New feature / enum value	Added THIRD_PARTY_PARTNER_DATA to CRM data sources, along with partner audience validation error codes (such as tos acceptance, Link missing, etc.).
Livestream creator metrics	New field	Added YouTubeMetrics.is_active_live_stream_creator , returned by creator insights to indicate if a creator published a livestream in the past 90 days.
Plannable CRM source metadata	پیام جدید	Added PlannableUserListMetadata inside PlannableUserList , returned by ReachPlanService.ListPlannableUserLists , to show CRM data source types.
Support for related videos and creators in TrendInsight	New fields	Added support for related_videos and related_creators on TrendInsight , and watch properties in video_properties and publish_date .
InsightsFinder improvements	ویژگی جدید	GenerateInsightsFinderReport now supports parental_status , income_ranges , and more complex AND/OR targeting combinations.
گزارش‌ها
New click types	New enum values	Added CLICK_TO_MESSAGE_THIRD_PARTY_CLICK and CLICK_TO_MESSAGE_LANDING_PAGE_CLICK .
AssetGroupAsset segmentation	New segments support	AssetGroupAsset is now segmentable by device , conversion_action , conversion_action_name , and conversion_action_category .
RSAs in AdGroupAdAssetView	New feature / metrics support	AdGroupAdAssetView now fully supports performance and conversion metrics for RESPONSIVE_SEARCH_AD (previously only impressions were returned).
Exploration query cluster metric segmentations	New segments support	Metrics clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters are now segmentable by date fields.
TargetingExpansionView	New reporting resource	Added TargetingExpansionView to report metrics for expansions over manual targeting, such as keywordless expansion for AI Max for Search Campaigns.
خرید
Shopping scope fix	Bug fix	Fixed the campaign and ad group scoping of metrics in the ShoppingProduct resource.
Unified goals
Retention goals	ویژگی جدید	Added support for customer retention goals to optimize for re-engaging existing customers (eg, using target_option with TARGET_SPECIFIC or TARGET_ALL ).
ویدیوها
Video watch time metrics	New fields	Added watch time duration metrics: video_watch_time_duration_millis (total duration) and average_video_watch_time_duration_millis (average duration per impression).

Archived release notes

See Sunsetted versions for archived release notes.