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

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

نسخه عمده 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: تغییر نام / برداشتن مرجع‌ها را به‌روز کنید تا از فیلدهای معیار مستقل از حوزه استفاده کنید، که از هدف‌یابی در حوزه‌های سفر فراتر از هتل‌ها (مثل «کارهایی که باید انجام دهید») پشتیبانی می‌کند. شناسه‌های معیار، رفتار هدف‌یابی، و اصلاح‌کننده‌های پیشنهاد قیمت موجود ثابت می‌مانند. مقادیر 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: تغییر نام مدیریت خطای به‌روزرسانی را بررسی کنید تا دلایل خطای جدید مستقل از عمودی را بررسی کنید.

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

ویژگی‌ها و به‌روزرسانی‌ها نوع شرح
دارایی‌ها
ارائه‌دهندگان پیام کاری 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 اضافه شد.
خطاهای اعتبارسنجی کمپین «خدمات محلی» مقادیر و خطاهای جدید شمارشی خطاهای اعتبارسنجی جدیدی برای پویش‌های «خدمات محلی» اضافه شد:
اعتبارسنجی پیوند حساب 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 اضافه شد که حداقل بودجه لازم در روز را برای پویش‌های «تولید تقاضا» به آن ارز مشخص می‌کند. وقتی حداقل بودجه اعمال‌شده توسط API تغییر کند، مقدار این فیلد به‌روز می‌شود.
پیکربندی اندازه‌گیری بهینه‌گر برای پویش‌ها فیلد جدید 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 گنجانده شده بود.
عمومی
به‌روزرسانی‌های مشتریان بالقوه «خدمات محلی» فیلد جدید و مقدار شمارشی
توصیه‌ها
توصیه افزایش بودجه برای «جستجو» توصیه جدید ‫RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW،‏ Recommendation.raise_budget_performance_too_low_recommendation، و ApplyRecommendationOperation.raise_budget_performance_too_low اضافه شد تا از افزایش بودجه‌ها درصورتی‌که بودجه‌های روزانه برای پویش‌های «جستجو» خیلی کم باشد پشتیبانی شود.
گزارش‌ها
اندازه‌گیری‌های بهینه‌گر جستجو ویژگی‌ها، منابع، بخش‌ها، و سنجه‌های جدید پشتیبانی از اندازه‌گیری‌های «بهینه‌گر جستجو» اضافه شد:
نمای دارایی ازهم بازکردن نشانی وب نهایی برای پویش‌های Shopping پشتیبانی گسترده final_url_expansion_asset_view گسترش یافت تا از پویش‌های «مرکزخرید» (با 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) برای «بهینه‌سازی چرخه حیات مشتری» اضافه شد:
SmartCampaignSettingService.GeneratePMaxDraftCampaign ویژگی جدید SmartCampaignSettingService.GeneratePMaxDraftCampaign اضافه شد تا از تولید پیش‌نویس پویش «عملکرد بیشینه» از پویش «هوشمند» موجود پشتیبانی کند، با وضعیت CampaignStatus.PAUSED و وضعیت ایجاد CampaignCreationStatus.INCOMPLETE مقداردهی اولیه شد (به تبدیل پویش‌های هوشمند به پویش‌های «عملکرد بیشینه» مراجعه کنید):
تبدیل‌ها
ظهورهای آگهی Firebase انواع و دسته کنش تبدیل جدید انواع کنش تبدیل FIREBASE_ANDROID_APP_AD_IMPRESSION و FIREBASE_IOS_APP_AD_IMPRESSION را آشکار کردیم و به شما امکان دادیم این کنش‌های تبدیل را بازیابی و اصلاح کنید. همچنین دسته IN_APP_AD_REVENUE را در ConversionActionCategory برای ردیابی درآمد خالص از درآمدزایی آگهی درون‌برنامه آشکار کرد.
عمومی
BusinessProfileLocationSyncError enum و خطاهای جدید دلایل خطاهای همگام‌سازی مکان «نمایه کسب‌وکار» هنگام همگام‌سازی مکان‌ها در AssetSet با نوع LOCATION_SYNC اضافه شد. اکنون API به‌جای برگرداندن خطای عمومی UNKNOWN، 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 برقرار باشد:

