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

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

نسخه‌های اصلی و فرعی 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_input (اعلان‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه می‌شوند) و system_input (گواهی‌هایی که به‌طور خودکار توسط سیستم شناسایی یا ارائه می‌شوند) تقسیم می‌شوند. این ویژگی به نسخه‌های ۲۳ و ۲۲ بک‌پورت شده است. برای کمک به شما در برنامه‌ریزی کارهای ادغام آینده‌تان برای نسخه ۲۵، رابط کاربری برای تغییر فیلدهای گواهی تبلیغ‌کننده برای نسخه ۲۲ و بالاتر، زودتر معرفی می‌شود. این رابط کاربری در این نسخه‌ها قابل مشاهده است، اما 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 .
معیارهای آزمایش کنترل/درمان	فیلدهای جدید	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 برای تخمین تفاضل مطلق با استفاده از تخمین نقطه‌ای، حاشیه خطا و فیلدهای مقدار 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	ویژگی جدید	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.

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

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در 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 حذف شده است. ارجاعات را در کد خود به‌روزرسانی کنید.
گزارش‌ها
معیارهای برچسب عملکرد دارایی و شمارش تجمیعی	هیچکدام	حذف	معیارهای برچسب عملکرد دارایی‌های تجمیعی حذف شدند. شمارش برچسب عملکرد دیگر برای جستجو و نمایش بازگردانده نمی‌شود.

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
تبلیغات
AdFormatType	مقادیر شمارشی جدید	انواع قالب‌های جدید اضافه شد: TEXT ، VERTICAL_ADS_BOOKING_LINK و VERTICAL_ADS_PROMOTION .
دارایی‌ها
asset_group	فیلدهای جدید	معیارهای زیر اضافه شد: metrics.engagements ، metrics.engagement_rate و metrics.average_cpe .
نمای asset_group_asset	فیلدهای جدید	معیارهای زیر اضافه شد: metrics.average_cpe ، metrics.average_cpm ، metrics.trueview_average_cpv ، metrics.video_trueview_view_rate ، metrics.video_trueview_views و metrics.interaction_event_types .
Asset.orientation	میدان جدید	فیلد جهت‌یابی فقط خواندنی به تصاویر و ویدیوها اضافه شد.
CampaignAsset	ویژگی جدید	پشتیبانی برای بازیابی دارایی‌های کمپین با تنظیم field_type روی HEADLINE و DESCRIPTION اضافه شد.
ServedAssetFieldType	مقادیر شمارشی جدید	برای داده‌هایی که به عنوان لینک سایت استفاده می‌شوند، HEADLINE_AS_SITELINK_POSITION_ONE ، HEADLINE_AS_SITELINK_POSITION_TWO ، DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE و DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO اضافه شد.
BusinessMessageAsset	ویژگی‌های جدید/پشتیبانی	فایل‌های پیام تجاری به‌روزرسانی‌شده: پشتیبانی از فیسبوک مسنجر و زالو به عنوان ارائه دهنده اضافه شد. FACEBOOK_MESSENGER و ZALO به BusinessMessageProvider اضافه شدند. فیلدهای facebook_messenger_info و zalo_info اضافه شدند. خطای CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS به AssetError اضافه شد.
صورتحساب
InvoiceService.ListInvoices	گزینه‌های جدید	اکنون می‌توان با تنظیم include_granular_level_invoice_details در Invoice ، جزئیات جزئی‌تری از جمله جزئیات هزینه در سطح کمپین، هزینه‌های نظارتی جزئی‌شده و اطلاعات تعدیل را در ListInvoicesRequest بازگرداند.
RegulatoryFeeType UnitOfMeasure	enum های جدید	شمارنده‌های کمکی برای هزینه‌های نظارتی و واحدهای اندازه‌گیری اضافه شد.
کمپین‌ها
CampaignError	مقادیر/خطاهای جدید enum	کدهای خطای DURATION_TOO_LONG_FOR_TOTAL_BUDGET و END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET اضافه شد.
تبدیل‌ها
دسته بندی اقدام تبدیل	مقدار شمارشی جدید	قابلیت YOUTUBE_FOLLOW_ON_VIEWS برای پشتیبانی از ردیابی کاربرانی که یک تبلیغ را تماشا می‌کنند و بعداً ویدیویی از همان کانال را تماشا می‌کنند، اضافه شد.
تقاضای ژنرال
DemandGenVideoResponsiveAdInfo.companion_banner	میدان جدید	پشتیبانی از بنرهای همراه در تبلیغات ویدیویی واکنش‌گرای Demand Gen اضافه شد.
مشوق‌ها
پشتیبانی از مشوق‌های «خودت را انتخاب کن» (CYO) اضافه شد: متد FetchIncentive برای بازیابی مشوق‌های شخصی‌سازی‌شده‌ی موجود برای یک کاربر اضافه شد. متد ApplyIncentive برای اعمال یک انگیزه انتخاب شده به حساب مشتری اضافه شد. منبع AppliedIncentive (قابل پرس‌وجو با استفاده از Search و SearchStream ) برای ارائه جزئیات بازخرید اضافه شد. کدهای خطای جدیدی در IncentiveError و AuthenticationError.INVALID_EMAIL_ADDRESS اضافه شد. برای تسهیل مدیریت دقیق‌تر و جزئی‌تر خطاها در برنامه‌ها، در نسخه‌های آینده کدهای خطای بیشتری به IncentivesService اضافه خواهیم کرد. توصیه می‌کنیم اطلاعیه‌ها و یادداشت‌های انتشار آتی را برای این کدهای خطای جدید زیر نظر داشته باشید تا مطمئن شوید برنامه‌های شما می‌توانند این حالت‌های جدید خطا را مدیریت کنند.
برنامه‌ریزی
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	مقدار شمارشی جدید	امکان ایجاد مخاطب با استفاده از رویدادهای زندگی در GenerateAudienceCompositionInsights ، GenerateSuggestedTargetingInsights ، GenerateInsightsFinderReport و GenerateCreatorInsights را فراهم می‌کند. رویدادهای زندگی برای سایر متدهای AudienceInsightsService مانند AudienceInsightsService.GenerateAudienceOverlap و AudienceInsightsService.GenerateTargetingSuggestionMetrics پشتیبانی نمی‌شوند.
ReachPlanService.GenerateConversionRates	فیلدها/گزینه‌های جدید	این پاسخ اکنون شامل سطوحی برای پشتیبانی از پیشنهادهای نرخ تبدیل بر اساس کنترل‌های سطحی (مثلاً Gmail، Shorts) است. فقط برای کمپین‌های Demand Gen پشتیبانی می‌شود.
LanguageDistribution	فیلد/نوع جدید	به YouTubeChannelInsights اضافه شد تا جزئیات توزیع زبان در محتوای کانال YouTube را ارائه دهد.
BenchmarksService	سرویس جدید	داده‌های تبلیغات یوتیوب را با معیارهای صنعت مقایسه می‌کند.
AudienceInsightsService.GenerateAudienceDefinition	روش جدید	با استفاده از هوش مصنوعی مولد، توصیف متنی رایگان از مخاطب هدف را به ویژگی‌های منطبق با مخاطب ترجمه می‌کند.
YouTubeChannelInsights.relevance_score	میدان جدید	میزان مرتبط بودن یک خالق محتوا را با توجه به تعداد بازدیدها، برای موضوعی که به آن اشاره شده است، ارزیابی می‌کند.
TrendInsightMetrics.trend_change_percent	میدان جدید	نشان دهنده درصد تغییر در مقدار یک روند در طول دوره مقایسه است.
توصیه‌ها
GenerateRecommendationsRequest	میدان جدید	is_new_customer اضافه شد. وقتی برای توصیه‌های CAMPAIGN_BUDGET روی true تنظیم شود، از مدلی استفاده می‌کند که برای مشتریان جدید بهینه شده است (فقط برای مشتریانی که هیچ کمپینی ندارند توصیه می‌شود).
گزارش‌ها
AdGroupAdAssetView	پشتیبانی از ویژگی‌ها/معیارهای جدید	اکنون از معیارهای نمایش، عملکرد و تبدیل برای RESPONSIVE_DISPLAY_AD پشتیبانی می‌کند.
بخش ad_sub_network_type	بخش جدید	تجزیه و تحلیل عملکرد جزئی در یک شبکه تبلیغاتی را ارائه می‌دهد. در ابتدا برای کمپین‌های Demand Gen در یوتیوب (درون پخش، درون فید، ویدیوهای کوتاه) در دسترس است. باید همراه با ad_network_type انتخاب شود.
گزارش حداکثر عملکرد	ویژگی جدید	تفکیک نوع شبکه تبلیغاتی برای کمپین‌های Performance Max فعال شد.
UserLocationView GeographicView	پشتیبانی از بخش‌های جدید	از معیارهای تقسیم‌بندی‌شده بر اساس تاریخ تبدیل پشتیبانی می‌کند: conversions_by_conversion_date ، all_conversions_by_conversion_date ، conversions_value_by_conversion_date ، all_conversions_value_by_conversion_date ، value_per_conversions_by_conversion_date ، value_per_all_conversions_by_conversion_date ، cross_device_conversions_by_conversion_date ، و cross_device_conversions_value_by_conversion_date .
بخش‌های تبلیغات عمودی	بخش‌های جدید	بخش‌های زیر اضافه شد: vertical_ads_event_participant_display_names ، vertical_ads_hotel_class ، vertical_ads_listing ، vertical_ads_listing_brand ، vertical_ads_listing_city ، vertical_ads_listing_country ، vertical_ads_listing_region ، vertical_ads_partner_account و vertical_ads_vertical .
PerStoreView MatchedLocationInterestView	منابع گزارشگری جدید	PerStoreView برای جستجوی جزئیات مکان فروشگاه و MatchedLocationInterestView (برای کمپین‌های AI Max) برای ارائه معیارهای عملکرد بر اساس مکان‌های جغرافیایی مورد نظر اضافه شد.
خرید
ShoppingPerformanceView	پشتیبانی از معیارهای جدید	اکنون از معیارهای زیر که بر اساس تاریخ تبدیل تقسیم‌بندی شده‌اند پشتیبانی می‌کند: conversions_by_conversion_date ، all_conversions_by_conversion_date ، conversions_value_by_conversion_date ، و value_per_conversions_by_conversion_date ، value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView	پشتیبانی از معیارهای جدید	پشتیبانی از موارد زیر اضافه شد: search_budget_lost_impression_share ، search_rank_lost_impression_share ، search_budget_lost_absolute_top_impression_share ، و search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri	میدان جدید	به ShoppingProduct اضافه شد.
تبلیغات عمودی
AdGroup.vertical_ads_format_setting	میدان جدید	امکان کنترل قالب‌های تبلیغاتی که می‌توانند در کمپین‌های جستجو با استفاده از فیدهای مسافرتی ارائه شوند را فراهم می‌کند.
AdGroupCriterion SharedCriterion	فیلدها/معیارهای جدید	نوع معیار vertical_ads_item_group_rule_list به AdGroupCriterion و vertical_ads_item_group_rule به SharedCriterion اضافه شد تا امکان هدف‌گیری گروه‌های کالا در کمپین‌های جستجو با فیدهای مسافرتی فراهم شود.
ادغام فید داده‌های تبلیغات عمودی	ویژگی جدید	اکنون می‌توانید یک فید داده تبلیغات عمودی را به یک کمپین جستجو که AI Max را اجرا می‌کند متصل کنید تا تبلیغات مسافرتی لینک‌های تبلیغ ملک و رزرو را در کنار تبلیغات متنی نمایش دهد. قالب‌ها را با vertical_ads_format_setting کنترل کنید و با استفاده از vertical_ads_item_group_rule قوانین را تعریف کنید. گزارش‌دهی بخش‌بندی شده بر اساس AdFormatType و ابعاد فید داده تبلیغات عمودی.
ویدیوها
AdVideoAssetInfo.ad_video_asset_feature_control	میدان جدید	گزینه‌های کنترل ویژگی برای دارایی‌های تبلیغات ویدیویی اضافه شد.
CampaignCriterionError	مقدار / خطای شمارشی جدید	کد خطای INVALID_VIDEO_LINEUP_ID اضافه شد.
معیارهای شنیداری یوتیوب	معیارهای جدید	معیارهای سنجش میزان شنیداری بودن تبلیغات صوتی در یوتیوب اضافه شد که گزارش می‌داد آیا یک تبلیغ شنیداری است و میزان شنیداری بودن آن بر اساس تعداد دفعات نمایش قابل اندازه‌گیری است.

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

