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

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

نسخه عمده v26

‫Google Ads API v26 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.

نسخه ۲۶ (‎۲۰۲۶/۱۰/۱۴)

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

برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.

تغییرات ناگهانی

حالت اولیه	وضعیت جدید	نوع تغییر	راهنمایی‌های پیاده‌سازی
پویش‌ها
فیلد اختیاری country_code در LocalServicesPmaxCampaignSettings	فیلد الزامی درطول ایجاد پویش «عملکرد بیشینه» خدمات محلی (LocalServicesPmaxCampaignSettings.country_code)	تغییر رفتاری	هنگام ایجاد پویش‌های «عملکرد بیشینه برای خدمات محلی»، مطمئن شوید که country_code (همراه با listing_id الزامی جدید) را مشخص کنید.
تبدیل‌ها
فیلد enhanced_conversions_for_leads_enabled در ConversionTrackingSetting (Customer.conversion_tracking_setting)	هیچ‌کدام	برداشتن	به‌جای آن از ConversionTrackingSetting.enablement_setting در Customer.conversion_tracking_setting برای بازرسی تنظیم «تبدیل‌های بهبودیافته» سطح حساب استفاده کنید.
هدف‌گیری
فیلدهای معیار ویژه هتل در AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window ‫hotel_length_of_stay (min_nights و max_nights) hotel_check_in_day hotel_check_in_date_range	فیلدهای معیار مستقل از عمودی در AdGroupBidModifier: user_set_dates از نوع UserSetDatesInfo advance_booking_window از نوع AdvanceBookingWindowInfo length_of_booking از نوع LengthOfBookingInfo (min_days و max_days) start_day_of_week از نوع StartDayOfWeekInfo start_date_range از نوع StartDateRangeInfo	تغییر نام / برداشتن	مرجع‌ها را به‌روز کنید تا از فیلدهای معیار مستقل از حوزه استفاده کنید، که از هدف‌یابی در حوزه‌های سفر فراتر از هتل‌ها (مثل «کارهایی که باید انجام دهید») پشتیبانی می‌کند. شناسه‌های معیار، رفتار هدف‌یابی، و اصلاح‌کننده‌های پیشنهاد قیمت موجود ثابت می‌مانند. مقادیر min_nights و max_nights همان‌طور که هستند به min_days و max_days منتقل می‌شوند.
HotelDateSelectionType و نوع segments.user_set_dates	DateSelectionType	تغییر نام / تغییر نوع	به‌جای HotelDateSelectionType از DateSelectionType استفاده کنید.
دلایل خطای ویژه هتل در CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	دلایل خطای مستقل از عمودی در CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	تغییر نام	مدیریت خطای به‌روزرسانی را بررسی کنید تا دلایل خطای جدید مستقل از عمودی را بررسی کنید.