پشتیبانی از سنجه‌های صدک برای تاریخ‌های سه‌ماهه باز در 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 اضافه شد تا از افزایش «کنش‌بهای هدف» یا کاهش «برگشت هزینه‌های تبلیغات هدف» در شرایطی که قیمت‌های پیشنهادی برای ورود «پویش‌های جستجو» به مزایده‌ها خیلی پایین است پشتیبانی شود:
گزارش‌ها
بخش‌های بعد برنامه سفر هتل بخش‌های جدید بخش‌های بُعد برنامه سفر رزرو هتل و سفر زیر به Segments اضافه شد (قابل‌انتخاب با campaign، ad_group، و customer):
سنجه‌های آگهی‌های عمودی معیارهای سنجش جدید سنجه‌های زیر را برای گزارش کردن تبلیغات عمودی هتل و سفر به Metrics (قابل‌انتخاب با campaign، ad_group، و customer) اضافه کردیم:
بخش‌های آگهی عمودی بخش‌های جدید بخش‌های زیر برای گزارش‌دهی آگهی‌های عمودی هتل و سفر به Segments اضافه شد (قابل‌انتخاب با campaign، ad_group، و customer):

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

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

ویژگی‌ها و به‌روزرسانی‌ها نوع شرح
دارایی‌ها
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 مقادیر شمارشی جدید پشتیبانی از دارایی‌های بیانیه سلب مسئولیت نوشتاری اضافه شد.
پویش‌ها
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 فیلدهای جدید انتقال خودکار آتی به «بیشینه‌سازی هوشواره‌ای» را پیگیری کنید.
تبدیل‌ها
سنجش‌های بهینه‌گر نمانام ویژگی‌های جدید با به‌روزرسانی‌های زیر، پشتیبانی از سنجش‌های «بهینه‌گر نمانام» اضافه شد:
اندازه‌گیری‌های بهینه‌گر تبدیل ویژگی‌های جدید با به‌روزرسانی‌های زیر، پشتیبانی از اندازه‌گیری‌های «بهینه‌گر تبدیل» اضافه شد:
  • منبع فقط‌خواندنی جدیدی LiftMeasurementConfig اضافه شد که نشان‌دهنده مطالعه بهینه‌گر است.
  • بخش‌های انتخابی جدیدی به بخش و نتایج بهینه‌گر فیلتر اضافه شد.
  • ۲۴ سنجه جدید «بهینه‌گر تبدیل» و سنجه‌های امتیاز برنده اضافه شد که از تجزیه‌وتحلیل آماری دقیق عملکرد بهینه‌گر پشتیبانی می‌کند.
  • پشتیبانی برای بازیابی جزئیات پویش و هدف‌های تبدیل اضافه شد.
  • فیلد اختیاری جدیدی Experiment.lift_measurement_config اضافه شد.
  • ‫ConversionLiftIncludedConversionActionTypes enum را اضافه کرد.
