נתוני גרסה

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

גרסאות ראשיות ומשניות של 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 שדה חדש הוספנו תמיכה בפרטי מודעות 'Google בעלי מקצוע' (מזהה קטגוריה ויתרונות מרכזיים) בקמפיינים למיקסום הביצועים.
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 חדש / שגיאה הערך הזה מוחזר כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של קמפיין לקידום עסקים מקומיים.
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_input (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_input (הצהרות שזוהו אוטומטית או שסופקו על ידי המערכת).

התכונה הזו הועברה לאחור (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):
התכונה הזו הועברה לגרסאות קודמות: 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 שינוי התנהגותי / שינוי סוג צריך לעדכן את השילובים של ספריות לקוח עם הקלדה כדי להשתמש במרחבי השמות החדשים של המשאבים.
השדה 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.
המרות
סוגי המרות של לידים ערכי 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 משאב דיווח חדש הדוחות מציגים פילוח של מדדי ההמרות לפי המוצר הספציפי שנמכר (מותג וכו') בנוסף למוצר שהלקוח לחץ עליו.
מדדים שלא ניתן להגיש עליהם הצעות מחיר שדות חדשים הוספנו מדדים שלא ניתן להגיש עליהם הצעות מחיר (מדדים שמציגים המרות שהקמפיינים לא עוברים אופטימיזציה כדי להשיג אותן) לכל הנכסים התואמים:
conversion_attribution_event_type פלח חדש נוסף אל ShoppingPerformanceView.
קניות
קמפיינים לקידום אפליקציות בShoppingProduct תכונה חדשה קמפיינים נתמכים לקידום אפליקציות במשאב ShoppingProduct. אין תמיכה בסטטוס של הערות ובבעיות.
סינון מוצרים לפי תגים תכונה חדשה הוספנו סינון באמצעות ביטויים לוגיים של קבוצות באופן דינמי: התכונה הזו זמינה רק בחשבונות שברשימת ההיתרים.

גרסאות ראשיות ומשניות של 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. מומלץ להשתמש בממשק עכשיו כדי לבנות ולבדוק את הלוגיקה הפנימית, כדי שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק.
קבלת אישור ממספר משתמשים תכונות חדשות הוספנו תמיכה בבדיקות של קבלת אישור ממספר משתמשים (MPA):

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

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

תכונות ועדכונים סוג תיאור
מודעות
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 תכונות חדשות / תמיכה נכסים מעודכנים של שליחת הודעות לעסק:
חיוב
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):

כדי לאפשר טיפול מפורט יותר בכשלים באמצעות תוכנות, נוסיף קודי שגיאה נוספים ל-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 (לקמפיינים למיקסום הביצועים עם AI) כדי לספק מדדי ביצועים לפי מיקומים גיאוגרפיים שהמשתמשים התעניינו בהם.
קניות
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. מומלץ להשתמש בממשק עכשיו כדי לבנות ולבדוק את הלוגיקה הפנימית, כדי שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק.
קבלת אישור ממספר משתמשים תכונות חדשות הוספנו תמיכה בבדיקות של קבלת אישור ממספר משתמשים (MPA):

גרסה 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 (משך ממוצע לחשיפה).

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

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

גרסה 21.2‏ (24.06.2026)

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

תכונות ועדכונים סוג תיאור
כללי
קבלת אישור ממספר משתמשים תכונות חדשות הוספנו תמיכה בבדיקות של קבלת אישור ממספר משתמשים (MPA):

גרסה 21.1‏ (25.02.2026)

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

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

גרסה 21 ‏ (06.08.2025)

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

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

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

מצב התחלתי המצב החדש סוג השינוי הדרכה בנושא הטמעה
קמפיינים
הפונקציה מחזירה את הערך CriterionError.INVALID_LISTING_GROUP_HIERARCHY הפונקציה מחזירה את הערך CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION שינוי קוד השגיאה בבקשות שבהן מופעלת אפשרות של כשל חלקי, צריך לטפל בקוד השגיאה החדש במקום בקוד השגיאה המקורי של ההיררכיה.
המרות
גישה למצב debug_enabled ב-ConversionUploadService ללא הסרה השדה debug_enabled יוסר. מעדכנים את הקוד שמתייחס אליו כך שהפרמטר הזה לא יוגדר או יישלח בשאילתה.
שינויים בפרסום שקשור לפוליטיקה באיחוד האירופי
הצהרות עצמיות אופציונליות לגבי פרסום שקשור לפוליטיקה באיחוד האירופי שדה חובה contains_eu_political_advertising לקמפיינים חדשים כלל אימות / שינוי התנהגותי אם השדה הזה לא מוגדר, קריאות ל-API ליצירת קמפיינים חדשים ייכשלו עם שגיאה FieldError.REQUIRED. החל מ-22 בספטמבר 2025, קמפיינים שהוגדרו כCONTAINS_EU_POLITICAL_ADVERTISING לא יוצגו יותר באיחוד האירופי.
קריטריונים שניתנים לשינוי בלי הצהרה עצמית עדכונים נכשלים עם CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION כלל אימות / שינוי התנהגותי צריך להגדיר את סטטוס ההצהרה העצמית לפני שמנסים ליצור או לעדכן קריטריונים של טירגוט לפי קרבה, מיקום או קבוצה לפי מיקום ברמת הקמפיין או ברמת קבוצת המודעות בקמפיינים קיימים.
ניסויים ללא דרישות להצהרה עצמית עדכונים נכשלים עם ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION כלל אימות / שינוי התנהגותי חשוב לוודא שהושלמו הצהרות עצמיות בקמפיינים של הניסוי.
מיקסום ביצועים
ברירת המחדל של brand_guidelines_enabled היא false ברירת המחדל היא true שינוי התנהגותי בקמפיינים חדשים למיקסום ביצועים, הנחיות המיתוג מופעלות כברירת מחדל. אם רוצים להשבית אותם, צריך להגדיר את השדה לערך false.
תכנון
סוג הארגומנט המקורי של הקלט עבור AudienceInsightsService.GenerateTargetingSuggestionMetrics קלט מסוג InsightsAudience שינוי סוג צריך לעדכן את ההטמעות כדי להעביר את סוג הקלט החדש שתומך בשילוב של תנאי AND עם תנאי OR של תחומי עניין של משתמשים, וכך לאפשר מדדים פוטנציאליים של היקף החשיפה להגדרות של קהלים מותאמים אישית.

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

תכונות ועדכונים סוג תיאור
‫AI למיקסום הביצועים של הקמפיינים לרשת החיפוש
‫ai_max_setting.enable_ai_max ב-Campaign שדה חדש הפעלת AI למיקסום ביצועים מאפשרת להרחיב את ההתאמה למונחי חיפוש (תוך התחשבות באוטומציה הקודמת של נכסי טקסט וברשימות המותגים עד להשבתה). השדה Campaign.ai_max_setting.bundling_required מציין אם צריך להפעיל את AI למיקסום ביצועים כדי לכבד את ההגדרות האלה או לשנות אותן, והשדה AdGroup.ai_max_ad_group_setting.disable_search_term_matching יכול להשבית את ההתאמה ברמת קבוצת המודעות. מידע נוסף על שיפור הביצועים בעזרת AI למיקסום ביצועים של קמפיינים לרשת החיפוש
CampaignError.AI_MAX_MUST_BE_ENABLED ערך enum חדש / שגיאה השגיאה הזו מתרחשת כשמפעילים אוטומציה של נכסי טקסט של התאמת כתובות URL בקמפיינים לרשת החיפוש בלי להפעיל AI למיקסום ביצועים.
טירגוט ברמת קבוצת המודעות תכונה חדשה הוספנו תמיכה ב-AI למיקסום ביצועים של קמפיינים לרשת החיפוש ברשימות של מותגים, במיקומים ובדפי אינטרנט (כללי כתובות URL) ברמת קבוצת המודעות.
ai_max_search_term_ad_combination_view משאב דיווח חדש הדוח מציג את הביצועים של שילובים בין מונחי חיפוש, כותרות ודפי נחיתה.
פלח אחד (search_term_match_type) ערך חדש של טיפוס בן מנייה (enum) נוספה האפשרות AI_MAX כסוג התאמה למונח חיפוש.
נכסים
PromotionAsset שדות חדשים הוספנו את האפשרויות terms_and_conditions_text, terms_and_conditions_uri ו-oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info). מידע נוסף על נכסי קידום מכירות
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION ערך חדש של טיפוס בן מנייה (enum) נוספה אל AssetAutomationType כדי לשלוט ביצירה אוטומטית של טקסטים ודפי נחיתה מכתובות URL סופיות בקמפיינים לרשת החיפוש.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset שירות או שיטה חדשים מאפשר להסיר נכסים של התאמת כתובת URL סופית שנוצרו באופן אוטומטי מקמפיינים.
ServedAssetFieldType.DESCRIPTION_PREFIX ערך חדש של טיפוס בן מנייה (enum) הוספנו את התיקון הזה כדי לפתור בעיה בדיווח שבה הסוג הוחזר כ-UNKNOWN ב-ad_group_ad_asset_combination_view.
קמפיינים
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING ערך חדש של טיפוס בן מנייה (enum) הערך הזה מוחזר כשבקמפיינים עם הגבלות על מיקומים אין טירגוט לפי מיקום (שמעכשיו מחזיר את השגיאה LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN אם הטירגוט הוא מחוץ לאזור המותר).
שילוב של ניתוח של נתוני אפליקציות של צד שלישי שדות חדשים הוספנו תמיכה ב-VideoCustomer.third_party_integration_partners וב-Campaign.third_party_integration_partners. מעקב אחרי המרות באפליקציה דרך ניתוח של נתוני אפליקציות של צד שלישי
Campaign.advertising_partner_ids תמיכה בשדות חדשים אפשר להגדיר את השדה הזה לקמפיינים קיימים (הוא לא ניתן לשינוי אחרי ההגדרה).
מיקומים שליליים ברמת חשבון הניהול תכונה חדשה אפשר להשתמש ב-CustomerNegativeCriterion כדי להחריג רשימות של מיקומי מודעות בחשבונות מפרסמים נפרדים.
הגדרות של טולרנטיות בשיטות בידינג לפי יעד החזר על הוצאות פרסום (ROAS) שדות חדשים הוספנו תמיכה בTargetRoas.target_roas_tolerance_percent_millis (לשיטות בידינג כוללות בקמפיינים לרשת החיפוש) ב-MaximizeConversionValue וב-TargetRoas.
LocationInterestView משאב דיווח חדש סיכום של הביצועים של קריטריונים של מיקומים שיכולים לעניין את המשתמשים ברמת קבוצת המודעות.
המרות
פלח אחד (conversion_attribution_event_type) ערך חדש של טיפוס בן מנייה (enum) הוספנו את ENGAGED_VIEW לאפשרויות של סוג הייחוס להמרות.
יצירת ביקוש
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM ערך enum חדש / שגיאה הוספנו את ההודעה הזו לקראת אכיפה של תקציבים יומיים מינימליים לקמפיינים ליצירת ביקוש. הפרטים נחשפים באמצעות budgetDailyMinimumErrorDetails.
מיקסום ביצועים
campaign_search_term_view משאב דיווח חדש מצטברות בו מדדים של מונחי חיפוש ברמת הקמפיין, וכך מתאפשרת ניתוח של מונחי חיפוש ודיווח עליהם בקמפיינים למיקסום הביצועים.
תכנון
ReachPlanService.ListPlannableUserInterests שיטה חדשה אפשר לגלות תחומי עניין משותפים ופלחים עם כוונת רכישה שאפשר לתכנן עבורם ב-generateReachForecast.
AdditionalApplicationInfo שדה חדש נוסף כקלט אופציונלי ב-ReachPlanService.ListPlannableUserLists.
רשימת מאפיינים של תובנות לגבי קהלים תכונה חדשה ‫AudienceInsightsService.ListAudienceInsightsAttributes מאחזר עכשיו רשימות משתמשים של צד ראשון שזמינות.
טירגוט רשימות CRM באמצעות התובנות לגבי הרכב הקהל תכונה חדשה הפונקציה AudienceInsightsService.GenerateAudienceCompositionInsights מחזירה עכשיו פרטים על אינדקס רשימת המשתמשים למאפיינים AudienceInsightsDimension: ‏ AGE_RANGE,‏ GENDER,‏ AFFINITY_USER_INTEREST ו-IN_MARKET_USER_INTEREST.
TrendInsightMetrics נתח הקהל שדה חדש המונח מתייחס לחלק של קהל מסוים בטרנד.
קטגוריות KnowledgeGraphAttributeMetadata שדות חדשים מסננים מאפיינים של Knowledge Graph לפי קטגוריות תואמות.
דוחות
מדדי צפיות בנכס תכונות או מדדים חדשים הוספנו כמה מדדים חדשים ל-AssetGroupAsset,‏ ChannelAggregateAssetView ו-CampaignAggregateAssetView. בנוסף, בדוחות של קמפיינים למיקסום ביצועים מוצגים עכשיו ערכים אמיתיים של impressions.
תוספים לבחירת רכיבים תכונה חדשה אפשר להריץ שאילתות על AssetSet ועל CampaignAssetSet ביחד בתוך ChangeStatus.
search_term_targeting_status פלח חדש פלח שאפשר לבחור בתצוגת מונחי החיפוש של הקמפיין.
final_url_expansion_asset_view משאב דיווח חדש הדוח כולל פרטים על ביצועי הנכסים עם התאמת כתובת URL סופית.
שינוי ערכים של קבוצת נכסים שדות חדשים הוספנו תמיכה במדדים value_adjustment ו-all_value_adjustment בדוח AssetGroup.
landing_page_source פלח חדש הפונקציה מחזירה פלח של מקור דף נחיתה בפורמט landing_page_view.
search_term_match_source פלח חדש פלח שאפשר לבחור בתצוגות של מונחי חיפוש ושל מונחי חיפוש בקמפיין.
match_type פלח חדש מפתח פלח שאפשר לבחור בו בתצוגת מילות המפתח.
דיווח על אשכולות של כוונות שאילתה ייחודיות שדות חדשים נוספו clicks_unique_query_clusters,‏ conversions_unique_query_clusters ו-impressions_unique_query_clusters כדי לדווח על אשכולות ייחודיים של כוונת שאילתה.
ClickType.VEHICLE_ASSETS ערך חדש של טיפוס בן מנייה (enum) אפשר לעקוב אחרי קליקים שקשורים ספציפית לפורמטים של מודעות למכירת רכבים ולדווח עליהם בדוח click_view.
שיטות בידינג חכמות לאיתור מקורות תנועה
הגדרות סבילות בשיטות בידינג לרשת החיפוש שדות או הגדרות חדשים ההגדרה הזו מאפשרת להפעיל את התכונה 'איתור חכם של מקורות תנועה' בקמפיינים לרשת החיפוש על ידי הגדרת הערך target_roas_tolerance_percent_millis בין 10,000 (10%) ל-30,000 (30%) כולל (ההגדרה target_roas נדרשת לשיטת הבידינג 'מקסימום המרות'). מידע נוסף זמין בפוסט בבלוג בנושא איתור חכם של מקורות תנועה ובמאמר במרכז העזרה.
תאימות לדיווח על מגוון תרבותי תכונה חדשה עכשיו יש תמיכה בדיווח על גיוון במדדים הבאים של אשכולות ייחודיים של כוונות שאילתה. תצוגה מפולחת לפי זמן זמינה בממשק המשתמש של Google Ads:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
סרטונים
YouTubeVideoListAsset משאב או שדה חדשים מאפשר ליצור קישורים בין קמפיינים לבין נכסי רשימות סרטונים באמצעות Asset.youtube_video_list_asset. איך משתמשים בסרטונים קשורים
תוספים של מטא-נתונים של תובנות שדות חדשים נוספו מטא-נתונים חדשים ל-YouTubeChannelInsights ול-YouTubeVideoAttributeMetadata.
סוגי קליקים אינטראקטיביים ערכי enum חדשים נוספו סוגי קליקים: VIDEO_RELATED_VIDEOS_CLICK,‏ VIDEO_CHANNEL_CLICK ו-PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream שדה חדש האפשרות הזו מאפשרת להציג מודעות וידאו רספונסיביות כמודעות וידאו In-stream שלא ניתן לדלג עליהן בקמפיינים שמשלבים פורמטים של מודעות שאפשר לדלג עליהן ופורמטים של מודעות שלא ניתן לדלג עליהן.
הגדרות של סדרת מודעות וידאו שדות חדשים נוספו הגדרות רצף לקריאה בלבד: Campaign.VideoCampaignSettings.video_ad_sequence ו-VideoAdSequenceStepSetting. מידע על סדרת מודעות וידאו
טירגוט של חבילת ערוצי וידאו סוג קריטריון או שדה חדש הוספנו את סוג הקריטריון VIDEO_LINEUP ואת השדה המתאים ב-CampaignCriterion וב-AdGroupCriterion. התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים.
צפיות במיקומים לפי התאמה להצגת תוכן כלים חדשים לדיווח הוספנו דוח על התאמה להצגת תוכן ברמת הפרטים (detail_content_suitability_placement_view) וברמת הקבוצה (group_content_suitability_placement_view). מידע נוסף על הדוח 'התאמה לתוכן'

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

הערות הגרסה ששמורים בארכיון