ویژگی‌ها و به‌روزرسانی‌ها (غیرمخل)

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
دارایی‌ها
ارائه‌دهندگان پیام کسب‌وکار LINE و پیامک	فیلدهای جدید و مقادیر شمارشی	پشتیبانی از LINE و پیامک به‌عنوان ارائه‌دهندگان پیام در BusinessMessageAsset اضافه شد، ازجمله فیلدهای جدید BusinessMessageAsset.line_info و BusinessMessageAsset.sms_info به‌همراه BusinessMessageProvider.LINE و BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	مقدار enum جدید / خطا	به AssetGroupError اضافه شد تا نشان دهد چه زمانی دسته‌ای که در GoogleLocalServicesInfo (AssetGroup.google_local_services_info) مشخص شده است برای پویش‌های «عملکرد بیشینه» خدمات محلی پشتیبانی نمی‌شود.
پویش‌ها
ایجاد پویش «عملکرد بیشینه» برای «خدمات محلی»	ویژگی‌ها، فیلدها، و خطاهای جدید	PmaxCampaignSettings.local_services_enabled از OUTPUT_ONLY به IMMUTABLE به‌روزرسانی شد و به مشتریان خارجی «میانای برنامه‌سازی کاربردی» اجازه می‌دهد هنگام ایجاد پویش‌های جدید «عملکرد بیشینه خدمات محلی»، local_services_enabled = true را مشخص کنند. همچنین LocalServicesPmaxCampaignSettings.listing_id برای نمایش شناسه فهرستگان «نمایه کسب‌وکار Google» پیوندشده به پویش «عملکرد بیشینه» «خدمات محلی» (که درطول ایجاد پویش «عملکرد بیشینه» «خدمات محلی» به‌عنوان «الزامی» علامت‌گذاری شده است) اضافه شد و کد خطای CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID اضافه شد.
خطاهای اعتبارسنجی کمپین «خدمات محلی»	مقادیر enum و خطاهای جدید	خطاهای اعتبارسنجی جدیدی برای کمپین‌های «خدمات محلی» اضافه شد: ‫CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED ‫AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError و CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
اعتبارسنجی پیوند حساب Hotel Center	مقدار enum جدید / خطا	کد خطای CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED به CampaignError اضافه شد تا نشان دهد که پیوند دادن مجموعه دارایی ملک هتل (Campaign.hotel_property_asset_set) به پویش «عملکرد بیشینه» برای هدف‌های سفر به پیوند حساب Hotel Center فعال نیاز دارد.
حداقل بودجه «تولید تقاضا» در روز	فیلد جدید	فیلد demand_gen_info.minimum_budget_per_day_micros به CurrencyConstant اضافه شد، که حداقل بودجه موردنیاز در روز را برای پویش‌های «تولید تقاضا» به آن ارز مشخص می‌کند. وقتی حداقل بودجه‌ای که «میانای برنامه‌سازی کاربردی» اعمال می‌کند تغییر کند، مقدار این فیلد به‌روزرسانی می‌شود.
پیکربندی اندازه‌گیری بهینه‌گر برای پویش‌ها	فیلد جدید	Campaign.lift_measurement_config اضافه شد تا نام منبع پیکربندی سنجش بهینه‌گر پیوندشده به پویش را نشان دهد.
اعتبارسنجی آزمایش «بیشینه‌سازی هوشواره‌ای»	مقدار enum جدید / خطا	کد خطای ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED به ExperimentArmError اضافه شد، هنگام تلاش برای ایجاد آزمایش ADOPT_AI_MAX برای پویشی که قبلاً «بیشینه‌سازی هوشواره‌ای» در آن فعال شده است (یا در همان درخواست قبل‌از ایجاد شاخه آزمایش فعال شده است).
نوع فهرستگان پویش Shopping	پشتیبانی گسترده	پشتیبانی گسترده از Campaign.listing_type در پویش‌های Shopping.
به‌روزرسانی‌های خوداظهاری تبلیغات سیاسی اتحادیه اروپا	عملکرد به‌روزرسانی‌شده و فیلدهای جدید	Campaign.contains_eu_political_advertising اکنون برای برخی‌از پویش‌هایی که اتحادیه اروپا را به‌طور مثبت هدف‌یابی نمی‌کنند اختیاری است. به‌جز مواردی که برای DEMAND_GEN پویش با هدف‌یابی ارتقایافته ذکر شده است، اگر پویش پس‌از اجرای درخواست همه شرایط زیر را برآورده کند، این فیلد اختیاری است: فاقد معیار پویش مکان مثبت در اتحادیه اروپا است معیار پویش گروه مکان یا مجاورت مثبت ندارد حاوی حداقل یک معیار پویش مکان مثبت است که خارج از اتحادیه اروپا است برای DEMAND_GEN پویش با upgraded_targeting، اگر هر گروه آگهی فعال در پویش پس‌از اجرای درخواست، همه شرایط زیر را برآورده کند، این فیلد اختیاری است: معیار گروه آگهی مکان مثبتی که در اتحادیه اروپا باشد ندارد معیار گروه آگهی گروه مکان یا مجاورت مثبت ندارد حداقل یک معیار گروه آگهی مکان مثبت دارد که خارج از اتحادیه اروپا است این فیلد برای پویش‌هایی که گروه آگهی فعال ندارند نیز اختیاری است. اگر درخواستی گروه آگهی‌ای ایجاد کند که این شرایط را برآورده نکند، AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION برگردانده می‌شود. این تغییرات هم بر پویش‌های جدید و هم بر پویش‌های موجود اعمال می‌شود. در برخی موارد، پویش جدید فقط درصورتی می‌تواند ایجاد شود که معیارها در همان درخواست اضافه شده باشند — از GoogleAdsService.Mutate برای گروه‌بندی تغییرات استفاده کنید. Campaign.missing_eu_political_advertising_declaration به‌روز شد تا با تغییرات Campaign.contains_eu_political_advertising مطابقت داشته باشد. GeoTargetConstant.require_eu_political_advertising_declaration اضافه شد تا مشخص شود مکان در داخل یا خارج از اتحادیه اروپا است. CampaignCriterion.require_eu_political_advertising_declaration و AdGroupCriterion.require_eu_political_advertising_declaration اضافه شد. اگر این فیلد برای هر معیار سطح پویش در پویش (یا برای هر معیار سطح گروه آگهی فعال در پویش‌های DEMAND_GEN با هدف‌یابی ارتقایافته) true باشد، Campaign.contains_eu_political_advertising الزامی است. اگر فیلد negative معیار false باشد و معیار مکان درون «اتحادیه اروپا»، مجاورت (بدون توجه به اینکه با قلمرو «اتحادیه اروپا» هم‌پوشانی دارد یا نه)، یا گروه مکان (بدون توجه به اینکه با قلمرو «اتحادیه اروپا» هم‌پوشانی دارد یا نه) باشد، فیلدها true را برمی‌گردانند.
تبدیل‌ها
پیکربندی «تبدیل‌های بهبودیافته» یکپارچه	فیلدها و شمارش جدید	ConversionTrackingSetting.enablement_setting و ConversionTrackingSetting.effective_enablement_setting (در Customer.conversion_tracking_setting) برای نمایش پیکربندی یکپارچه «تبدیل‌های بهبودیافته» برای حساب اضافه شد که بااستفاده از شمارش جدید EnhancedConversionsConfig نشان داده می‌شود.
ConversionActionCategory.MESSAGE_LEAD	مقدار شمارشی جدید	به ConversionActionCategory اضافه شد تا از تعاملات پیام یا گپ که نشان‌دهنده علاقه به پیشنهاد آگهی‌دهنده است پشتیبانی کند.
ConversionAttributionEventType.CLICK	مقدار شمارشی جدید	به ConversionAttributionEventType اضافه شد تا نشان‌دهنده تبدیل‌های منسوب به کلیک آگهی باشد که قبلاً در مقدار شمارشی UNKNOWN گنجانده شده بود.
عمومی
به‌روزرسانی‌های مشتریان بالقوه «خدمات محلی»	فیلد جدید و مقدار شمارشی	فیلد LocalServicesLead.campaign به منبع LocalServicesLead اضافه شد تا مشتری بالقوه را به پویش مرتبط آن پیوند دهد. COUPON به LocalServicesLeadType اضافه شد تا از انواع مشتری بالقوه کوپن برای «خدمات محلی» پشتیبانی شود.
توصیه‌ها
توصیه افزایش بودجه برای «جستجو»	توصیه جدید	‫RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW،‏ Recommendation.raise_budget_performance_too_low_recommendation، و ApplyRecommendationOperation.raise_budget_performance_too_low برای پشتیبانی از افزایش بودجه‌ها در زمانی که بودجه‌های روزانه برای «پویش‌های جستجو» خیلی کم است اضافه شد.
گزارش‌ها
اندازه‌گیری‌های بهینه‌گر جستجو	ویژگی‌ها، منابع، بخش‌ها، و سنجه‌های جدید	پشتیبانی برای اندازه‌گیری‌های «بهینه‌گر جستجو» اضافه شد: منبع فقط‌خواندنی جدیدی SearchLiftKeywordBundle که نشان‌دهنده دسته کلیدواژه در مطالعه بهینه‌گر «جستجو» است اضافه شد. بخش‌های انتخابی جدید (segments.search_lift_keyword_bundle و segments.search_property) و ۱۵ سنجه «بهینه‌گر جستجو» جدید (مثل relative_search_lift،‏ normalized_incremental_searches،‏ search_lift_cost_micros، و search_lift_impressions) اضافه شد تا از تجزیه‌وتحلیل «بهینه‌گر جستجو» با LiftMeasurementConfig (پیوندشده به پویش‌ها بااستفاده از Campaign.lift_measurement_config) پشتیبانی شود. ‫SearchLiftKeywordBundleStatus، SearchLiftMatchingInfoSource، و SearchLiftSearchProperty enums اضافه شد.
نمای دارایی ازهم بازکردن نشانی وب نهایی برای پویش‌های Shopping	پشتیبانی گسترده	‫final_url_expansion_asset_view برای پشتیبانی از پویش‌های Shopping گسترش یافته است (با ad_group که به‌عنوان منبع منسوب درکنار final_url_expansion_asset_view.ad_group قابل‌انتخاب است).
ویدیوها
شفاف‌سازی‌های محتوای زایای YouTube	فیلدها و شمارش جدید	پشتیبانی از شفاف‌سازی محتوای زایا برای بارگذاری‌های YouTube اضافه شد. فیلد جدید YouTubeVideoUpload.video_content_metadata از نوع VideoContentMetadata به YouTubeVideoUpload اضافه شده است و تنظیمات شفاف‌سازی را در VideoContentMetadata.generative_content_disclosure از نوع YouTubeVideoUploadGenerativeContentDisclosure دربرمی‌گیرد.