LiftMeasurementFlight منبع جدید منبع جدید فقط خواندنی که جزئیات پرواز را برای پیکربندی اندازه‌گیری بهینه‌گر نشان می‌دهد، ازجمله تاریخ شروع و پایان پرواز اندازه‌گیری‌شده (start_date و end_date).
عمومی
SmartCampaignError مقادیر شمارشی جدید کدهای خطای خاص جدیدی برای محدودیت‌های تولید «عملکرد بیشینه» اضافه شده است:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION مقدار enum جدید / خطا وقتی پروژه Google Cloud با سطح دسترسی TEST تلاش می‌کند دربرابر حساب غیرآزمایشی درخواست کند، برگردانده می‌شود.
برنامه‌ریزی
اطلاعات آماری احساسات نمانام ویژگی‌های جدید پشتیبانی از اطلاعات آماری احساسات نمانام در ContentCreatorInsightsService اضافه شد:
بهبودهای 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 یک‌ازچند به‌ترتیب، درکنار فیلدهای جدید value_multiplier و high_lifetime_value_multiplier تغییر ساختاری مرجع‌های این فیلدها را به‌روز کنید زیرا اکنون بخشی از oneofs هستند.
منابع قدیمی CustomerLifecycleGoal و CampaignLifecycleGoal، سرویس‌های مربوطه آن‌ها CustomerLifecycleGoalService و CampaignLifecycleGoalService، و تنظیمات/شمارش‌های قدیمی (CustomerAcquisitionGoalSettings،‏ CustomerAcquisitionOptimizationModeEnum،‏ LifecycleGoalValueSettings) هیچ‌کدام برداشتن از طرح‌واره اهداف یکپارچه اصلاح‌شده استفاده کنید:
عمومی
فیلدهای شمارشی تودرتو در پیام‌های درخواست و پاسخ «سرویس مشوق»:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.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 مقدار / رفتار enum جدید برای DemandGenMultiAssetAds دردسترس است. اگر فعال باشد، بااستفاده از تصاویر غیرپویانمایی‌شده به‌عنوان ورودی، تصاویر پویانمایی‌شده تولید می‌کند. DemandGenMultiAssetAds جدید به‌طور پیش‌فرض از این نسخه API شروع می‌شود.
تغییرپذیری اطلاعات محتوای مصنوعی تغییر رفتار Asset.synthetic_content_info و Ad.synthetic_content_info اکنون در نسخه‌های ۲۵، ۲۴، و ۲۳ کاملاً قابل‌تغییر هستند.
پویش‌ها
هدف حفظ وفاداری ویژگی‌ها / تنظیمات جدید پشتیبانی از «هدف حفظ وفاداری» اضافه شد که به تبلیغ‌کنندگان امکان می‌دهد پویش‌ها را برای حفظ اعضای برنامه وفاداری بهینه‌سازی کنند.
هدف «جذب مشتری جدید» ویژگی‌ها / تنظیمات جدید پشتیبانی از «هدف جذب مشتری جدید» در Google Ads API به‌روزرسانی شد تا طرح‌واره اهداف یکپارچه اصلاح‌شده را منعکس کند:
تبدیل‌ها
ارجاع تبدیل طرف سوم YouTube فیلدهای جدید پشتیبانی از درستی‌سنجی اسنادی تبدیل YouTube بااستفاده از شرکای طرف سوم اضافه شد: برای کسب اطلاعات بیشتر، مقاله «مرکز راهنمایی» را ببینید.
عمومی
ContactDetails.phone_number_extension فیلد جدید به منبع LocalServicesLead اضافه شد.
IncentiveError مقادیر enum و خطاهای جدید کدهای خطای خاص جدیدی برای ناموفق بودن پس‌خرید پاداش اضافه شده است:
برنامه‌ریزی
جزئیات کانال YouTube در اطلاعات آماری پرطرفدار فیلدهای جدید پشتیبانی از جزئیات بیشتر کانال YouTube برای ویدیوهای مرتبط هنگام جستجوی اطلاعات آماری پرطرفدار اضافه شد. فیلدهای جدید channel_id، channel_name، و channel_url به YouTubeVideoAttributeMetadata اضافه شد.
YouTubeChannelInsights.data_sharing_consent_given فیلد جدید به YouTubeChannelInsights اضافه شد. این درصورتی درست است که محتواساز با هم‌رسانی داده‌های غیرعمومی موافقت کرده باشد. اگر این‌طور باشد، فیلدهای زیر پر می‌شوند:
گزارش‌ها
ad_sub_format_type بخش جدید تفکیک آگهی‌های ردنشدنی درون جاری‌سازی YouTube را براساس مدت‌زمان ارائه می‌دهد: این بخش باید همیشه همراه با ad_format_type انتخاب شود. با AdGroup، AdGroupAd، Campaign، Customer، Video، و VideoEnhancement قابل انتخاب است.
سنجه‌های اجتماعی مختص ویدیو فیلدها / سنجه‌های جدید سنجه‌های اجتماعی مختص ویدیو اضافه شد تا به تبلیغ‌کنندگان کمک کند تعامل کاربر (نظرات، پسندیدن‌ها، و هم‌رسانی‌ها) را برای آگهی‌های «کوته‌ویدیوها» در YouTube پیگیری کنند: این زبان‌ها عبارتند از AdGroup، AdGroupAd، Asset، Campaign، Customer، و Video.

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

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

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

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

