נתוני גרסה

כאן אפשר לעיין ברשימה עדכנית של תכונות שיוצאות משימוש או שתכננו להוציא אותן משימוש.

גרסאות ראשיות ומשניות של v25

גרסה 25 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור את התאימות לאחור.

גרסה 25.1‏ (19.08.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 25.1 של Google Ads API. גרסאות משניות כמו v25.1 לא מכילות שינויים שעלולים לגרום לכשל.

תכונות ועדכונים	סוג	תיאור
נכסים
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	ערכי enum חדשים	הוספנו תמיכה בנכסי כתב ויתור בטקסט.
קמפיינים
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	שדות חדשים	מעקב אחרי ההעברה האוטומטית הקרובה ל-AI למיקסום ביצועים.
המרות
מדידות של התחזקות המותג	תכונות חדשות	הוספנו תמיכה במדידת התחזקות המותג עם העדכונים הבאים: נוספו משאבים חדשים לקריאה בלבד של נתונים ממחקרים למדידת שיפור: LiftMeasurementAgeRange,‏ LiftMeasurementCampaign,‏ LiftMeasurementDevice,‏ LiftMeasurementGender ו-LiftMeasurementVideo. הוספנו פלחים ומדדים חדשים כדי לתמוך בניתוח של התחזקות המותג באמצעות LiftMeasurementConfig ומשאבי המימדים החדשים. נוספו ערכי ה-enum הבאים: BrandLiftMeasurementType,‏ LiftMeasurementFlightStatus,‏ SurveyIntendedAction,‏ SurveyLiftFlightTargetResponseMode ו-SurveySubjectType.
מדידות של עלייה בהמרות	תכונות חדשות	הוספנו תמיכה במדידת עלייה בהמרות עם העדכונים הבאים: נוסף משאב חדש לקריאה בלבד, LiftMeasurementConfig, שמייצג מחקר למדידת שיפור. הוספנו פלחים חדשים שאפשר לבחור כדי לפלח ולסנן את תוצאות העלייה. הוספנו 24 מדדים חדשים של עלייה בהמרות ומדדים של ניקוד המנצח, שתומכים בניתוח סטטיסטי מפורט של ביצועי העלייה. הוספנו תמיכה באחזור פרטי קמפיין ויעדי המרה. נוסף שדה אופציונלי חדש Experiment.lift_measurement_config. נוסף ה-enum‏ ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	משאב חדש	משאב חדש לקריאה בלבד שמייצג את פרטי הטיסה להגדרה של מדידת שיפור, כולל תאריכי ההתחלה והסיום של הטיסה שנמדדה (start_date ו-end_date).
כללי
SmartCampaignError	ערכי enum חדשים	נוספו קודי שגיאה ספציפיים חדשים למגבלות על יצירת נכסים בקמפיינים למיקסום הביצועים: 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 עם רמת גישה TEST מנסה לשלוח בקשות לחשבון שאינו חשבון בדיקה.
תכנון
תובנות לגבי הסנטימנט כלפי המותג	תכונות חדשות	הוספנו תמיכה בתובנות לגבי סנטימנט המותג ב-ContentCreatorInsightsService: הוספנו את ההודעות BrandSentimentInsight,‏ SentimentInsightDistribution ו-SentimentInsightSummary. נוסף ה-enum‏ Sentiment. הוספנו את הערך BRAND_SENTIMENT_DATA ל-enum ContentCreatorInsightsSupplementalData. הוספנו את הערך BRAND ל-enum 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.

גרסה 25 (22.07.2026)

התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות נוספו לגרסה 25 של Google Ads API, שהיא גרסה ראשית.

הנחיות מפורטות זמינות במאמר בנושא שדרוג לגרסה העדכנית ביותר.

שינויים בתוכנה שעלולים לגרום לכשלים

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
קמפיינים
שדות עצמאיים additional_value ו-additional_high_lifetime_value ב-CustomerLifecycleOptimizationValueSettings	חלק מהשדות value_adjustment ו-high_lifetime_value_adjustment oneof בהתאמה, לצד השדות החדשים 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 כדי להגדיר שינויים ספציפיים לקמפיין.
כללי
שדות enum בתוך שדות בהודעות בקשה ותגובה של שירות התמריצים: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	שדות enum עצמאיים: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	שינוי שם / הסרה	משתמשים בשדות החדשים של enum עצמאיים במקום בשדות הקודמים של 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. אם האפשרות הזו מופעלת, המערכת יוצרת תמונות מונפשות באמצעות תמונות לא מונפשות כקלט. החל מגרסת ה-API הזו, DemandGenMultiAssetAds חדשים מופעלים כברירת מחדל.
אפשרות לשינוי של מידע על תוכן סינתטי	שינוי התנהגות	האובייקטים Asset.synthetic_content_info ו-Ad.synthetic_content_info ניתנים עכשיו לשינוי באופן מלא בגרסאות 25, 24 ו-23.
קמפיינים
יעד שימור נאמנות	תכונות או הגדרות חדשות	הוספנו תמיכה ביעד 'שימור חברים במועדון הלקוחות', שמאפשר למפרסמים לבצע אופטימיזציה של קמפיינים כדי לשמר חברים במועדון הלקוחות. הוספנו את LOYALTY_RETENTION לספירה GoalType. הוספנו את CampaignGoalConfig.campaign_loyalty_retention_settings כדי להגדיר הגדרות שימור ספציפיות לקמפיין, כולל התאמות של הצעות מחיר והצגת הטבות לחברי מועדון בפורמט PLA. נוספה האפשרות Goal.loyalty_retention_goal_settings להגדרת יעדי שימור ברמת החשבון. הוספנו קודי שגיאה חדשים: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
היעד 'צירוף לקוחות חדשים'	תכונות או הגדרות חדשות	עדכנו את התמיכה ביעד 'צירוף לקוחות חדשים' ב-Google Ads API כדי לשקף את סכימת היעדים המאוחדת המשופצת: הרחבנו את המשאב Goal כדי לתמוך בהגדרות של צירוף לקוחות חדשים באמצעות השדה new_customer_acquisition_goal_settings. הרחבנו את המשאב CampaignGoalConfig כדי לתמוך בשינויים ספציפיים לקמפיין לצירוף לקוחות חדשים באמצעות השדה campaign_new_customer_acquisition_settings. נוסף ה-enum החדש CustomerLifecycleOptimizationGoalSubType כדי להגדיר סוגי משנה נתמכים של יעדים. הוספנו את 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	פלח חדש	פירוט של מודעות וידאו In-stream ב-YouTube שלא ניתן לדלג עליהן לפי משך: ‫INSTREAM_NON_SKIPPABLE_STANDARD (מודעת וידאו In-stream רגילה שלא ניתן לדלג עליה) ‫INSTREAM_NON_SKIPPABLE_MAX30_SEC (מודעת וידאו In-stream שאי אפשר לדלג עליה באורך של עד 30.99 שניות) ‫INSTREAM_NON_SKIPPABLE_MAX60_SEC (מודעת וידאו Instream שאי אפשר לדלג עליה, באורך של עד 60.99 שניות) תמיד צריך לבחור את הפלח הזה יחד עם ad_format_type. אפשר לבחור אותו באמצעות AdGroup,‏ AdGroupAd,‏ Campaign,‏ Customer,‏ Video ו-VideoEnhancement.
מדדים ספציפיים לרשתות חברתיות שקשורים לסרטונים	שדות או מדדים חדשים	הוספנו מדדים ספציפיים לרשתות חברתיות לגבי סרטונים, כדי לעזור למפרסמים לעקוב אחרי מעורבות המשתמשים (תגובות, לייקים ושיתופים) במודעות ב-Shorts ב-YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares הם זמינים ב-AdGroup,‏ AdGroupAd,‏ Asset,‏ Campaign,‏ Customer ו-Video.

גרסאות ראשיות ומשניות של v24

גרסה 24 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור את התאימות לאחור.

גרסה 24.2‏ (24.06.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 24.2 של Google Ads API. גרסאות משניות כמו v24.2 לא מכילות שינויים שעלולים לשבור את התאימות.

תכונות ועדכונים	סוג	תיאור
מודעות
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	ערך חדש של טיפוס בן מנייה (enum)	יוצר מידע טקסט מדף הנחיתה שיוצג בחלונית ההתקשרות עם הלקוח עבור מופעים של DemandGenVideoResponsiveAd (שמופעלים כברירת מחדל החל מגרסת ה-API הזו).
נכסים
AssetGroup.google_local_services_info	שדה חדש	הוספנו תמיכה בפרטים של מודעות לקידום עסקים מקומיים (מזהה קטגוריה ויתרונות מרכזיים) בקמפיינים למיקסום הביצועים.
AssetGroupSignal.local_services_id	שדה חדש	הוספנו תמיכה באותות של מזהי שירותים של מודעות "Google לבעלי מקצוע" בקמפיינים למיקסום הביצועים.
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	שדות חדשים	תמיכה בזיהוי קמפיינים למיקסום ביצועים של Google בעלי מקצוע.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	שדה חדש	הוספנו את מפות Google לערוצים שאפשר לבחור לקבוצות של מודעות ליצירת ביקוש.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של מודעות "Google לבעלי מקצוע".
SmartCampaignErrorEnum.CREATION_FAILED	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים ליצור קמפיינים חכמים חדשים.
המרות
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	ערכי enum חדשים	מייצג המרות שמתרחשות כשמשתמש לוחץ על מודעה של ספק שירותים מקומיים ומתקשר למפרסם, שולח לו הודעה או מזמין ממנו שירות.
ניסויים
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	ערכי enum חדשים	הוספנו תמיכה בסוגים חדשים של ExperimentType: ‫COMPARE_CAMPAIGNS: לניסויים בתמהיל קמפיינים ולניסויים מותאמים אישית בקמפיינים למיקסום הביצועים שמשווים בין כמה קמפיינים מאותו סוג או מסוגים שונים בניסוי אחד. ‫PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: לניסויים לאופטימיזציה של קמפיינים למיקסום הביצועים שקשורים להתאמה אישית של טקסט ולהתאמת כתובת URL סופית.
כללי
Asset.synthetic_content_info Ad.synthetic_content_info	שדות חדשים	כוללים הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו אוטומטית או שסופקו על ידי המערכת). התכונה הזו הועברה לאחור (backported) לגרסאות v23 ו-v22. כדי לעזור לכם לתכנן את עבודת השילוב הקרובה שלכם עם גרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות האישור של המפרסם בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל הערכים של synthetic_content_info.advertiser_attestation.status ושל synthetic_content_info.advertiser_attestation.source יישארו ללא שינוי בגרסאות האלה. אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: ‫"The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או ‫"Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה 25 תושק.
אישור על ידי גורמים מרובים	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. הוספנו תמיכה בביקורות של אישורים ממספר משתמשים (MPA): נוספו המשאב MultiPartyAuthReview וMultiPartyAuthReviewService התואם. נוסף ה-enum‏ MultiPartyAuthReviewStatus כדי לעקוב אחרי סטטוס הביקורת. נוספה אפשרות 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	ערך חדש של טיפוס בן מנייה (enum)	התווסף ל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	שדה חדש	אם הערך הוא True, המערכת מתעלמת מהחרגות של מותגים במודעות שופינג. התמיכה זמינה רק לקמפיינים של שופינג.
טירגוט
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים לטרגט שפה שלא מותרת.
סרטונים
DataLink.youtube_link_metadata	שדה חדש	מכיל את הערך brand_channel_id כדי לציין את המזהה של ערוץ המותג המקושר ב-YouTube.

גרסה 24.1‏ (13.05.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 24.1 של Google Ads API. גרסאות משניות כמו v24.1 לא מכילות שינויים שעלולים לשבור את הקוד.

תכונות ועדכונים	סוג	תיאור
מודעות
DemandGenMultiAssetAdInfo.classic_display_images	שדה חדש	תמונות לרשת המדיה שהועלו בהתאמה אישית מוצגות בלי שנדרשים נכסים רספונסיביים נוספים.
ניסויים
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	ערכי enum חדשים	הוספנו תמיכה בסוגים חדשים של ExperimentType: ‫ADOPT_AI_MAX: לניסויים שבודקים איך AI למיקסום ביצועים יכול לעזור לכם להגיע ליותר לקוחות באמצעות Google AI ומילות מפתח בהתאמה רחבה. ‫ADOPT_BROAD_MATCH_KEYWORDS: לניסויים שבודקים איך מילות מפתח בהתאמה רחבה יכולות להשפיע על מספר החיפושים שבהם המודעות שלכם מופיעות. ‫OPTIMIZE_ASSETS: לניסויים בהתאמה אישית לאופטימיזציה של נכסים. ‫PMAX_REPLACEMENT_SHOPPING: לניסויים שבודקים את הביצועים של קמפיינים שופינג בהשוואה לקמפיינים למיקסום הביצועים.
Experiment.video_experiment	שדה חדש	תמיכה בהגדרת ניסויים קיימים של YOUTUBE_CUSTOM שכוללים קמפיינים של מודעות וידאו.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	שדות חדשים	הוספנו שדות לתמיכה בבדיקת נכסים, בקבוצות נכסים ובהגדרות של קמפיינים למיקסום הביצועים בקבוצות ניסוי: ‫asset_testing_info: פרטים על נכסים שמשויכים לעותקים הניסיוניים של המודעות. ‫asset_groups: רשימה של קבוצות נכסים בקבוצת הניסויים של ניסויים בנכסי Optimize. ‫performance_max_experiment_arm_info: הגדרות של קמפיינים למיקסום הביצועים בניסויים של PMAX_REPLACEMENT_SHOPPING.
כללי
CustomerUserAccess.passkey_enabled	שדה חדש	שדה לקריאה בלבד שמציין אם למשתמש יש מפתח גישה.
דוחות
mobile_device_platform	פלח חדש	מאפשר לפלח את הדוחות לפי הפלטפורמה של מכשיר המשתמש (למשל iOS או Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	ערך enum חדש / שגיאה	הערך שמוחזר כשגרעיניות הזמן היומית, השעתית או השבועית המבוקשת לא נתמכת בטווח התאריכים של השאילתה (זמינה רק ל-37 החודשים האחרונים).
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	ערך חדש של טיפוס בן מנייה (enum)	פרסמנו את ZEFR כשותפה לשילוב מוצרי Google למדידת הניראות.
DataLink.youtube_video.channel_id	שדה חדש	הפונקציה חושפת את מזהה הערוץ ב-YouTube שמשויך לקישור הנתונים.

גרסה 24‏ (22.04.2026)

התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות נוספו לגרסה 24 של 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 type	שינוי באופן הפעולה / שינוי סוג	צריך לעדכן את השילובים של ספריות לקוח עם הקלדה כדי להשתמש במרחבי השמות החדשים של המשאבים.
השדה youtube_select_lineups בReachPlanService.ListPlannableProducts	ללא	הסרה	מעבר לשימוש בחבילות ערוצים מ-youtube_select_lineup_targeting.
השדה is_brand_connect_creator ב-ContentCreatorInsightsService.GenerateCreatorInsights וב-GenerateTrendingInsights	ללא	הסרה	במקום זאת, כדאי לבדוק אם היוצר מציע את CREATOR_PARTNERSHIPS ב-partnership_opportunities.
‫geo_modifiers ו-biddable_keywords ב-KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants וגם keywords	שינוי שם / הסרה	הוחלף על ידי CampaignToForecast.geo_target_constants[] ו-ForecastAdGroup.keywords[].
שדות שיצאו משימוש בתחזית או בתוכנית מילות המפתח ב-GenerateKeywordForecastMetrics	ללא	הסרה	הוסרו השדות והסוגים הבאים של תוכניות ותחזיות: CampaignToForecast.keyword_plan_network הפקודה CampaignToForecast.negative_keywords והפקודה ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate מעדכנים את השילובים בהתאם.
דוחות
פלח ad_sub_network_type בcampaign_budget	ללא	הסרה	הוסר פלח ad_sub_network_type מהמשאב campaign_budget.
click_type פלח בתצוגות של נכסים	ללא	הסרה	הפלח הוסר מהתצוגות AdGroupAsset,‏ CampaignAsset ו-CustomerAsset.
סרטונים
כשל חלקי מותר בShareablePreviewService.GenerateShareablePreviews	אין כשלים חלקיים	שינוי באופן הפעולה	אם אחד מהמזהים לא יעבור את האימות, הבקשות ייכשלו ותוצג שגיאה.
ShareablePreviewError קודים מדור קודם: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	שינוי השם / שינוי באופן הפעולה	קודי השגיאה שמוחזרים לקבוצות נכסים משתנים כדי להתאים לשגיאות במודעות בקבוצות של מודעות. עדכון הלוגיקה של תפיסת אימות.

תכונות ועדכונים (לא משבשים)

תכונות ועדכונים	סוג	תיאור
מודעות
יכולת השינוי של VideoResponsiveAdInfo	שינוי התנהגותי	אובייקטים של מידע על מודעות וידאו רספונסיביות ניתנים עכשיו לשינוי.
נכסים
‫travel_feed_data ב-AssetSet	שדה חדש	נוסף כדי לאחזר מאפיינים של נכסים בפיד נסיעות (hotel_center_account_id, ‏ merchant_center_id, ‏ partner_center_id, ‏ subset_id, ‏ travel_feed_vertical_type).
קמפיינים
Campaign.view_through_conversion_optimization_enabled	שדה חדש	מאפשר להפעיל אופטימיזציה להמרות בעקבות צפייה (VTC) (ברירת מחדל false) בקמפיינים ליצירת ביקוש ובקמפיינים לקידום אפליקציות.
CampaignCriterion.gender	תכונה חדשה	הפעלנו החרגות של מגדר בקמפיינים למיקסום הביצועים בכל הגרסאות של Google Ads API.
המרות
סוגי המרות של לידים	ערכי enum חדשים	נוספו סוגי enum חדשים של פעולות המרה ב-GA4/Firebase ב-ConversionActionType: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
כללי
UserListErrorEnum.DUPLICATE_LOOKALIKE	ערך enum חדש / שגיאה	השגיאה מוחזרת כשמנסים ליצור כמה רשימות זהות של קהלים דומים.
תכנון
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

גרסה 23 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות.

גרסה 23.3 ‏ (24.06.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.3 של Google Ads API. גרסאות משניות כמו v23.3 לא מכילות שינויים שעלולים לשבור את התאימות.

תכונות ועדכונים	סוג	תיאור
כללי
Asset.synthetic_content_info Ad.synthetic_content_info	שדות חדשים	כוללות אישורים לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקים ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (אישורים שזוהו או סופקו באופן אוטומטי על ידי המערכות של Google). כדי לעזור לכם לתכנן את עבודת השילוב הקרובה שלכם עם גרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות האישור של המפרסם בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל הערכים של synthetic_content_info.advertiser_attestation.status ושל synthetic_content_info.advertiser_attestation.source יישארו ללא שינוי בגרסאות האלה. אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: ‫"The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או ‫"Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה 25 תושק.
קבלת אישור ממספר משתמשים	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. הוספנו תמיכה בביקורות של אישורים ממספר משתמשים (MPA): נוספו המשאב MultiPartyAuthReview וMultiPartyAuthReviewService התואם. נוסף ה-enum‏ MultiPartyAuthReviewStatus כדי לעקוב אחרי סטטוס הביקורת. נוספה אפשרות CustomerUserAccess.pending_multi_party_auth_review לקישור לביקורת בהמתנה. נוספו MutateCustomerUserAccessResult.multi_party_auth_review ו-MutateCustomerUserAccessInvitationResult.multi_party_auth_review כדי להחזיר את שם משאב הביקורת המשויך. נוספה MultiPartyAuthReviewError לשגיאות אימות.

גרסה 23.2 ‏ (25.03.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.2 של Google Ads API. גרסאות משניות כמו v23.2 לא מכילות שינויים שעלולים לשבור את התאימות.

תכונות ועדכונים	סוג	תיאור
נכסים
VideoEnhancement	משאב חדש	מכיל מידע ספציפי על מודעות וידאו שעברו שיפור, כמו האם הן נוצרו על ידי Google או סופקו על ידי המפרסם. מידע נוסף על התכונה "שיפור סרטונים"
AppTopCombinationView	משאב חדש	משאב לקריאה בלבד שמספק תובנות לגבי שילובי הנכסים שמניבים את הביצועים הכי טובים בקמפיינים לקידום אפליקציות.
CustomerAsset	תכונה חדשה	הוספנו תמיכה באחזור של CustomerAsset עם הערך BUSINESS_LOGO של field_type.
קמפיינים
AdGroupAd.start_date_time AdGroupAd.end_date_time	שדות חדשים	הגדרת אילוצים מפורטים יותר לגבי התזמון של תאריכי הקמפיין. האפשרות הזו נתמכת רק בחלק מסוגי קבוצות המודעות.
HotelSettingInfo.disable_hotel_setting	שדה חדש	מאפשר להשבית את פיד המלונות בקמפיינים ליצירת ביקוש.
כללי
CustomerClientLinkError	ערכי enum חדשים / שגיאות	נוספו שני קודי שגיאה חדשים: MAX_CUSTOMER_LIMIT_REACHED ו-ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	שינוי התנהגותי	אם מנסים להשתמש בקטגוריה הזו של סוג הלקוח (רשימת משתמשים שהוצאה משימוש), מוצגת שגיאה.
תכנון
GenerateTrendingInsights GenerateCreatorInsights	תכונות חדשות	הוספנו תמיכה בשילובים מותאמים אישית של ישויות, נושאים וקהלים באמצעות AND/OR.
ReachPlanService.GenerateReachForecast	ערכי enum חדשים	נוספו טווחי גילאים חדשים לטירגוט, כמו AGE_RANGE_21_44 או AGE_RANGE_21_49.
youtube_select_lineup_targeting	שדה חדש	נוסף ל-ReachPlanService.ListPlannableProducts, שיחליף את youtube_select_lineups. שני השדות מאוכלסים כרגע.
ReachPlanSurface	ערך חדש של טיפוס בן מנייה (enum)	הוספנו את IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS כאפשרות בקטע 'פלטפורמה'.
Forecast	שדה חדש	נוספה האפשרות clicks לקמפיינים ליצירת ביקוש עם אסטרטגיית הבידינג 'מקסימום קליקים' (CPC) ב-ReachPlanService.GenerateReachForecast.
partnership_opportunities	שדה חדש	נוסף אל ContentCreatorInsightsService.GenerateCreatorInsights ואל ContentCreatorInsightsService.GenerateTrendingInsights.
דוחות
biddable_indirect_install_first_in_app_conversion_micros	שדה חדש	נוספו למקורות המידע Campaign,‏ Customer ו-AdGroup.
סרטונים
ShareablePreviewService	תכונה חדשה	הוספנו תמיכה בתצוגות מקדימות של YouTube בשידור חי. כדי להפעיל את התכונה, צריך להגדיר את preview_type לערך YOUTUBE_LIVE_PREVIEW. הוספת את UNSUPPORTED_AD_TYPE ואת TOO_MANY_RESOURCES_IN_REQUEST אל ShareablePreviewError. האפשרות הזו נתמכת רק בחלק מסוגי המודעות.

גרסה 23.1 ‏ (25.02.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.1 של Google Ads API. גרסאות משניות כמו v23.1 לא מכילות שינויים שעלולים לגרום לכשל.

תכונות ועדכונים	סוג	תיאור
ניהול חשבון
advertising_partner_properties.allowed_domain	שדה חדש	נוספו למשאבים של ProductLinkInvitation ושל ProductLink. השותף לקניית שטחי פרסום יוכל לפרסם רק בדומיין הזה.
Customer.contains_eu_political_advertising	שדה חדש	הפונקציה מאחזרת את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם החשבון מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזירה EuPoliticalAdvertisingStatus.
קמפיינים
Campaign.text_guidelines	שדה חדש	הוספנו תמיכה בהנחיות לניסוח טקסטים, שאפשר להשתמש בהן בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש כדי לשלוט באופן פרוגרמטי בנכסי טקסט שנוצרו על ידי AI. ב-text_guidelines אפשר להגדיר את term_exclusions ואת messaging_restrictions.
CampaignPrimaryStatusReason	ערכי enum חדשים	הוספנו את 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	שדה חדש	אפשר להשתמש ב-API כדי לשלוח שאילתות ולסנן קמפיינים שחסרות בהם הצהרות לגבי פרסום פוליטי שמטורגט לאיחוד האירופי.
המרות
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	ערך חדש של טיפוס בן מנייה (enum)	תומך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ.
כללי
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	ערך enum חדש / שגיאה	השגיאה הזו מוחזרת כשמנסים לטרגט רק את הקטגוריה 'לא ידוע' במאפיינים הדמוגרפיים.
תמריצים
IncentiveErrorEnum	ערכי enum חדשים / שגיאות	נוספו שני קודי שגיאה חדשים: MAX_INCENTIVES_REDEEMED ו-ACCOUNT_TOO_OLD. יכול להיות שהשגיאות האלה יוחזרו לבקשות שיישלחו ב-11 במרץ 2026 או אחרי התאריך הזה.
תכנון
GenerateBenchmarksMetrics	תכונה חדשה	הוספנו תמיכה בפירוטים לפי תאריך באמצעות BreakdownDefinition.
ReachPlanService.GenerateReachForecast	ערך חדש של טיפוס בן מנייה (enum)	הוספנו את 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	ערך חדש של טיפוס בן מנייה (enum)	הוספנו את VERTICAL_ADS_DATA_FEED כדי לתמוך בפידים של נתוני מודעות אנכיות, כמו טירגוט ישויות של מודעות נסיעות.
YouTubeVideoUpload
YouTubeVideoUpload	שירות או משאב חדש	הוספנו את השירות YouTubeVideoUpload כדי לתמוך בהעלאה ובניהול של סרטונים ב-YouTube, ואת המשאב YouTubeVideoUpload כדי לתמוך באחזור של סטטוס ההעלאה ומטא-נתונים. התכונה הזו נתמכת רק ב-REST ובספריית הלקוח של Python.

גרסה 23 ‏ (28.01.2026)

התכונות החדשות, העדכונים והשינויים שעלולים לשבור תאימות שנוספו בגרסה 23 של 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 הוסר. מעדכנים את ההפניות בקוד.
דוחות
מדדים נצברים של תוויות לציון רמת ביצועים של נכסים וסוגי ספירה	ללא	הסרה	הוסרו מדדים של תוויות ביצועים של נכסים מצטברים. הספירה (enum) של תוויות לציון רמת ביצועים לא מוחזרת יותר עבור קמפיינים לרשת החיפוש ולרשת המדיה.

תכונות ועדכונים (לא משבשים)

תכונות ועדכונים	סוג	תיאור
מודעות
AdFormatType	ערכי enum חדשים	נוספו סוגי פורמטים חדשים: 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	תכונה חדשה	הוספנו תמיכה באחזור נכסים של קמפיין עם הערכים HEADLINE ו-DESCRIPTION של field_type.
ServedAssetFieldType	ערכי enum חדשים	נוספו HEADLINE_AS_SITELINK_POSITION_ONE,‏ HEADLINE_AS_SITELINK_POSITION_TWO,‏ DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE ו-DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO לנכסים שמוצגים כתוספי Sitelink.
BusinessMessageAsset	תכונות חדשות / תמיכה	נכסים מעודכנים של שליחת הודעות לעסק: הוספנו תמיכה ב-Facebook Messenger וב-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	סוגי enum חדשים	נוספו סוגי enum של עזרים לעמלות בהתאם לחוק וליחידות מידה.
קמפיינים
CampaignError	ערכי enum חדשים / שגיאות	נוספו קודי השגיאה DURATION_TOO_LONG_FOR_TOTAL_BUDGET ו-END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
המרות
ConversionActionCategory	ערך חדש של טיפוס בן מנייה (enum)	נוספה התכונה YOUTUBE_FOLLOW_ON_VIEWS כדי לתמוך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ.
יצירת ביקוש
DemandGenVideoResponsiveAdInfo.companion_banner	שדה חדש	הוספנו תמיכה במודעות באנר נלוות במודעות וידאו רספונסיביות ליצירת ביקוש.
תמריצים
הוספנו תמיכה בבחירת תמריצים (CYO): נוספה השיטה FetchIncentive לאחזור תמריצים מותאמים אישית שזמינים למשתמש. הוספנו את השיטה ApplyIncentive להחלת תמריץ נבחר על חשבון לקוח. הוספנו את המשאב AppliedIncentive (שאפשר להריץ עליו שאילתות באמצעות Search ו-SearchStream) כדי לספק פרטים על מימוש השוברים. נוספו קודי שגיאה חדשים ב-IncentiveError וב-AuthenticationError.INVALID_EMAIL_ADDRESS. כדי לאפשר טיפול מפורט יותר בכשלים באמצעות תוכנות, נוסיף קודי שגיאה נוספים ל-IncentivesService בגרסאות עתידיות. כדי לוודא שהאפליקציות שלכם יוכלו להתמודד עם מצבי הכשל החדשים האלה, מומלץ לעקוב אחרי ההודעות הקרובות והערות הגרסה לגבי קודי השגיאה החדשים האלה.
תכנון
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	ערך חדש של טיפוס בן מנייה (enum)	מאפשר ליצור קהלים באמצעות אירועים משמעותיים בחיים ב-GenerateAudienceCompositionInsights, ב-GenerateSuggestedTargetingInsights, ב-GenerateInsightsFinderReport וב-GenerateCreatorInsights. אין תמיכה באירועים משמעותיים בחיים בשיטות אחרות של AudienceInsightsService, כמו AudienceInsightsService.GenerateAudienceOverlap ו-AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	שדות או אפשרויות חדשים	התשובה כוללת עכשיו פלטפורמות לתמיכה בהצעות לשיעור המרה על סמך אמצעי בקרה בפלטפורמה (למשל, Gmail, ‏ Shorts). האפשרות הזו נתמכת רק בקמפיינים ליצירת ביקוש.
LanguageDistribution	שדה חדש / סוג	נוסף ל-YouTubeChannelInsights כדי לספק פרטים על התפלגות השפות בתוכן של ערוץ YouTube.
BenchmarksService	שירות חדש	השוואה בין נתוני הפרסום ב-YouTube לבין נתונים להשוואה לשוק.
AudienceInsightsService.GenerateAudienceDefinition	שיטה חדשה	תרגום של תיאור חופשי של קהל יעד למאפייני קהל תואמים באמצעות AI גנרטיבי.
YouTubeChannelInsights.relevance_score	שדה חדש	המדד הזה מעריך את הרלוונטיות של יוצר לנושא מסוים, לפי משקל הצפיות.
TrendInsightMetrics.trend_change_percent	שדה חדש	מייצג את השינוי באחוזים בערך של מגמה לאורך תקופת ההשוואה.
המלצות
GenerateRecommendationsRequest	שדה חדש	is_new_customer נוסף. אם מגדירים את הערך true להמלצות CAMPAIGN_BUDGET, המערכת משתמשת במודל שעבר אופטימיזציה ללקוחות חדשים (מומלץ רק ללקוחות שאין להם קמפיינים).
דוחות
AdGroupAdAssetView	תמיכה בתכונות או במדדים חדשים	מעכשיו יש תמיכה במדדי חשיפות, ביצועים והמרות ב-RESPONSIVE_DISPLAY_AD.
פלח אחד (ad_sub_network_type)	פלח חדש	פירוט הביצועים ברמה מפורטת בתוך רשת מודעות. האפשרות הזו זמינה בשלב הראשוני לקמפיינים ליצירת ביקוש ב-YouTube (מודעות וידאו In-stream, מודעות בגוף הפיד, מודעות ב-Shorts). חובה לבחור את האפשרות הזו יחד עם 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 (לקמפיינים למיקסום הביצועים) כדי לספק מדדי ביצועים לפי מיקומים גיאוגרפיים שהמשתמשים התעניינו בהם.
קניות
ShoppingPerformanceView	תמיכה במדדים חדשים	מעכשיו יש תמיכה במדדים הבאים שמפולחים לפי תאריך ההמרה: conversions_by_conversion_date,‏ all_conversions_by_conversion_date,‏ conversions_value_by_conversion_date,‏ value_per_conversions_by_conversion_date ו-value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	תמיכה במדדים חדשים	נוספה תמיכה ב: search_budget_lost_impression_share,‏ search_rank_lost_impression_share,‏ search_budget_lost_absolute_top_impression_share ו-search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	שדה חדש	נוסף אל ShoppingProduct.
מודעות בפורמט אנכי
AdGroup.vertical_ads_format_setting	שדה חדש	ההגדרה הזו מאפשרת לכם לשלוט בפורמטים של המודעות שיוצגו בקמפיינים לרשת החיפוש באמצעות פידים של נתוני נסיעות.
AdGroupCriterion SharedCriterion	שדות או קריטריונים חדשים	הוספנו את סוג הקריטריון vertical_ads_item_group_rule_list אל AdGroupCriterion ואת vertical_ads_item_group_rule אל SharedCriterion כדי לאפשר טירגוט של קבוצות פריטים בקמפיינים לרשת החיפוש באמצעות פידים של נתוני נסיעות.
שילוב של פיד נתונים של מודעות בפורמט אנכי	תכונה חדשה	מעכשיו אפשר לקשר פיד נתונים של מודעות בענף מסוים לקמפיין לרשת החיפוש שמופעל בו AI למיקסום ביצועים, כדי להציג מודעות לקידום נכסים ומודעות עם קישור להזמנה לצד מודעות טקסט. אפשר לשלוט בפורמטים באמצעות vertical_ads_format_setting ולהגדיר כללים באמצעות vertical_ads_item_group_rule. פילוח הדיווח לפי AdFormatType ומימדים של פיד נתוני מודעות אנכיות.
סרטונים
AdVideoAssetInfo.ad_video_asset_feature_control	שדה חדש	נוספו אפשרויות לשליטה בתכונות של נכסי וידאו למודעות.
CampaignCriterionError	ערך enum חדש / שגיאה	נוסף קוד השגיאה INVALID_VIDEO_LINEUP_ID.
מדדים של שמיעת מודעות ב-YouTube	מדדים חדשים	הוספנו מדדים של שמיעת מודעות אודיו ב-YouTube. המדדים האלה מראים אם המודעה הייתה נשמעת, ובכמה חשיפות אפשר היה למדוד את השמיעה.

גרסאות ראשיות ומשניות של v22

גרסה 22 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור את התאימות לאחור.

גרסה 22.2‏ (24.06.2026)

התכונות והעדכונים החדשים הבאים נוספו לגרסה 22.2 של Google Ads API. גרסאות משניות כמו v22.2 לא מכילות שינויים שעלולים לגרום לכשל.

תכונות ועדכונים	סוג	תיאור
כללי
Asset.synthetic_content_info Ad.synthetic_content_info	שדות חדשים	כוללות אישורים לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקים ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (אישורים שזוהו או סופקו באופן אוטומטי על ידי המערכות של Google). כדי לעזור לכם לתכנן את עבודת השילוב הקרובה של גרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות האישור של המפרסם בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל הערכים של synthetic_content_info.advertiser_attestation.status ושל synthetic_content_info.advertiser_attestation.source יישארו ללא שינוי בגרסאות האלה. אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: ‫"The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או ‫"Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה 25 תושק.
קבלת אישור ממספר משתמשים	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. הוספנו תמיכה בביקורות של אישורים ממספר משתמשים (MPA): נוספו המשאב MultiPartyAuthReview וMultiPartyAuthReviewService התואם. נוסף ה-enum‏ MultiPartyAuthReviewStatus כדי לעקוב אחרי סטטוס הביקורת. נוספה אפשרות CustomerUserAccess.pending_multi_party_auth_review לקישור לביקורת בהמתנה. נוספו MutateCustomerUserAccessResult.multi_party_auth_review ו-MutateCustomerUserAccessInvitationResult.multi_party_auth_review כדי להחזיר את שם משאב הביקורת המשויך. נוספה MultiPartyAuthReviewError לשגיאות אימות.

גרסה 22.1 (25.02.2026)

התכונה החדשה הבאה נוספה לגרסה v22.1 של Google Ads API. גרסאות משניות כמו v22.1 לא מכילות שינויים שעלולים לשבור את התאימות.

תכונות ועדכונים	סוג	תיאור
ניהול חשבון
Customer.contains_eu_political_advertising	שדה חדש	הפונקציה מאחזרת את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם החשבון מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזירה EuPoliticalAdvertisingStatus.
קמפיינים
Campaign.missing_eu_political_advertising_declaration	שדה חדש	אפשר להשתמש ב-API כדי לשלוח שאילתות ולסנן קמפיינים שחסרות בהם הצהרות לגבי פרסום פוליטי שמטורגט לאיחוד האירופי.

גרסה 22 (15.10.2025)

התכונות החדשות, העדכונים והשינויים שעלולים לשבור תאימות שנוספו בגרסה 22 של Google Ads API, שהיא גרסה ראשית.

הנחיות מפורטות זמינות במאמר בנושא שדרוג לגרסה העדכנית ביותר.

שינויים בתוכנה שעלולים לגרום לכשלים

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
יצירת ביקוש
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	שינוי שם / תיקון איות	משנים את השם של ההפניות לשם השדה המתוקן.
כללי
אין הגבלה על מספר הפעולות ב-AddBatchJobOperations	מגבלה של 10,000 פעולות לכל בקשה	שינוי באופן הפעולה	חשוב לוודא שאף בקשת AddBatchJobOperations לא מכילה יותר מ-10,000 פעולות.
גודל הדף הוגבל ל-1,000 ב-ListBatchJobResultsRequest	הפונקציה מחזירה שגיאה (INVALID_PAGE_SIZE)	שינוי באופן הפעולה	חשוב לוודא שהערך של ListBatchJobResultsRequest.page_size הוא 1,000 או פחות, כי בקשה לגודל דף גדול יותר תגרום לשגיאה.
מיקסום ביצועים
תוויות לציון רמת הביצועים של נכסים	ללא	הסרה	הוסר מהקמפיינים למיקסום הביצועים התמיכה בתוויות לציון רמת ביצועים של נכסים ובספירת התוויות המשויכת. מעדכנים את השילובים בהתאם.
Campaign.url_expansion_opt_out	FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION דגל בAssetAutomationSetting	הסרה / החלפה	שימוש בהגדרה של אוטומציה של נכסי טקסט של התאמת כתובת URL סופית. הוסר השדה לביטול ההסכמה להרחבת כתובות URL ברמת הקמפיין.
תכנון
views	trueview_views	הסרה / החלפה	מחליפים את ההפניות אל views בשדה trueview_views החדש ב-ReachPlanService.
סרטונים
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	שינוי שם	צריך לעדכן את מחרוזות השאילתה והשילובים כדי להשתמש בשמות החדשים של המדדים שמייצגים צפיות במודעות וידאו מסוג TrueView.

תכונות ועדכונים (לא משבשים)

תכונות ועדכונים	סוג	תיאור
נכסים
AssetFieldType.LANDING_PAGE_PREVIEW	ערך חדש של טיפוס בן מנייה (enum)	נוסף כסוג שדה חדש של נכס תמונה.
AssetGenerationService	שירות חדש (בטא)	מאפשר ליצור נכסי טקסט ותמונות באמצעות AI גנרטיבי: ‫GenerateText: יצירת טקסט על סמך כתובת ה-URL הסופית, הנחיות, מילות מפתח וכו'. ‫GenerateImages: יצירת תמונות על סמך כתובת URL סופית, הנחיות או שינוי ההקשר של תמונות מוצרים. השגיאות מוחזרות עם קודים מ-AssetGenerationError. בשלב הראשון, הגישה תהיה זמינה רק לקבוצה מוגבלת של משתתפים בגרסת בטא סגורה.
קמפיינים
AppCampaignBiddingStrategyGoalType	ערכי enum חדשים	נוספו יעדים חדשים לקמפיינים להתקנת אפליקציות (ACi) כדי לבצע אופטימיזציה בלי לציין יעד: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: לשימוש עם שיטת הבידינג הרגילה 'מקסימום המרות'. ‫OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: לשימוש עם השיטה הרגילה 'מקסימום ערך המרות'.
BiddingStrategyType	תכונה חדשה	הוספנו תמיכה בסוג שיטת הבידינג 'SOV קבוע'.
Campaign.feed_types	שדה חדש	סוגי הפידים שמצורפים לקמפיין. בקמפיינים למיקסום ביצועים, הערך הזה יכול לציין את הענף העסקי, למשל MERCHANT_CENTER_FEED לקמעונאות.
טירגוט של קבוצה משותפת	תכונה חדשה	אפשר לצרף קבוצות משותפות של מילות מפתח שליליות לקמפיינים מקומיים ולקמפיינים חוצי-ערוצים (לקמפיינים לקידום אפליקציות).
יצירת ביקוש
בידינג לפי יעד עלות לקליק	תכונה חדשה	נוספה שיטת בידינג להשגת מקסימום קליקים במסגרת יעד עלות לקליק: הגדרת יעד עלות לקליק ברמת הקמפיין באמצעות Campaign.target_cpc ושינוי ההגדרה ברמת קבוצת המודעות באמצעות AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	ערך חדש של טיפוס בן מנייה (enum)	אם האפשרות הזו מופעלת עבור DemandGenMultiAssetAdInfo, המערכת מוסיפה רכיבי עיצוב ומטמיעה נכסי טקסט בנכסי תמונות כדי ליצור נכסי תמונות חדשים עם יחסי גובה-רוחב שונים (האפשרות הזו מופעלת כברירת מחדל).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	ערך חדש של טיפוס בן מנייה (enum)	אם האפשרות מופעלת ב-DemandGenMultiAssetAdInfo, היא יוצרת סרטונים באמצעות נכסים אחרים כמו תמונות וטקסט, שאחר כך אפשר להשתמש בהם כדי ליצור מקרים חדשים של DemandGenVideoResponsiveAdInfo (האפשרות מופעלת כברירת מחדל).
כללי
ListBatchJobResultsRequest חזרה לגודל הדף	שינוי התנהגותי	אם הערך של page_size לא מוגדר או שהוא 0, ברירת המחדל היא 1,000 (בעבר הוחזר הערך INVALID_PAGE_SIZE).
QuotaError	ערך enum חדש / שגיאה	נוסף PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED כדי לציין מתי חורגים ממגבלת קצב ההפעלה של פרופיל התשלומים.
מיקסום ביצועים
הגדרות אוטומציה של נכסים	ערכי enum חדשים	נוספו אפשרויות חדשות לאוטומציה של נכסים בקמפיינים למיקסום הביצועים: ‫GENERATE_IMAGE_ENHANCEMENT: הפעלה של יצירה אוטומטית של תמונות משופרות (חיתוך אוטומטי). ההגדרה הזו מופעלת כברירת מחדל. ‫GENERATE_IMAGE_EXTRACTION: התמונות נלקחות מכתובות URL סופיות. ברירת המחדל היא ההגדרה של תוסף התמונות הדינמיות בחשבון.
פילוחים בדוחות של קמפיינים למיקסום הביצועים	פלחים חדשים	הוספנו פלחים חדשים שייחודיים לקמפיינים למיקסום הביצועים: ‫ad_using_product_data: מציין אם במודעה נעשה שימוש בנתוני מוצרים מ-Google Merchant Center. ‫ad_using_video: מציין אם במודעה נעשה שימוש בנכס וידאו.
תכנון
רשימות נתונים של שותפי CRM	תכונה חדשה / ערך enum	נוסף THIRD_PARTY_PARTNER_DATA למקורות נתוני CRM, יחד עם קודי שגיאה של אימות קהלים של שותפים (למשל, קודי שגיאה שקשורים לאישור תנאים והגבלות, לקישור חסר וכו').
מדדים של יוצרים בשידור חי	שדה חדש	נוסף YouTubeMetrics.is_active_live_stream_creator, שמוחזר על ידי תובנות לגבי יוצרים כדי לציין אם יוצר פרסם שידור חי ב-90 הימים האחרונים.
מטא-נתונים של מקור CRM שאפשר לתכנן	הודעה חדשה	הוספנו את PlannableUserListMetadata בתוך PlannableUserList, שמוחזר על ידי ReachPlanService.ListPlannableUserLists, כדי להציג סוגים של מקורות נתונים של CRM.
תמיכה בסרטונים קשורים וביוצרים ב-TrendInsight	שדות חדשים	הוספנו תמיכה ב-related_videos וב-related_creators ב-TrendInsight, ובמאפייני צפייה ב-video_properties וב-publish_date.
שיפורים ב-InsightsFinder	תכונה חדשה	‫GenerateInsightsFinderReport תומך עכשיו ב-parental_status, ב-income_ranges ובשילובים מורכבים יותר של טירגוט באמצעות AND/OR.
דוחות
סוגי קליקים חדשים	ערכי enum חדשים	הוספת את CLICK_TO_MESSAGE_THIRD_PARTY_CLICK ואת CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
פילוח של נכסים בקבוצת נכסים	תמיכה בפלחים חדשים	אפשר עכשיו לפלח את AssetGroupAsset לפי device,‏ conversion_action,‏ conversion_action_name ו-conversion_action_category.
מודעות RSA בתצוגה AdGroupAdAssetView	תמיכה בתכונות או במדדים חדשים	AdGroupAdAssetView תומך עכשיו באופן מלא במדדי ביצועים והמרות עבור RESPONSIVE_SEARCH_AD (קודם לכן הוחזרו רק חשיפות).
פילוחים של מדדים של אשכולות שאילתות בניתוח	תמיכה בפלחים חדשים	אפשר עכשיו לפלח את המדדים clicks_unique_query_clusters,‏ conversions_unique_query_clusters ו-impressions_unique_query_clusters לפי שדות תאריך.
TargetingExpansionView	משאב דיווח חדש	הוספנו את TargetingExpansionView למדדי הדוחות כדי לכלול הרחבות של טירגוט ידני, כמו הרחבה של התאמה ללא מילות מפתח ב-AI למיקסום ביצועים של קמפיינים לרשת החיפוש.
קניות
תיקון היקף הגישה לשופינג	תיקון באגים	תוקן היקף המדדים ברמת הקמפיין וברמת קבוצת המודעות במשאב ShoppingProduct.
יעדים מאוחדים
יעדים של שימור	תכונה חדשה	הוספנו תמיכה ביעדים של שימור לקוחות כדי לבצע אופטימיזציה לעידוד לקוחות קיימים לחדש את האינטראקציה עם העסק (למשל, באמצעות target_option עם TARGET_SPECIFIC או TARGET_ALL).
סרטונים
מדדים של זמן צפייה בסרטונים	שדות חדשים	הוספנו מדדים של משך זמן הצפייה: video_watch_time_duration_millis (משך כולל) ו-average_video_watch_time_duration_millis (משך ממוצע לחשיפה).

נתוני גרסה בארכיון

הערות גרסה של גרסאות שיצאו משימוש