نسخه‌های اصلی و جزئی v25

‫Google Ads API v25 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.

نسخه ۲۵.۲ (‏۲۰۲۶/۰۹/۲۳)

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
دارایی‌ها
گزینه‌های نشانی وب برای AssetGroup	فیلدهای جدید	پشتیبانی از گزینه‌های نشانی وب در AssetGroup اضافه شد، که به تبلیغ‌کنندگان اجازه می‌دهد الگوهای ردگیری، پارامترهای سفارشی، و پسوندهای نشانی وب نهایی را در سطح گروه دارایی مشخص کنند: AssetGroup.tracking_url_template: الگوی نشانی وب برای ساختن نشانی وب ردگیری. AssetGroup.url_custom_parameters: فهرستی از نگاشت‌ها که برای جایگزینی برچسب‌های پارامتر سفارشی نشانی وب در tracking_url_template، final_urls، یا final_mobile_urls استفاده می‌شود. AssetGroup.final_url_suffix: الگوی نشانی وب برای پیوست کردن پارامترها به نشانی‌های وب صفحه مقصدی که با ردیابی موازی ارائه می‌شود.
پویش‌ها
اطلاعات خزیدن خودکار ویدیو	فیلدها و شمارش‌های جدید	AutomatedVideoCrawlSetting به Campaign.AssetAutomationSetting اضافه شد، همراه با AssetAutomationType.AUTOMATED_VIDEO_CRAWL، که به شما امکان می‌دهد تنظیمات خزیدن خودکار ویدیو را برای پویش «بیشینه‌سازی عملکرد» مشخص کنید. ‫AutomatedVideoCrawlSetting.automated_video_crawl_infos حاوی فهرستی از ورودی‌های AutomatedVideoCrawlInfo است که هرکدام یک url خزیدن، source_platform (VideoCrawlSourcePlatform: LANDING_PAGE، SOCIAL، یا YOUTUBE)، و وضعیت موافقت enabled را پیکربندی می‌کنند.
خطاهای ضریب ارزش «بهینه‌سازی چرخه حیات مشتری»	مقادیر و خطاهای جدید شمارشی	دلایل خطای اعتبارسنجی جدیدی هنگام پیکربندی کردن «چندبرهای مقدار» (value_multiplier و high_lifetime_value_multiplier) برای «بهینه‌سازی چرخه عمر مشتری» اضافه شد: ‫GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER ‫CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	ویژگی جدید	SmartCampaignSettingService.GeneratePMaxDraftCampaign برای پشتیبانی از تولید پویش پیش‌نویس «عملکرد بیشینه» از پویش «هوشمند» موجود اضافه شد، که با وضعیت CampaignStatus.PAUSED و وضعیت ایجاد CampaignCreationStatus.INCOMPLETE مقداردهی اولیه شده است (به تبدیل پویش‌های هوشمند به پویش‌های «عملکرد بیشینه» مراجعه کنید): GeneratePMaxDraftCampaignRequest.validate_only را روی true تنظیم کنید تا تبدیل را اعتبارسنجی کنید و هرگونه هشدار اعتبارسنجی یا مشکل تبدیل را در GeneratePMaxDraftCampaignResponse.validated_info بدون ایجاد پیش‌نویس کمپین دریافت کنید. (gbp_enabled و image_enabled را تنظیم‌نشده یا false رها کنید؛ تنظیم آن‌ها روی true هنوز پشتیبانی نمی‌شود و SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED یا SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED را برمی‌گرداند.) ‫GeneratePMaxDraftCampaignResponse نام‌های منبع نهادهای تولیدشده (pmax_campaign، campaign_budget، asset_group، و assets) را به‌همراه validated_info برمی‌گرداند.
تبدیل‌ها
ظهورهای آگهی Firebase	انواع و دسته‌های جدید کنش تبدیل	انواع کنش تبدیل FIREBASE_ANDROID_APP_AD_IMPRESSION و FIREBASE_IOS_APP_AD_IMPRESSION را درمعرض دید قرار دادیم تا بتوانید این کنش‌های تبدیل را بازیابی و اصلاح کنید. همچنین دسته IN_APP_AD_REVENUE را در ConversionActionCategory برای ردیابی درآمد خالص از درآمدزایی آگهی درون‌برنامه آشکار کرد.
عمومی
BusinessProfileLocationSyncError	تعداد جدید و خطاها	دلایل بیشتری برای خطاهای همگام‌سازی مکان «نمایه کسب‌وکار» هنگام همگام‌سازی مکان‌ها در LOCATION_SYNC-تایپ AssetSet اضافه شد. اکنون به‌جای برگرداندن خطای عمومی UNKNOWN، این API BusinessProfileLocationSyncError را با دلایل خاص (EMAIL_INVALID، OAUTH_TOKEN_INVALID، ACCOUNT_REMOVED، و NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT) برمی‌گرداند.
برنامه‌ریزی
سنجه‌های صدک BenchmarksService.GenerateBenchmarksMetrics	ویژگی‌های جدید	‫BenchmarksService.GenerateBenchmarksMetrics به‌روز شد تا سنجه‌هایی ارائه دهد که جایگاه رقابتی مشتری را در میان تبلیغ‌کنندگان دیگر در قالب سطح درصدی نشان دهد. سنجه‌ها در PercentileMetrics در فیلد جدید CustomerMetrics.percentile_metrics (در هر دو GenerateBenchmarksMetricsResponse.customer_metrics و BreakdownMetrics.customer_metrics) برگردانده می‌شوند و بااستفاده از BenchmarksCustomerPercentileTier نشان داده می‌شوند. CustomerMetrics.percentile_metrics فقط زمانی درج می‌شود که هر دو شرط زیر در GenerateBenchmarksMetricsRequest برقرار باشد: PERCENTILE_DATA در supplemental_data درخواست شده است. ‫BenchmarksSource.all_advertisers در benchmarks_source تنظیم شده است (که همچنین نیاز به مشخص کردن category_filter دارد). پشتیبانی از سنجه‌های صدک برای تاریخ‌های سه‌ماهه باز در ListBenchmarksAvailableDatesResponse.supported_dates (برگردانده‌شده توسط BenchmarksService.ListBenchmarksAvailableDates) اضافه شد. درحالی‌که سنجه‌های مجموع مشتری (CustomerMetrics.aggregate_metrics)، سنجه‌های نرخ مشتری (CustomerMetrics.average_rate_metrics)، و سنجه‌های صدک مشتری (CustomerMetrics.percentile_metrics) در همه تاریخ‌ها در supported_dates (ازجمله سه‌ماهه‌های باز) پشتیبانی می‌شوند، سنجه‌های سهم مشتری (CustomerMetrics.share_metrics) و سنجه‌های نرخ منبع محک‌ها (average_benchmarks_metrics، مانند average_cpm از آگهی‌های «/پوشاک/لباس») برای سه‌ماهه‌های باز پشتیبانی نمی‌شوند و از پاسخ حذف می‌شوند، مگراینکه date_range درخواست‌شده در محدوده باریک‌تر ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics قرار گیرد. خطای سفارشی BenchmarksError.NO_METRICS_FOUND اضافه شد که نشان می‌دهد هیچ سنجه‌ای برای ترکیب انتخاب‌شده ورودی‌ها برای بهبود قابلیت استفاده پیدا نشده است.
نام‌های کاربری کانال YouTube برای اطلاعات آماری محتواساز	ویژگی جدید	ContentCreatorInsightsService.GenerateCreatorInsights به‌روزرسانی شد تا از جستجوی نام‌های کاربری کانال YouTube بااستفاده از YouTubeChannels.youtube_channel_handles پشتیبانی کند (نام‌های کاربری معتبر کانال باید با @ شروع شوند، مثل @channel_handle). این گزینه مشابه جستجو براساس شناسه کانال YouTube است. پاسخ حاوی اطلاعات آماری درباره محتواسازان YouTube درخواست‌شده است.
توصیه‌ها
توصیه‌های پیشنهاد قیمت «کنش‌بها» و «برگشت هزینه‌های تبلیغات»	توصیه‌های جدید	‫Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) و Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)، به‌همراه ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low و ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low، اضافه شد تا از افزایش «کنش‌بهای هدف» یا کاهش «برگشت هزینه‌های تبلیغات هدف» درصورتی‌که قیمت‌های پیشنهادی برای ورود «پویش‌های شبکه جستجو» به حراج‌ها خیلی پایین باشد پشتیبانی کند: RaiseTargetCpaPerformanceBidTooLowRecommendation recommended_target_multiplier (عاملی بزرگ‌تر از 1.0) و current_average_target_cpa_micros را ارائه می‌دهد؛ آن را بااستفاده از RaiseTargetCpaPerformanceBidTooLowParameters با target_cpa_multiplier اعمال کنید. ‫LowerTargetRoasPerformanceBidTooLowRecommendation recommended_target_multiplier (عامل کمتر از 1.0) و current_average_target_roas را ارائه می‌دهد؛ آن را بااستفاده از LowerTargetRoasPerformanceBidTooLowParameters با target_roas_multiplier اعمال کنید.
گزارش‌ها
بخش‌های بُعد برنامه سفر هتل	بخش‌های جدید	بخش‌های ابعاد برنامه سفر رزرو هتل و سفر زیر به Segments اضافه شد (با campaign،‏ ad_group، و customer قابل‌انتخاب است): Segments.advance_booking_window: پنجره رزرو ازپیش برای برنامه سفر برحسب روز. Segments.length_of_booking: مدت رزرو برای برنامه سفر برحسب روز. Segments.start_date: تاریخ شروع رزرو با قالب yyyy-MM-dd. Segments.start_day_of_week: روز شروع رزرو در هفته (DayOfWeek). Segments.user_set_dates: نشان می‌دهد که آیا تاریخ‌های مشخص‌شده توسط کاربر انتخاب شده‌اند یا نه (HotelDateSelectionType).
سنجه‌های آگهی‌های عمودی	معیارهای سنجش جدید	سنجه‌های زیر را برای گزارش کردن تبلیغات عمودی هتل و سفر به Metrics (قابل‌انتخاب با campaign، ad_group، و customer) اضافه کردیم: Metrics.vertical_ads_average_booking_value_micros: میانگین نرخ روزانه وزنی کلیک به میکرو، شامل مالیات و کارمزد، در کل مدت اقامت برای رزرو هتل. Metrics.vertical_ads_potential_impressions: مجموع ظهورهای واجدشرایط با سقف بازدید موجود در سراسر بافت پُرسمان. Metrics.vertical_ads_price_difference_percentage: اختلاف درصد مقایسه قیمت پیشنهادی آگهی‌دهنده با پایین‌ترین قیمت رقابتی برای همان ملک.
بخش‌های آگهی‌های عمودی	بخش‌های جدید	بخش‌های زیر برای گزارش تبلیغات عمودی هتل و سفر به Segments اضافه شد (با campaign، ad_group، و customer قابل‌انتخاب است): Segments.vertical_ads_price_tier: سطح قیمت آگهی‌دهنده (HotelPriceBucket) در مقایسه با رقبا در مزایده. Segments.vertical_ads_rate_rule_id: شناسه قانون مربوط به نرخ مرتبط با قانون مربوط به نرخ تبلیغ‌کننده. Segments.vertical_ads_rate_type: نوع نرخ (HotelRateType) رزرو هتل.