ویژگی‌ها و به‌روزرسانی‌ها نوع شرح
آگهی‌ها
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT مقدار شمارشی جدید اطلاعات نوشتاری را از صفحه مقصد تولید می‌کند تا در پانل تعامل برای DemandGenVideoResponsiveAd نمونه (که به‌طور پیش‌فرض از این نسخه API موافقت کرده‌اند) نشان داده شود.
دارایی‌ها
AssetGroup.google_local_services_info فیلد جدید برای پشتیبانی از اطلاعات «آگهی‌های خدمات محلی» (شناسه دسته و نوشته‌های راهنما) در پویش‌های «عملکرد بیشینه» اضافه شد.
AssetGroupSignal.local_services_id فیلد جدید برای پشتیبانی از نشان‌های شناسه سرویس «آگهی‌های خدمات محلی» در پویش‌های «عملکرد بیشینه» اضافه شده است.
AssetGroupSignal.vertical_ads_item_group_rule_list فیلد جدید برای پشتیبانی از قوانین گروه مورد آگهی‌های عمودی برای انتخاب موارد از فیدهای عمودی پیوست‌شده در پویش‌های «عملکرد بیشینه» اضافه شد. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز دردسترس است.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN مقدار enum جدید / خطا وقتی تلاش می‌کنید همه گروه‌های دارایی را از پویشی بردارید، برگردانده می‌شود.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS مقدار enum جدید / خطا وقتی تلاش می‌کنید همه نشان‌ها را از گروه دارایی بردارید، برگردانده می‌شود.
پویش‌ها
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 مقدار enum جدید / خطا وقتی تلاش می‌کنید همه مکان‌ها را از پویش «عملکرد بیشینه» خدمات محلی بردارید، برگردانده می‌شود.
SmartCampaignErrorEnum.CREATION_FAILED مقدار enum جدید / خطا وقتی تلاش می‌کنید «پویش‌های هوشمند» جدیدی بسازید برگردانده می‌شود.
تبدیل‌ها
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) اضافه شد:
این ویژگی به 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 enum باشد، پر می‌شود. محتواسازان محلی را که در کشور انتخاب‌شده مشاهده شده‌اند یا در آنجا مستقر هستند و با هم‌رسانی داده‌های مکان موافقت کرده‌اند نشان می‌دهد.
GenerateTrendingInsightsRequest.sub_country_locations فیلد جدید به ContentCreatorInsightsService.GenerateTrendingInsights اضافه شد، که امکان جستجوی اطلاعات آماری پرطرفدار را بااستفاده از مکان کشور و مکان‌های فرعی کشور فراهم می‌کند.
گزارش‌ها
PerformanceMaxPlacementView افزونه بخش‌ها توسط ad_network_type قابل‌بخش‌بندی شد.
خرید
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads فیلد جدید اگر درست باشد، کنارگذاری‌های نمانام برای آگهی‌های Shopping نادیده گرفته می‌شود. فقط برای پویش‌های Shopping پشتیبانی می‌شود.
هدف‌گیری
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE مقدار جدید شمارشی / خطا وقتی تلاش می‌کنید زبانی را هدف‌یابی کنید که مجاز نیست برگردانده می‌شود.
ویدیوها
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 مقدار جدید شمارشی / خطا وقتی که جزئیات زمانی روزانه، ساعتی، یا هفتگی درخواست‌شده برای محدوده‌های تاریخ پُرسمان پشتیبانی نمی‌شود برگردانده می‌شود (فقط برای ۳۷ ماه گذشته دردسترس است).
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 مقدار enum جدید / خطا هنگام تلاش برای مستثنی کردن همه هدف‌های جمعیت‌شناسی برگردانده می‌شود.
ویدیوها
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 هیچ‌کدام برداشتن فیلدها و انواع طرح / پیش‌بینی زیر برداشته شد: یکپارچه‌سازی‌ها را متناسب با آن به‌روز کنید.
گزارش‌ها
‫ad_sub_network_type بخش در campaign_budget هیچ‌کدام برداشتن بخش ad_sub_network_type برای منبع campaign_budget برداشته شد.
بخش click_type در بازدیدهای دارایی هیچ‌کدام برداشتن بخش از نماهای AdGroupAsset، CampaignAsset، و CustomerAsset برداشته شد.
ویدیوها
در ShareablePreviewService.GenerateShareablePreviews، موارد ناقص ناموفق مجاز است بدون نقص جزئی تغییر رفتاری اگر هرکدام از شناسه‌های موجود در درخواست اعتبارسنجی نشود، درخواست ناموفق خواهد بود و خطا نشان داده می‌شود.
ShareablePreviewError کد قدیمی: 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) را در پویش‌های «تولید تقاضا» و «برنامه» مجاز می‌کند.
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 مقدار enum جدید / خطا وقتی تلاش می‌کنید چندین فهرست مشابه یکسان ایجاد کنید برگردانده می‌شود.
برنامه‌ریزی
ProductCoreAttributes فیلد در ListPlannableProductsResponse فیلدهای جدید شرح محصول برنامه‌ریزی‌شدنی، هدف بازاریابی، مدل هزینه، و روش خرید به ProductCoreAttributes در ListPlannableProductsResponse اضافه شد.
گزارش‌ها
CartDataSalesView منبع گزارش جدید گزارش‌هایی را نشان می‌دهد که سنجه‌های تبدیل را علاوه‌بر محصول کلیک‌شده، براساس محصول خاص فروخته‌شده (نمانام و غیره) بخش‌بندی می‌کند.
سنجه‌های غیرقابل پیشنهاد قیمت دادنی فیلدهای جدید سنجه‌های غیرقابل پیشنهاد قیمت (سنجه‌هایی که تبدیل‌هایی را نشان می‌دهند که پویش‌ها برای آن‌ها بهینه‌سازی نمی‌شوند) به همه منابع منطبق اضافه شد:
conversion_attribution_event_type بخش جدید به ShoppingPerformanceView اضافه شد.
خرید
پویش‌های برنامه در ShoppingProduct ویژگی جدید «پویش‌های برنامه» پشتیبانی‌شده در منبع ShoppingProduct. وضعیت یادداشت و مشکلات پشتیبانی نمی‌شود.
فیلتر کردن محصول براساس برچسب ویژگی جدید فیلتر کردن بااستفاده از عبارت‌های مجموعه منطقی به‌صورت پویا معرفی شد: این ویژگی فقط برای حساب‌های موجود در فهرست مجاز دردسترس است.

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

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

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