نسخه ۲۲ رابط برنامه‌نویسی کاربردی گوگل ادز (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 نسخه ۲۲.۱ اضافه شده است. نسخه‌های فرعی مانند نسخه ۲۲.۱ شامل تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
مدیریت حساب
Customer.contains_eu_political_advertising	میدان جدید	وضعیت اعلان سطح حساب را بازیابی می‌کند که آیا حاوی تبلیغات سیاسی هدفمند علیه اتحادیه اروپا است یا خیر، و یک EuPoliticalAdvertisingStatus برمی‌گرداند.
کمپین‌ها
Campaign.missing_eu_political_advertising_declaration	میدان جدید	از جستجو و فیلتر کردن کمپین‌هایی که فاقد اعلامیه‌هایی در مورد وجود تبلیغات سیاسی هدفمند علیه اتحادیه اروپا هستند، پشتیبانی می‌کند.

نسخه ۲۲ (۲۰۲۵-۱۰-۱۵)

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

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

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

حالت اولیه	ایالت جدید	نوع تغییر	راهنمای پیاده‌سازی
تقاضای ژنرال
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	تغییر نام / اصلاح املا	نام ارجاعات را تغییر دهید تا از نام فیلد اصلاح‌شده استفاده شود.
عمومی
هیچ محدودیتی برای عملیات در AddBatchJobOperations وجود ندارد	محدودیت ۱۰،۰۰۰ عملیات در هر درخواست	تغییر رفتاری	مطمئن شوید که هیچ درخواست AddBatchJobOperations شامل بیش از 10،000 عملیات نباشد.
اندازه صفحه به طور نامحسوس در ListBatchJobResultsRequest به ۱۰۰۰ محدود می‌شود	خطای INVALID_PAGE_SIZE را برمی‌گرداند	تغییر رفتاری	مطمئن شوید که ListBatchJobResultsRequest.page_size روی ۱۰۰۰ یا کمتر تنظیم شده باشد، زیرا درخواست اندازه صفحه بزرگتر اکنون منجر به خطا خواهد شد.
حداکثر عملکرد
برچسب‌های عملکرد دارایی	هیچکدام	حذف	پشتیبانی از برچسب‌های عملکرد دارایی و شمارش برچسب عملکرد مرتبط برای کمپین‌های Performance Max حذف شده‌اند. بر این اساس، ادغام‌ها را به‌روزرسانی کنید.
Campaign.url_expansion_opt_out	پرچم FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION در AssetAutomationSetting	حذف / جایگزینی	از آخرین تنظیمات اتوماسیون متن گسترش URL استفاده کنید. فیلد انصراف از گسترش URL در سطح کمپین حذف می‌شود.
برنامه‌ریزی
views	trueview_views	حذف / جایگزینی	ارجاعات به views را با فیلد جدید trueview_views در 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	تغییر نام‌ها	رشته‌های پرس‌وجو و یکپارچه‌سازی‌ها را به‌روزرسانی کنید تا از نام‌های معیار جدید که نشان‌دهنده‌ی تعداد بازدیدهای ویدیویی TrueView هستند، استفاده کنند.

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	توضیحات
دارایی‌ها
AssetFieldType.LANDING_PAGE_PREVIEW	مقدار شمارشی جدید	به عنوان یک نوع فیلد دارایی تصویر جدید اضافه شد.
AssetGenerationService	سرویس جدید (نسخه بتا)	امکان تولید متن و تصویر با استفاده از هوش مصنوعی مولد: GenerateText : متن را بر اساس URL نهایی، درخواست‌ها، کلمات کلیدی و غیره تولید می‌کند. GenerateImages : تصاویر را بر اساس URL نهایی، اعلان‌ها یا تصاویر محصول با تغییر بافت، تولید می‌کند. خطاها با کدهایی از AssetGenerationError برگردانده می‌شوند. در ابتدا فقط برای تعداد محدودی از شرکت‌کنندگان در نسخه بتای بسته در دسترس بود.
کمپین‌ها
AppCampaignBiddingStrategyGoalType	مقادیر شمارشی جدید	اهداف جدیدی برای کمپین‌های اپلیکیشن برای نصب (ACi) اضافه شده است تا بدون مشخص کردن هدف، بهینه‌سازی شوند: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : با تبدیل‌های حداکثری استاندارد استفاده می‌شود. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : با حداکثرسازی مقدار تبدیل استاندارد استفاده می‌شود.
BiddingStrategyType	ویژگی جدید	پشتیبانی از سهم ثابت نوع استراتژی پیشنهاد قیمت صوتی اضافه شد.
Campaign.feed_types	میدان جدید	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.
تقاضای ژنرال
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.
حداکثر عملکرد
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	میدان جدید	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	رفع اشکال	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).