نسخه ۲۵.۱‏ (‎۲۰۲۶/۰۸/۱۹)

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

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

برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.

تغییرات ناسازگار

حالت اولیه	وضعیت جدید	نوع تغییر	راهنمایی‌های پیاده‌سازی
پویش‌ها
فیلدهای مستقل additional_value و additional_high_lifetime_value در CustomerLifecycleOptimizationValueSettings	به‌ترتیب بخشی از value_adjustment و high_lifetime_value_adjustment oneofs، درکنار فیلدهای جدید value_multiplier و high_lifetime_value_multiplier	تغییر ساختاری	مرجع‌های این فیلدها را به‌روز کنید زیرا اکنون بخشی از oneofs هستند.
منابع قدیمی CustomerLifecycleGoal و CampaignLifecycleGoal، خدمات مربوط به آن‌ها CustomerLifecycleGoalService و CampaignLifecycleGoalService، و تنظیمات/فهرست‌های قدیمی (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، از فیلدهای شمارشی مستقل جدید استفاده کنید.
فیلدهای اختیاری 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	مقدار / رفتار جدید شمارشی	دردسترس برای DemandGenMultiAssetAds. اگر فعال باشد، بااستفاده از تصاویر غیرپویانمایی‌شده به‌عنوان ورودی، تصاویر پویانمایی‌شده تولید می‌کند. DemandGenMultiAssetAds جدید به‌طور پیش‌فرض از این نسخه API شروع می‌شود.
تغییرپذیری اطلاعات محتوای مصنوعی	تغییر رفتار	Asset.synthetic_content_info و Ad.synthetic_content_info اکنون در نسخه ۲۵، نسخه ۲۴، و نسخه ۲۳ کاملاً تغییرپذیر هستند.
پویش‌ها
هدف حفظ مشتری وفادار	ویژگی‌ها / تنظیمات جدید	پشتیبانی از «هدف حفظ وفاداری» اضافه شد که به تبلیغ‌کنندگان امکان می‌دهد پویش‌ها را برای حفظ اعضای برنامه وفاداری بهینه‌سازی کنند. ‫LOYALTY_RETENTION را به شمارش GoalType اضافه کرد. 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
هدف «جذب مشتری جدید»	ویژگی‌ها / تنظیمات جدید	پشتیبانی «هدف جذب مشتری جدید» در «میانای برنامه‌سازی کاربردی Google Ads» به‌روزرسانی شد تا طرحواره اهداف یکپارچه بازطراحی‌شده را منعکس کند: منبع Goal را برای پشتیبانی از تنظیمات «جذب مشتری جدید» بااستفاده از فیلد new_customer_acquisition_goal_settings گسترش دادیم. منبع CampaignGoalConfig را برای پشتیبانی از لغوهای خاص پویش برای «جذب مشتری جدید» بااستفاده از فیلد campaign_new_customer_acquisition_settings گسترش دادیم. CustomerLifecycleOptimizationGoalSubType enum جدید برای تعریف زیرنوع‌های هدف پشتیبانی‌شده اضافه شد. NEW_CUSTOMER_ACQUISITION به شمارش GoalType اضافه شد. دلایل خطای اعتبارسنجی جدیدی به 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	فیلدهای جدید	پشتیبانی از درستی‌سنجی اسناد تبدیل 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 (کد کشور صورت‌حساب ارائه‌شده در درخواست با کشور حساب مشتری مطابقت ندارد)
برنامه‌ریزی
جزئیات کانال YouTube در اطلاعات آماری پرطرفدار	فیلدهای جدید	پشتیبانی از جزئیات بیشتر کانال YouTube ویدیوهای مرتبط هنگام جستجوی اطلاعات آماری پرطرفدار اضافه شد. فیلدهای جدید channel_id، channel_name، و channel_url را به YouTubeVideoAttributeMetadata اضافه کرد.
YouTubeChannelInsights.data_sharing_consent_given	فیلد جدید	به YouTubeChannelInsights اضافه شد. این امر درصورتی صادق است که محتواساز با هم‌رسانی داده‌های غیرعمومی موافقت کرده باشد. اگر این‌طور باشد، فیلدهای زیر پر می‌شوند: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
گزارش‌ها
ad_sub_format_type	بخش جدید	آگهی‌های ردنشدنی در جاری‌سازی YouTube را براساس مدت زمان تفکیک می‌کند: INSTREAM_NON_SKIPPABLE_STANDARD (آگهی ردنشدنی درون جاری‌سازی با مدت استاندارد) INSTREAM_NON_SKIPPABLE_MAX30_SEC (آگهی درون‌جاری‌سازی ردنشدنی که طولانی‌تر از ۳۰٫۹۹ ثانیه نباشد) INSTREAM_NON_SKIPPABLE_MAX60_SEC (آگهی درون‌جاری‌سازی ردنشدنی که طولانی‌تر از ۶۰٫۹۹ ثانیه نباشد) این بخش باید همیشه همراه با ad_format_type انتخاب شود. با AdGroup، AdGroupAd، Campaign، Customer، Video، و VideoEnhancement قابل‌انتخاب است.
سنجه‌های اجتماعی مختص ویدیو	فیلدها / سنجه‌های جدید	سنجه‌های اجتماعی مختص ویدیو اضافه شده است تا به آگهی‌دهندگان کمک کند تعامل کاربر (نظرات، پسندیدن‌ها، و هم‌رسانی‌ها) را برای آگهی‌های «کوته‌ویدیوها» در YouTube پیگیری کنند: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares این ویژگی‌ها در AdGroup، AdGroupAd، Asset، Campaign، Customer، و Video دردسترس هستند.

نسخه‌های اصلی و جزئی v24

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

نسخه ۲۴.۲ (‎۲۰۲۶/۰۶/۲۴)

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
آگهی‌ها
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	مقدار شمارشی جدید	اطلاعات نوشتاری را از صفحه مقصد تولید می‌کند تا در پانل تعامل برای نمونه‌های DemandGenVideoResponsiveAd (که به‌طور پیش‌فرض از این نسخه میانای برنامه‌سازی کاربردی موافقت کرده‌اند) نشان داده شود.
دارایی‌ها
AssetGroup.google_local_services_info	فیلد جدید	برای پشتیبانی از اطلاعات «آگهی‌های خدمات محلی» (شناسه دسته و توضیحات) در پویش‌های «عملکرد بیشینه» اضافه شده است.
AssetGroupSignal.local_services_id	فیلد جدید	برای پشتیبانی از نشان‌های شناسه خدمات «آگهی‌های خدمات محلی» در پویش‌های «عملکرد بیشینه» اضافه شد.
AssetGroupSignal.vertical_ads_item_group_rule_list	فیلد جدید	برای پشتیبانی از قوانین گروه موردهای آگهی‌های عمودی برای انتخاب موردها از فیدهای عمودی پیوست‌شده در پویش‌های «عملکرد بیشینه» اضافه شده است. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز دردسترس است.
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	فیلد جدید	‫Google Maps را به کانال‌های قابل‌انتخاب برای گروه‌های آگهی «تولید تقاضا» اضافه می‌کند.
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: برای آزمایش‌های بهینه‌سازی «بیشینه‌سازی عملکرد» برای سفارشی‌سازی نوشتار و ازهم باز کردن «نشانی وب نهایی».
عمومی
Asset.synthetic_content_info Ad.synthetic_content_info	فیلدهای جدید	حاوی گواهی‌های مربوط به محتوای مصنوعی/هوشواره‌ای است که به دو بخش advertiser_attestation (اظهارنامه‌هایی که مستقیماً توسط تبلیغ‌کننده ارائه شده است) و system_attestation (گواهی‌هایی که به‌طور خودکار توسط سیستم شناسایی یا ارائه شده است) تقسیم می‌شود. این ویژگی به نسخه‌های ۲۳ و ۲۲ بازگردانده شده است. برای کمک به شما در برنامه‌ریزی کار ادغام آتی برای نسخه ۲۵، میانای تغییر فیلدهای گواهی تبلیغ‌کننده زودتر برای نسخه ۲۲ و بالاتر معرفی می‌شود. میانای کاربری در این نسخه‌ها نمایان است، اما synthetic_content_info.advertiser_attestation.status و synthetic_content_info.advertiser_attestation.source برای این نسخه‌ها تغییرناپذیر باقی می‌مانند. اگر درخواست جهش را روی هریک از این فیلدها امتحان کنید، یکی از این خطاها برگردانده خواهد شد: «فیلدی که تلاش شده است تغییر کند تغییرناپذیر است» یا «فیلد نمی‌تواند تنظیم شود». این فیلدها از نسخه ۲۵ به‌طور کامل قابل‌تغییر خواهند شد. توصیه می‌کنیم اکنون از این میانای کاربری برای ساختن و آزمایش کردن منطق داخلی‌تان استفاده کنید تا سیستمتان برای قابلیت‌های کامل نوشتن هنگام راه‌اندازی نسخه ۲۵ آماده باشد.
مجوزدهی چندطرفی	ویژگی‌های جدید	بتا: این ویژگی درحال‌حاضر در نسخه بتا است و ممکن است در نسخه‌های بعدی تغییر کند. پشتیبانی از بازبینی‌های «مجوزدهی چندطرفی» (MPA) اضافه شد: منبع MultiPartyAuthReview و MultiPartyAuthReviewService مربوطه اضافه شد. MultiPartyAuthReviewStatus enum برای پیگیری وضعیت بازبینی اضافه شد. CustomerUserAccess.pending_multi_party_auth_review برای پیوند دادن به مرور درانتظار اضافه شد. MutateCustomerUserAccessResult.multi_party_auth_review و MutateCustomerUserAccessInvitationResult.multi_party_auth_review برای برگرداندن نام منبع مرور مرتبط اضافه شد. MultiPartyAuthReviewError برای خطاهای اعتبارسنجی اضافه شد. این ویژگی به v23.3، v22.2، و v21.2 بازگردانده شده است.
IncentiveService.FetchIncentive	تغییر رفتاری	وقتی نشانی ایمیل نامعتبری در درخواست ارائه می‌شود، این روش اکنون به‌جای ایجاد خطای AuthenticationError.INVALID_EMAIL_ADDRESS، به‌طور مناسب به برگرداندن پیشنهادهای تشویقی پیش‌فرض برمی‌گردد.
برنامه‌ریزی
GenerateCreatorInsightsRequest.search_topics	فیلد جدید	به سرویس ContentCreatorInsightsService.GenerateCreatorInsights اضافه شد. این گزینه محتواسازانی را جستجو می‌کند که درباره موضوعی در کشور مشخص‌شده در country_locations صحبت می‌کنند (فقط از جستجو برای یک کشور پشتیبانی می‌کند).
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	فیلد جدید	اگر درست باشد، مستثنا کردن‌های نمانام برای آگهی‌های «آماده خرید» نادیده گرفته می‌شود. فقط برای پویش‌های Shopping پشتیبانی می‌شود.
هدف‌گیری
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	مقدار enum جدید / خطا	وقتی تلاش می‌شود زبانی هدف‌یابی شود که مجاز نیست، این خطا برگردانده می‌شود.
ویدیوها
DataLink.youtube_link_metadata	فیلد جدید	شامل brand_channel_id برای مشخص کردن شناسه کانال نمانام YouTube پیوندشده است.

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

ویژگی‌های جدید و به‌روزرسانی‌های زیر در Google Ads API v24.1 اضافه شده است. نسخه‌های جزئی مثل v24.1 حاوی تغییرات اساسی نیستند.

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
آگهی‌ها
DemandGenMultiAssetAdInfo.classic_display_images	فیلد جدید	تصاویر نمایشی بارگذاری‌شده سفارشی بدون نیاز به دارایی‌های واکنش‌گرای اضافی ارائه می‌شوند.
آزمایش‌ها
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	مقادیر شمارشی جدید	پشتیبانی از انواع جدید ExperimentType اضافه شد: ADOPT_AI_MAX: برای آزمایش‌هایی که بررسی می‌کنند «بیشینه‌سازی هوشواره‌ای» چگونه می‌تواند به شما کمک کند تا با «هوشواره Google» و کلیدواژه‌های تقریباً منطبق‌شده بتوانید با مشتریان بیشتری تعامل کنید. ADOPT_BROAD_MATCH_KEYWORDS: برای آزمایش‌هایی که بررسی می‌کنند کلیدواژه‌های انطباق تقریبی چگونه می‌توانند بر تعداد جستجوهایی که آگهی‌هایتان در آن‌ها نمایش داده می‌شود تأثیر بگذارند. ‫OPTIMIZE_ASSETS: برای آزمایش‌های سفارشی بهینه‌سازی دارایی‌ها. PMAX_REPLACEMENT_SHOPPING: برای آزمایش‌هایی که عملکرد پویش‌های Shopping شما را درمقایسه با «عملکرد بیشینه» می‌سنجند.
Experiment.video_experiment	فیلد جدید	پشتیبانی پیکربندی برای آزمایش‌های YOUTUBE_CUSTOM موجود شامل «پویش‌های ویدیویی».
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	فیلدهای جدید	فیلدهایی را برای پشتیبانی از آزمایش دارایی، گروه‌های دارایی، و تنظیمات «عملکرد بیشینه» در شاخه‌های آزمایش نمایان می‌کند: asset_testing_info: جزئیات دارایی‌های مرتبط با نسخه‌های آزمایشی آگهی‌ها. ‫asset_groups: فهرست گروه‌های دارایی در شاخه آزمایش برای آزمایش‌های «بهینه‌سازی دارایی‌ها». performance_max_experiment_arm_info: تنظیمات پویش‌های «عملکرد بیشینه» در آزمایش‌های PMAX_REPLACEMENT_SHOPPING.
عمومی
CustomerUserAccess.passkey_enabled	فیلد جدید	فیلد فقط خواندنی که نشان می‌دهد آیا کاربر گذرکلید را فعال کرده است یا نه.
گزارش‌ها
mobile_device_platform	بخش جدید	اجازه می‌دهد گزارش‌ها براساس پلاتفرم دستگاه کاربر (مثل iOS یا Android) بخش‌بندی شوند.
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	مقدار enum جدید / خطا	زمانی برگردانده می‌شود که سطح جزئیات زمانی روزانه، ساعتی، یا هفتگی درخواست‌شده برای محدوده‌های تاریخ پُرسمان پشتیبانی نشود (فقط برای ۳۷ ماه گذشته دردسترس است).
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	فیلد جدید	شناسه کانال YouTube مرتبط با پیوند داده را آشکار می‌کند.

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

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

برای راهنمایی، ارتقا به جدیدترین نسخه را ببینید.

تغییرات ناگهانی

حالت اولیه	وضعیت جدید	نوع تغییر	راهنمایی‌های پیاده‌سازی
آگهی‌ها
videos و logo_images اختیاری در DemandGenVideoResponsiveAdInfo	قسمت‌های الزامی	تغییر رفتاری	هنگام ساختن یا جهش دادن آگهی‌های ویدیویی واکنش‌گرای «تولید تقاضا»، 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	تغییر نام / تغییر رفتاری	کدهای خطای برگشتی برای گروه‌های دارایی اصلاح شده‌اند تا با خطاهای آگهی گروه آگهی هم‌راستا شوند. Update validation catch logic.

ویژگی‌ها و به‌روزرسانی‌ها (غیرمخرب)

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
آگهی‌ها
تغییرپذیری 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) را در پویش‌های «تولید تقاضا» و «برنامه» فراهم می‌کند.
CampaignCriterion.gender	ویژگی جدید	کنارگذاری‌های جنسیتی برای پویش‌های «عملکرد بیشینه» در همه نسخه‌های Google Ads API فعال شد.
تبدیل‌ها
انواع تبدیل «تولید مشتری بالقوه»	مقادیر شمارشی جدید	انواع شمارشی کنش تبدیل 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 v23 شامل ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر است.

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

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

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

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

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
دارایی‌ها
VideoEnhancement	منبع جدید	حاوی اطلاعات آگهی ویدیویی مختص بهبود است، مثلاً اینکه Google آن را تولید کرده است یا تبلیغ‌کننده آن را ارائه کرده است. برای کسب اطلاعات بیشتر، درباره بهبودهای ویدیو را ببینید.
AppTopCombinationView	منبع جدید	منبع فقط خواندنی برای ارائه اطلاعات آماری درباره ترکیب‌های دارایی با عملکرد برتر در «پویش‌های برنامه».
CustomerAsset	ویژگی جدید	پشتیبانی برای بازیابی CustomerAsset با field_type تنظیم‌شده روی BUSINESS_LOGO اضافه شد.
پویش‌ها
AdGroupAd.start_date_time AdGroupAd.end_date_time	فیلدهای جدید	محدودیت‌های زمان‌بندی دقیق‌تری را در تاریخ‌های پویش ارائه دهید. این ویژگی فقط برای برخی‌از انواع گروه‌های آگهی پشتیبانی می‌شود.
HotelSettingInfo.disable_hotel_setting	فیلد جدید	اجازه می‌دهد فید هتل در پویش‌های «تولید تقاضا» غیرفعال شود.
عمومی
CustomerClientLinkError	مقادیر / خطاهای شمارشی جدید	دو کد خطای جدید اضافه شد: MAX_CUSTOMER_LIMIT_REACHED و ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	تغییر رفتاری	اکنون هنگام تلاش برای استفاده از این دسته نوع مشتری فهرست کاربر منسوخ‌شده، خطایی ایجاد می‌شود.
برنامه‌ریزی
GenerateTrendingInsights GenerateCreatorInsights	ویژگی‌های جدید	پشتیبانی از ترکیب‌های سفارشی «و/یا» برای نهادها، موضوعات، و مخاطبان اضافه شد.
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 برای «بیشینه‌سازی کلیک‌ها» (کلیک‌بها) در «تولید تقاضا» در 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» گسترش یافته است. ‫UNSUPPORTED_AD_TYPE و TOO_MANY_RESOURCES_IN_REQUEST را به ShareablePreviewError اضافه کرد. این ویژگی فقط برای برخی‌از انواع آگهی‌ها پشتیبانی می‌شود.

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

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