ویژگی‌های جدید و به‌روزرسانی‌های زیر در Google Ads API v23.3 اضافه شده است. نسخه‌های جزئی مانند 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) اضافه شد:

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

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در Google Ads API v23.2 اضافه شده است. نسخه‌های جزئی مثل 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 اضافه شده است. نسخه‌های جزئی مثل 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 ویژگی‌های جدید / پشتیبانی دارایی‌های «پیام کاری» به‌روزشده:
صورت‌حساب
InvoiceService.ListInvoices گزینه‌های جدید اکنون با تنظیم include_granular_level_invoice_details در ListInvoicesRequest، می‌توانید جزئیات دقیق‌تری را در Invoice برگردانید، ازجمله تفکیک هزینه سطح پویش، هزینه‌های نظارتی جزئی، و اطلاعات اصلاح.
RegulatoryFeeType
UnitOfMeasure		 شمارش‌های جدید تعداد ثابت‌های کمکی برای کارمزدهای نظارتی و واحدهای اندازه‌گیری اضافه شد.
پویش‌ها
CampaignError مقادیر / خطاهای جدید شمارشی کدهای خطای DURATION_TOO_LONG_FOR_TOTAL_BUDGET و END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET اضافه شد.
تبدیل‌ها
ConversionActionCategory مقدار شمارشی جدید YOUTUBE_FOLLOW_ON_VIEWS برای پشتیبانی از ردیابی کاربرانی که آگهی را تماشا می‌کنند و بعداً ویدیویی را از همان کانال تماشا می‌کنند اضافه شد.
افزایش تقاضا
DemandGenVideoResponsiveAdInfo.companion_banner فیلد جدید پشتیبانی از برنماهای همراه در آگهی‌های ویدیویی واکنش‌گر «تولید تقاضا» اضافه شد.
مشوق‌ها
پشتیبانی از مشوق‌های «انتخاب با شما» (CYO) اضافه شد:

برای تسهیل کردن مدیریت برنامه‌ریزی‌شده دقیق‌تر خطاها، در نسخه‌های پخش آینده کدهای خطای بیشتری به 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 مقدار enum جدید / خطا کد خطای INVALID_VIDEO_LINEUP_ID اضافه شد.
سنجه‌های شنیداری YouTube معیارهای سنجش جدید سنجه‌های شنیداری برای آگهی‌های صوتی در YouTube اضافه شد که گزارش می‌دهد آیا آگهی شنیدنی بوده است یا نه و در چند ظهور، شنیداری قابل‌اندازه‌گیری بوده است.

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

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