v21 major and minor versions

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

v21.2 (2026-06-24)

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

Features and updates	نوع	توضیحات
عمومی
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.

v21.1 (2026-02-25)

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

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

v21 (2025-08-06)

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

See Upgrade to the latest version for guidance.

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

حالت اولیه	New state	نوع تغییر	Implementation guidance
کمپین‌ها
Returns CriterionError.INVALID_LISTING_GROUP_HIERARCHY	Returns CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION	Error code change	For requests with a partial failure enabled, handle the new error code instead of the original hierarchy error code.
تبدیل‌ها
Access to debug_enabled mode in ConversionUploadService	هیچکدام	حذف	The debug_enabled field is removed. Update code referencing it to not set or query this parameter.
EU political advertising changes
Optional campaign self-declarations for EU political advertising	Required contains_eu_political_advertising field for new campaigns	Validation rule / behavioral shift	API calls to create new campaigns will fail with a FieldError.REQUIRED error if this field is not set. Starting September 22, 2025, campaigns declared as CONTAINS_EU_POLITICAL_ADVERTISING will no longer serve in the EU.
Modifiable criteria without self-declaration	Fails updates with CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Validation rule / behavioral shift	Set the self-declaration status before attempting to create or update campaign- or ad group-level proximity, location, or location group targeting criteria for existing campaigns.
Experiments without self-declaration requirements	Fails updates with ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Validation rule / behavioral shift	Ensure that the self-declarations have been completed on the experiment's campaigns.
حداکثر عملکرد
brand_guidelines_enabled defaults to false	Defaults to true	Behavioral shift	For new Performance Max campaigns, brand guidelines are enabled by default. Explicitly set the field to false if they should be disabled.
برنامه‌ریزی
Original input argument type for AudienceInsightsService.GenerateTargetingSuggestionMetrics	Input of type InsightsAudience	Type change	Update implementations to pass the new input type which supports an AND-of-ORs combination of user interests, permitting potential reach metrics for custom audience definitions.