ویژگی‌ها و به‌روزرسانی‌ها	نوع	شرح
مدیریت حساب
advertising_partner_properties.allowed_domain	فیلد جدید	به منابع ProductLinkInvitation و ProductLink اضافه شد. شریک تبلیغاتی فقط می‌تواند در این دامنه تبلیغ کند.
Customer.contains_eu_political_advertising	فیلد جدید	وضعیت اظهارنامه سطح حساب را درباره اینکه آیا تبلیغات سیاسی هدف‌یابی‌شده به‌سوی اتحادیه اروپا دارد یا نه بازیابی می‌کند و EuPoliticalAdvertisingStatus را برمی‌گرداند.
پویش‌ها
Campaign.text_guidelines	فیلد جدید	پشتیبانی از دستورالعمل‌های نوشتاری اضافه شد که می‌توان از آن در پویش‌های «بیشینه‌سازی عملکرد» و «شبکه جستجو» برای کنترل برنامه‌ای دارایی‌های نوشتاری تولیدشده با هوش مصنوعی استفاده کرد. در 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	مقدار enum جدید / خطا	وقتی برگردانده می‌شود که تلاش شود فقط دسته نامشخص در ابعاد جمعیت‌شناسی هدف‌یابی شود.
مشوق‌ها
IncentiveErrorEnum	مقادیر / خطاهای جدید شمارشی	دو کد خطای جدید اضافه شد: 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 برای پشتیبانی از بارگذاری و مدیریت ویدیوها در YouTube و منبع YouTubeVideoUpload برای پشتیبانی از واکشی وضعیت بارگذاری و فراداده اضافه شد. این ویژگی فقط برای REST و کتابخانه کارخواه Python پشتیبانی می‌شود.

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