Features and updates (non-breaking)

Features and updates	نوع	توضیحات
AI Max for Search campaigns
ai_max_setting.enable_ai_max in Campaign	میدان جدید	Enables AI Max to expand search term matching (respecting previous text asset automation and brand lists until toggled off). The field Campaign.ai_max_setting.bundling_required indicates if AI Max must be enabled to respect/modify those settings, and AdGroup.ai_max_ad_group_setting.disable_search_term_matching can disable matching at the ad group level. See Unlock next-level performance with AI Max for Search campaigns .
CampaignError.AI_MAX_MUST_BE_ENABLED	New enum value / error	Thrown when opting in to URL expansion text asset automation in Search campaigns without enabling AI Max.
Ad group level targeting	ویژگی جدید	Support added in AI Max for Search campaigns for brand lists, locations, and webpages (URL rules) at the ad group level.
ai_max_search_term_ad_combination_view	New reporting resource	Reports performance on combinations of search terms, headlines, and landing pages.
search_term_match_type segment	New enum value	Added AI_MAX as a search term match type option.
دارایی‌ها
PromotionAsset	New fields	Added terms_and_conditions_text , terms_and_conditions_uri , and oneof promotion_trigger options ( promotion_barcode_info , promotion_qr_code_info ). See About promotion assets .
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	New enum value	Added to AssetAutomationType to control automated text and landing page generation from final URLs in Search campaigns.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset	New service / method	Allows removing automatically created final URL expansion assets from campaigns.
ServedAssetFieldType.DESCRIPTION_PREFIX	New enum value	Added to correct a reporting issue where the type was returned as UNKNOWN in ad_group_ad_asset_combination_view .
کمپین‌ها
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING	New enum value	Returned when location-restricted campaigns lack location targeting (which now throws LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN if targeted outside the allowed area).
Third-party app analytics integration	New fields	Added support for VideoCustomer.third_party_integration_partners and Campaign.third_party_integration_partners . See Track app conversions with third-party app analytics .
Campaign.advertising_partner_ids	New field support	The field can now be set for existing campaigns (remains immutable after being set).
Manager-level negative placements	ویژگی جدید	Allows exclusions of placement lists across individual advertiser accounts using CustomerNegativeCriterion .
Tolerance configurations in target ROAS strategies	New fields	Added support for TargetRoas.target_roas_tolerance_percent_millis (for Search campaign portfolio strategies) in MaximizeConversionValue and TargetRoas .
LocationInterestView	New reporting resource	Summarizes performance of ad group location interest criteria.
تبدیل‌ها
conversion_attribution_event_type segment	New enum value	Added ENGAGED_VIEW to conversion attribution type options.
تقاضای ژنرال
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM	New enum value / error	Added in preparation for enforcing minimum daily budgets for Demand Gen campaigns. Details are exposed using budgetDailyMinimumErrorDetails .
حداکثر عملکرد
campaign_search_term_view	New reporting resource	Aggregates search terms metrics at the campaign level, enabling search term analysis and reporting for Performance Max.
برنامه‌ریزی
ReachPlanService.ListPlannableUserInterests	New method	Allows discovering plannable affinities and in-market interests for generateReachForecast .
AdditionalApplicationInfo	میدان جدید	Added as an optional input in ReachPlanService.ListPlannableUserLists .
AudienceInsights attributes listing	ویژگی جدید	AudienceInsightsService.ListAudienceInsightsAttributes now fetches available 1P user lists.
AudienceCompositionInsights targeting CRM lists	ویژگی جدید	AudienceInsightsService.GenerateAudienceCompositionInsights now returns user list index details for AudienceInsightsDimension dimensions: AGE_RANGE , GENDER , AFFINITY_USER_INTEREST , and IN_MARKET_USER_INTEREST .
TrendInsightMetrics audience share	میدان جدید	Represents the share of an audience for a trend.
KnowledgeGraphAttributeMetadata categories	New fields	Filters Knowledge Graph attributes by matching categories.
گزارش‌ها
Asset views metrics	New features / metrics	Added multiple new metrics to AssetGroupAsset , ChannelAggregateAssetView , and CampaignAggregateAssetView . PMax campaigns also now report true values for impressions .
Selector extensions	ویژگی جدید	Made AssetSet and CampaignAssetSet queryable together inside ChangeStatus .
search_term_targeting_status	New segment	Selectable segment in the campaign search term view.
final_url_expansion_asset_view	New reporting resource	Reports final URL expansion asset performance details.
AssetGroup value adjustments	New fields	Added support for value_adjustment and all_value_adjustment metrics in the AssetGroup report.
landing_page_source	New segment	Provides a landing page source segment in landing_page_view .
search_term_match_source	New segment	Selectable segment in the search term and campaign search term views.
match_type	New segment	Selectable segment key in the keyword view.
Unique query intent clusters reporting	New fields	Added clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters to report unique query intent clusters.
ClickType.VEHICLE_ASSETS	New enum value	Track and report clicks related specifically to vehicle ad formats in the click_view report.
Smart Bidding Exploration
tolerance configurations in Search strategies	New fields / settings	Allows enabling Smart Bidding Exploration on Search campaigns by setting target_roas_tolerance_percent_millis between 10,000 (10%) and 30,000 (30%) inclusive (Maximize Conversions requires target_roas setting). See our blog post on Smart Bidding Exploration and help center article .
diversity reporting compatibility	ویژگی جدید	Aggregated diversity reporting is now supported for the following metrics for unique query intent clusters. A time segmented view is available in the Google Ads UI: clicks_unique_query_clusters conversions_unique_query_clusters impressions_unique_query_clusters
ویدیوها
YouTubeVideoListAsset	New resource / field	Allows establishing links between campaigns and video list assets using Asset.youtube_video_list_asset . See Use related videos .
Insights metadata extensions	New fields	Added new metadata to YouTubeChannelInsights and YouTubeVideoAttributeMetadata .
Interactive click types	New enum values	Added click types: VIDEO_RELATED_VIDEOS_CLICK , VIDEO_CHANNEL_CLICK , and PRODUCT_ASSETS .
VideoAdInventoryControl.allow_non_skippable_in_stream	میدان جدید	Lets Video Responsive ads serve as non-skippable in-stream ads for campaigns mixing skip and non-skip formats.
Video sequencing settings	New fields	Added read-only sequencing configurations: Campaign.VideoCampaignSettings.video_ad_sequence and VideoAdSequenceStepSetting . See About video ad sequencing .
Video lineup targeting	New criterion type / field	Added VIDEO_LINEUP criterion type and corresponding field in CampaignCriterion and AdGroupCriterion . This feature is only available to accounts on the allowlist.
Content suitability placements views	New reporting resources	Added a Content Suitability report for both detail ( detail_content_suitability_placement_view ) and group ( group_content_suitability_placement_view ) levels. See About the 'Content suitability' report .

Archived release notes

See Sunsetted versions for archived release notes.