ویژگی‌های جدید، به‌روزرسانی‌ها، و تغییرات اساسی زیر در 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	ویژگی‌های جدید / پشتیبانی	دارایی‌های «پیام کاری» به‌روزشده: پشتیبانی از «پیام‌رسان فیس‌بوک» و Zalo به‌عنوان ارائه‌دهنده اضافه شد. FACEBOOK_MESSENGER و ZALO به BusinessMessageProvider اضافه شد. فیلدهای facebook_messenger_info و zalo_info اضافه شد. CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS به AssetError اضافه شد.
صورت‌حساب
InvoiceService.ListInvoices	گزینه‌های جدید	اکنون می‌تواند با تنظیم کردن include_granular_level_invoice_details در ListInvoicesRequest، جزئیات دقیق‌تری را در Invoice برگرداند، ازجمله تفکیک هزینه در سطح پویش، هزینه‌های نظارتی تفکیک‌شده، و اطلاعات اصلاحیه.
RegulatoryFeeType UnitOfMeasure	تعداد جدید	شمارش‌های کمکی برای کارمزدهای نظارتی و واحدهای اندازه‌گیری اضافه شد.
پویش‌ها
CampaignError	مقادیر enum / خطاهای جدید	کدهای خطای DURATION_TOO_LONG_FOR_TOTAL_BUDGET و END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET اضافه شد.
تبدیل‌ها
ConversionActionCategory	مقدار شمارشی جدید	YOUTUBE_FOLLOW_ON_VIEWS برای پشتیبانی از ردیابی کاربرانی که آگهی را تماشا می‌کنند و بعداً ویدیویی را از همان کانال تماشا می‌کنند اضافه شد.
افزایش تقاضا
DemandGenVideoResponsiveAdInfo.companion_banner	فیلد جدید	پشتیبانی از برنماهای همراه در آگهی‌های ویدیویی واکنش‌گرای «تولید تقاضا» اضافه شد.
مشوق‌ها
افزودن پشتیبانی از مشوق‌های «انتخاب خودتان» (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) است. فقط برای کمپین‌های «تولید تقاضا» پشتیبانی می‌شود.
LanguageDistribution	فیلد / نوع جدید	به YouTubeChannelInsights اضافه شد تا جزئیات توزیع زبان را در محتوای کانال YouTube ارائه دهد.
BenchmarksService	سرویس جدید	داده‌های تبلیغات YouTube را با معیارهای صنعت مقایسه می‌کند.
AudienceInsightsService.GenerateAudienceDefinition	روش جدید	بااستفاده از هوش مصنوعی زایا، شرح نوشتاری آزاد مخاطب هدف را به مشخصه‌های مخاطب منطبق ترجمه می‌کند.
YouTubeChannelInsights.relevance_score	فیلد جدید	ارزیابی می‌کند که یک محتواساز چقدر برای یک موضوع مرتبط است که براساس بازدیدها وزن‌دهی می‌شود.
TrendInsightMetrics.trend_change_percent	فیلد جدید	نشان‌دهنده درصد تغییر در مقدار روند درطول دوره مقایسه است.
توصیه‌ها
GenerateRecommendationsRequest	فیلد جدید	is_new_customer اضافه شد. وقتی برای توصیه‌های CAMPAIGN_BUDGET روی true تنظیم شود، از مدلی استفاده می‌کند که برای مشتریان جدید بهینه‌سازی شده است (فقط برای مشتریانی که پویش ندارند توصیه می‌شود).
گزارش‌ها
AdGroupAdAssetView	پشتیبانی از ویژگی / سنجه‌های جدید	اکنون از سنجه‌های ظهور، عملکرد، و تبدیل برای RESPONSIVE_DISPLAY_AD پشتیبانی می‌کند.
بخش ad_sub_network_type	بخش جدید	تفکیک عملکرد جزئی را در شبکه آگهی ارائه می‌دهد. در ابتدا برای کمپین‌های «تولید تقاضا» در YouTube (درون‌جاری، درون‌فید، «کوته‌ویدیوها») دردسترس است. باید همراه با ad_network_type انتخاب شود.
گزارش‌دهی «عملکرد بیشینه»	ویژگی جدید	ازهم بازکردن نوع شبکه آگهی فعال‌شده برای پویش‌های «عملکرد بیشینه».
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 اضافه شد تا هدف‌یابی گروه‌های مورد در پویش‌های «شبکه جستجو» با فیدهای سفر مجاز شود.
یکپارچه‌سازی فید داده‌های آگهی‌های عمودی	ویژگی جدید	اکنون می‌توانید فید داده‌های آگهی‌های عمودی را به پویش جستجویی که «بیشینه‌سازی هوشواره‌ای» را اجرا می‌کند متصل کنید تا آگهی‌های تبلیغات ملک و آگهی‌های سفر پیوند رزرو را در کنار آگهی‌های نوشتاری نشان دهید. قالب‌ها را با vertical_ads_format_setting کنترل کنید و قوانین را بااستفاده از vertical_ads_item_group_rule تعریف کنید. گزارش‌دهی بخش براساس AdFormatType و ابعاد فید داده‌های آگهی‌های عمودی.
ویدیوها
AdVideoAssetInfo.ad_video_asset_feature_control	فیلد جدید	گزینه‌های کنترل ویژگی برای دارایی‌های آگهی ویدیویی اضافه شد.
CampaignCriterionError	مقدار جدید شمارشی / خطا	کد خطای INVALID_VIDEO_LINEUP_ID اضافه شد.
سنجه‌های شنیداری YouTube	معیارهای سنجش جدید	سنجه‌های شنیداری برای آگهی‌های صوتی در YouTube اضافه شد که گزارش می‌دهد آیا آگهی شنیدنی بوده است یا نه و در چند ظهور، شنیداری قابل‌اندازه‌گیری بوده است.

یادداشت‌های انتشار بایگانی‌شده

برای یادداشت‌های انتشار بایگانی‌شده، نسخه‌های منسوخ‌شده را ببینید.