נתוני גרסה

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

גרסה ראשית v26

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

גרסה 26‏ (14.10.2026)

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

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

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

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
קמפיינים
שדה country_code אופציונלי ב-LocalServicesPmaxCampaignSettings	שדה חובה במהלך יצירת קמפיין למיקסום הביצועים של "Google בעלי מקצוע" (LocalServicesPmaxCampaignSettings.country_code)	שינוי באופן הפעולה	כשיוצרים קמפיינים למיקסום הביצועים של מודעות "Google בעלי מקצוע", חשוב לציין את country_code (יחד עם listing_id שנדרש עכשיו).
המרות
השדה enhanced_conversions_for_leads_enabled ב-ConversionTrackingSetting (Customer.conversion_tracking_setting)	ללא	הסרה	במקום זאת, צריך להשתמש ב-ConversionTrackingSetting.enablement_setting ב-Customer.conversion_tracking_setting כדי לבדוק את ההגדרה של ההמרות המשופרות ברמת החשבון.
טירגוט
שדות קריטריונים ספציפיים למלונות ב-AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights ו-max_nights) hotel_check_in_day hotel_check_in_date_range	שדות קריטריונים שלא תלויים בענף ב-AdGroupBidModifier: user_set_dates מסוג UserSetDatesInfo ‫advance_booking_window מסוג AdvanceBookingWindowInfo length_of_booking מסוג LengthOfBookingInfo (min_days ו-max_days) start_day_of_week מסוג StartDayOfWeekInfo ‫start_date_range מסוג StartDateRangeInfo	שינוי שם או הסרה	מעדכנים את ההפניות כך שישתמשו בשדות הקריטריונים שלא קשורים לתחום מסוים, שתומכים בטירגוט בתחומי נסיעות שונים מעבר למלונות (כמו דברים שאפשר לעשות). מזהי הקריטריונים, התנהגות הטירגוט והתאמות קיימות של הצעות המחיר נשארים ללא שינוי. הערכים של min_nights ו-max_nights מועברים אל min_days ו-max_days כמו שהם.
HotelDateSelectionType וסוג של segments.user_set_dates	DateSelectionType	שינוי שם / שינוי סוג	במקום זאת, צריך להשתמש ב-DateSelectionType.HotelDateSelectionType
סיבות לשגיאות ספציפיות למלון ב-CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	סיבות לשגיאות שלא קשורות לתחום מסוים ב-CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	שינוי שם	מעדכנים את הטיפול בשגיאות כדי לבדוק את הסיבות החדשות לשגיאות שלא קשורות לתחום ספציפי.

תכונות ועדכונים (לא קריטיים)

תכונות ועדכונים	סוג	תיאור
נכסים
ספקי הודעות לעסק ב-LINE וב-SMS	שדות חדשים וערכי enum	נוספה תמיכה ב-LINE וב-SMS כספקי הודעות ב-BusinessMessageAsset, כולל השדות החדשים BusinessMessageAsset.line_info ו-BusinessMessageAsset.sms_info, לצד BusinessMessageProvider.LINE ו-BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	ערך enum חדש / שגיאה	הוספנו לAssetGroupError כדי לציין מתי קטגוריה שצוינה בGoogleLocalServicesInfo (AssetGroup.google_local_services_info) לא נתמכת בקמפיינים למיקסום הביצועים של מודעות לשירותים מקומיים.
קמפיינים
יצירת קמפיין למיקסום הביצועים של 'Google בעלי מקצוע'	תכונות, שדות ושגיאות חדשים	בוצע עדכון של PmaxCampaignSettings.local_services_enabled מ-OUTPUT_ONLY ל-IMMUTABLE, כך שלקוחות חיצוניים של API יכולים לציין local_services_enabled = true כשיוצרים קמפיינים חדשים למיקסום הביצועים לקידום עסקים מקומיים. בנוסף, הוספנו את LocalServicesPmaxCampaignSettings.listing_id כדי לחשוף את מזהה כרטיס העסק ב-Google שמקושר לקמפיין למיקסום הביצועים של 'בעלי מקצוע מומלצים על ידי Google' (מסומן כחובה במהלך יצירת הקמפיין למיקסום הביצועים של 'בעלי מקצוע מומלצים על ידי Google'), והוספנו את קוד השגיאה CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
שגיאות אימות בקמפיינים של "Google בעלי מקצוע"	ערכי enum חדשים ושגיאות חדשות	הוספנו שגיאות אימות חדשות בקמפיינים של "Google בעלי מקצוע": ‫CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED ‫AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID ‫CampaignConversionGoalError וגם CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ‫ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
אימות הקישור לחשבון Hotel Center	ערך enum חדש / שגיאה	הוספנו את קוד השגיאה CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED ל-CampaignError כדי לציין שכדי לקשר קבוצת נכסים של מלונות (Campaign.hotel_property_asset_set) לקמפיין למיקסום הביצועים לענף התיירות והאירוח, צריך קישור פעיל לחשבון Hotel Center.
התקציב המינימלי ליום בקמפיינים ליצירת ביקוש	שדה חדש	הוספנו את השדה demand_gen_info.minimum_budget_per_day_micros אל CurrencyConstant, שבו מצוין התקציב המינימלי הנדרש ליום עבור קמפיינים ליצירת ביקוש במטבע הזה. הערך של השדה הזה מתעדכן כשהתקציב המינימלי שנאכף על ידי ה-API משתנה.
הגדרת מדידת השיפור בקמפיינים	שדה חדש	נוסף Campaign.lift_measurement_config כדי לחשוף את שם המשאב של הגדרת מדידת העלייה שקשורה לקמפיין.
אימות של ניסוי בקמפיין AI למיקסום ביצועים	ערך enum חדש / שגיאה	הוספנו את קוד השגיאה ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED ל-ExperimentArmError כשמנסים ליצור ניסוי ADOPT_AI_MAX בקמפיין שכבר מופעלת בו חבילת התכונות "AI למיקסום הביצועים" (או שהיא מופעלת באותה בקשה לפני שנוצרת קבוצת הניסוי).
סוג כרטיס המוצר בקמפיין שופינג	תמיכה מורחבת	הרחבנו את התמיכה ב-Campaign.listing_type לקמפיינים של שופינג.
עדכונים בנושא הצהרה עצמית לגבי פרסום שקשור לפוליטיקה באיחוד האירופי	התנהגות מעודכנת ושדות חדשים	התכונה Campaign.contains_eu_political_advertising היא עכשיו אופציונלית בחלק מהקמפיינים שלא מטרגטים באופן חיובי את האיחוד האירופי. למעט בקמפיינים מסוג DEMAND_GEN עם טירגוט משודרג, השדה הוא אופציונלי אם הקמפיין עומד בכל התנאים הבאים אחרי שהבקשה מבוצעת: אין בקמפיין קריטריון חיובי של מיקום גיאוגרפי שנמצא בתוך האיחוד האירופי לא מכיל קריטריון קמפיין חיובי של קרבה או קבוצות לפי מיקום מכיל לפחות קריטריון אחד של קמפיין למיקום חיובי שנמצא מחוץ לאיחוד האירופי בקמפיינים מסוג DEMAND_GEN עם upgraded_targeting, השדה הוא אופציונלי אם כל קבוצת מודעות פעילה בקמפיין עומדת בכל התנאים הבאים אחרי ביצוע הבקשה: לא מכיל קריטריון חיובי של קבוצת מודעות לטירגוט לפי מיקום שנמצא בתוך האיחוד האירופי לא מכיל קריטריון חיובי של קבוצת מודעות לפי קרבה או מיקום מכיל לפחות קריטריון אחד של קבוצת מודעות למיקום חיובי שנמצא מחוץ לאיחוד האירופי השדה הוא גם אופציונלי לקמפיינים שאין בהם קבוצות פעילות של מודעות. אם בקשה יוצרת קבוצת מודעות שלא עומדת בתנאים האלה, מוחזרת השגיאה AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION. השינויים האלה חלים גם על קמפיינים חדשים וגם על קמפיינים קיימים. במקרים מסוימים, אפשר ליצור קמפיין חדש רק אם מוסיפים קריטריונים באותה בקשה – משתמשים ב-GoogleAdsService.Mutate כדי לקבץ שינויים. העדכון של Campaign.missing_eu_political_advertising_declaration בוצע בהתאם לשינויים ב-Campaign.contains_eu_political_advertising. נוסף GeoTargetConstant.require_eu_political_advertising_declaration כדי לציין אם מיקום נמצא בתוך האיחוד האירופי או מחוצה לו. בוצעה הוספה של CampaignCriterion.require_eu_political_advertising_declaration ושל AdGroupCriterion.require_eu_political_advertising_declaration. צריך להזין Campaign.contains_eu_political_advertising אם השדה הזה הוא true בכל קריטריון ברמת הקמפיין (או בכל קריטריון פעיל ברמת קבוצת המודעות בקמפיינים מסוג DEMAND_GEN עם טירגוט משודרג). השדות מחזירים את הערך true אם השדה negative של הקריטריון הוא false והקריטריון הוא מיקום בתוך האיחוד האירופי, קרבה (גם אם היא חופפת לטריטוריה של האיחוד האירופי) או קבוצה לפי מיקום (גם אם היא חופפת לטריטוריה של האיחוד האירופי).
המרות
הגדרה מאוחדת של המרות משופרות	שדות חדשים וטיפוסים בני מנייה (enum)	הוספנו את ConversionTrackingSetting.enablement_setting ואת ConversionTrackingSetting.effective_enablement_setting (ב-Customer.conversion_tracking_setting) כדי לחשוף את ההגדרה המאוחדת של המרות משופרות בחשבון, שמיוצגת באמצעות ה-enum החדש EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD	ערך enum חדש	נוסף ל-ConversionActionCategory כדי לתמוך באינטראקציות של הודעות או צ'אט שמצביעות על התעניינות במוצרים או בשירותים של המפרסם.
ConversionAttributionEventType.CLICK	ערך enum חדש	נוסף ל-ConversionAttributionEventType כדי לייצג המרות שמשויכות לקליק על מודעה, שנכללו קודם בערך ה-enum‏ UNKNOWN.
כללי
עדכונים על לידים מ-"Google בעלי מקצוע"	שדה חדש וערך enum	הוספנו את השדה LocalServicesLead.campaign למשאב LocalServicesLead כדי לקשר ליד לקמפיין שמשויך אליו. הוספנו את COUPON אל LocalServicesLeadType כדי לתמוך בסוגי לידים של שוברים ב-"Google בעלי מקצוע".
המלצות
המלצה להגדלת התקציב בקמפיינים לרשת החיפוש	המלצה חדשה	הוספנו את RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW,‏ Recommendation.raise_budget_performance_too_low_recommendation ו-ApplyRecommendationOperation.raise_budget_performance_too_low כדי לתמוך בהגדלת התקציבים כשהתקציבים היומיים נמוכים מדי לקמפיינים לרשת החיפוש.
דוחות
מדידות של עלייה בנפח החיפוש	תכונות חדשות, מקורות מידע, פלחים ומדדים	הוספנו תמיכה במדידת העלייה בנפח החיפוש: נוסף משאב חדש לקריאה בלבד SearchLiftKeywordBundle שמייצג חבילת מילות מפתח במחקר למדידת העלייה בנפח החיפוש. הוספנו פלחים חדשים שאפשר לבחור (segments.search_lift_keyword_bundle ו-segments.search_property) ו-15 מדדים חדשים של עלייה בנפח החיפוש (כמו relative_search_lift,‏ normalized_incremental_searches,‏ search_lift_cost_micros ו-search_lift_impressions) כדי לתמוך בניתוח של העלייה בנפח החיפוש באמצעות LiftMeasurementConfig (שמקושר לקמפיינים שמשתמשים ב-Campaign.lift_measurement_config). הוספנו את הערכים המוגדרים מראש SearchLiftKeywordBundleStatus,‏ SearchLiftMatchingInfoSource ו-SearchLiftSearchProperty.
תצוגת נכסים של התאמת כתובת URL סופית בקמפיינים של שופינג	תמיכה מורחבת	הרחבנו את final_url_expansion_asset_view כדי לתמוך בקמפיינים של שופינג (אפשר לבחור את ad_group כמשאב משויך לצד final_url_expansion_asset_view.ad_group).
סרטונים
גילוי נאות לגבי תוכן גנרטיבי ב-YouTube	שדות חדשים וערכי enum	הוספנו תמיכה בגילוי נאות לגבי תוכן גנרטיבי בהעלאות ל-YouTube. השדה החדש YouTubeVideoUpload.video_content_metadata מסוג VideoContentMetadata נוסף אל YouTubeVideoUpload, והוא מכיל הגדרות גילוי נאות בקטע VideoContentMetadata.generative_content_disclosure מסוג YouTubeVideoUploadGenerativeContentDisclosure.

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

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

גרסה 25.2 ‏ (23.09.2026)

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

תכונות ועדכונים	סוג	תיאור
נכסים
אפשרויות של כתובות URL עבור AssetGroup	שדות חדשים	הוספנו תמיכה באפשרויות של כתובות URL ב-AssetGroup, שמאפשרות למפרסמים לציין תבניות מעקב, פרמטרים מותאמים אישית וסיומות של כתובות URL סופיות ברמת קבוצת הנכסים: ‫AssetGroup.tracking_url_template: תבנית של כתובת URL ליצירת כתובת URL למעקב. ‫AssetGroup.url_custom_parameters: רשימה של מיפויים שמשמשים להחלפת תגים של פרמטרים מותאמים אישית של כתובות URL ב-tracking_url_template, ב-final_urls או ב-final_mobile_urls. ‫AssetGroup.final_url_suffix: תבנית של כתובת URL להוספת פרמטרים לכתובות דפי הנחיתה שמוצגים עם מעקב מקביל.
קמפיינים
מידע על סריקה אוטומטית של סרטונים	שדות חדשים וסוגי ספירה חדשים	הוספנו את AutomatedVideoCrawlSetting אל Campaign.AssetAutomationSetting, יחד עם AssetAutomationType.AUTOMATED_VIDEO_CRAWL, כדי לאפשר לכם לציין את הגדרות הסריקה האוטומטית של סרטונים בקמפיין למיקסום הביצועים. ‫AutomatedVideoCrawlSetting.automated_video_crawl_infos מכיל רשימה של רשומות AutomatedVideoCrawlInfo, שכל אחת מהן מגדירה סריקה של url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL או YOUTUBE) וסטטוס הצטרפות של enabled.
שגיאות במכפיל הערך של אופטימיזציית מחזור החיים של הלקוח	ערכי enum חדשים ושגיאות חדשות	הוספנו סיבות חדשות לשגיאות אימות כשמגדירים מכפילי ערך (value_multiplier ו-high_lifetime_value_multiplier) לאופטימיזציה של מחזור החיים של הלקוח: ‫GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER ‫CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	תכונה חדשה	הוספנו את SmartCampaignSettingService.GeneratePMaxDraftCampaign כדי לתמוך ביצירת טיוטת קמפיין למיקסום הביצועים מקמפיין חכם קיים, שמאותחל עם הסטטוס CampaignStatus.PAUSED וסטטוס היצירה CampaignCreationStatus.INCOMPLETE (מידע נוסף זמין במאמר המרת קמפיינים חכמים לקמפיינים למיקסום הביצועים): מגדירים את GeneratePMaxDraftCampaignRequest.validate_only לערך true כדי לאמת את ההמרה ולקבל אזהרות אימות או בעיות בהמרה ב-GeneratePMaxDraftCampaignResponse.validated_info בלי ליצור את קמפיין הטיוטה. (צריך להשאיר את gbp_enabled ואת image_enabled ללא הגדרה או להגדיר אותם כ-false. הגדרה שלהם כ-true עדיין לא נתמכת ומחזירה את הערך SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED או SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.) הפונקציה GeneratePMaxDraftCampaignResponse מחזירה את שמות המשאבים של הישויות שנוצרו (pmax_campaign,‏ campaign_budget,‏ asset_group ו-assets) יחד עם validated_info.
המרות
חשיפות של מודעות ב-Firebase	סוגים וקטגוריות חדשים של פעולות המרה	חשפנו את סוגי פעולות ההמרה FIREBASE_ANDROID_APP_AD_IMPRESSION ו-FIREBASE_IOS_APP_AD_IMPRESSION, כדי שתוכלו לאחזר ולשנות את פעולות ההמרה האלה. בנוסף, חשפנו את הקטגוריה IN_APP_AD_REVENUE ב-ConversionActionCategory כדי לעקוב אחרי ההכנסות ממונטיזציה של מודעות באפליקציה.
כללי
BusinessProfileLocationSyncError	ערכי enum ושגיאות חדשים	הוספנו סיבות לשגיאות בסנכרון המיקומים של פרופיל העסק כשמסנכרנים מיקומים בAssetSet מסוג LOCATION_SYNC. במקום להחזיר שגיאה כללית UNKNOWN, ה-API מחזיר עכשיו BusinessProfileLocationSyncError עם סיבות ספציפיות (EMAIL_INVALID,‏ OAUTH_TOKEN_INVALID,‏ ACCOUNT_REMOVED ו-NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
תכנון
מדדי אחוזונים של BenchmarksService.GenerateBenchmarksMetrics	תכונות חדשות	העדכון של BenchmarksService.GenerateBenchmarksMetrics מאפשר לכם לראות מדדים שמייצגים את המיקום התחרותי שלכם בהשוואה למפרסמים אחרים, בפורמט של רמת אחוזון. המדדים מוחזרים ב-PercentileMetrics בשדה החדש CustomerMetrics.percentile_metrics (גם ב-GenerateBenchmarksMetricsResponse.customer_metrics וגם ב-BreakdownMetrics.customer_metrics) ומיוצגים באמצעות BenchmarksCustomerPercentileTier. השדה CustomerMetrics.percentile_metrics מאוכלס רק כששני התנאים הבאים מתקיימים ב-GenerateBenchmarksMetricsRequest: השדה PERCENTILE_DATA נדרש ב-supplemental_data. הפרמטר BenchmarksSource.all_advertisers מוגדר ב-benchmarks_source (שגם מחייב לציין את category_filter). נוספה תמיכה במדדי אחוזונים לתאריכים של רבעונים פתוחים ב-ListBenchmarksAvailableDatesResponse.supported_dates (מוחזרים על ידי BenchmarksService.ListBenchmarksAvailableDates). מדדים מצטברים של לקוחות (CustomerMetrics.aggregate_metrics), מדדי שיעורים של לקוחות (CustomerMetrics.average_rate_metrics) ומדדי אחוזונים של לקוחות (CustomerMetrics.percentile_metrics) נתמכים בכל התאריכים ב-supported_dates (כולל רבעונים פתוחים). לעומת זאת, מדדי נתח שוק של לקוחות (CustomerMetrics.share_metrics) ומדדי שיעורים של מקור נקודות ההשוואה (average_benchmarks_metrics, כמו average_cpm של מודעות בקטגוריה '/הלבשה/בגדים') לא נתמכים ברבעונים פתוחים ומושמטים מהתגובה, אלא אם ה-date_range המבוקש נמצא בטווח הצר יותר של ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. נוספה שגיאה מותאמת אישית BenchmarksError.NO_METRICS_FOUND שמוצגת אם לא נמצאו מדדים לשילוב הקלט שנבחר, כדי לשפר את נוחות השימוש.
כינויים של ערוצי YouTube לתובנות לגבי יוצרים	תכונה חדשה	השיטה ContentCreatorInsightsService.GenerateCreatorInsights עודכנה כדי לתמוך בחיפוש לפי כינויים של ערוצי YouTube באמצעות YouTubeChannels.youtube_channel_handles (כינויים תקינים של ערוצים חייבים להתחיל ב-@, למשל @channel_handle). האפשרות הזו דומה לחיפוש לפי מזהי ערוצים של YouTube. התשובה מכילה תובנות לגבי היוצרים המבוקשים ב-YouTube.
המלצות
המלצות לגבי הצעות מחיר של עלות להמרה והחזר על הוצאות הפרסום	המלצות חדשות	הוספנו את Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) ואת Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), יחד עם ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low ו-ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, כדי לתמוך בהגדלת יעד העלות להמרה או בהקטנת יעד ההחזר על הוצאות הפרסום כשהצעות המחיר נמוכות מדי בשביל שקמפיינים לרשת החיפוש ישתתפו במכרזים: ‫RaiseTargetCpaPerformanceBidTooLowRecommendation מספק recommended_target_multiplier (גורם גדול מ-1.0) ו-current_average_target_cpa_micros. כדי להחיל אותו, משתמשים ב-RaiseTargetCpaPerformanceBidTooLowParameters עם target_cpa_multiplier. ‫LowerTargetRoasPerformanceBidTooLowRecommendation מספק recommended_target_multiplier (גורם קטן מ-1.0) ו-current_average_target_roas. כדי להחיל אותו, משתמשים ב-LowerTargetRoasPerformanceBidTooLowParameters עם target_roas_multiplier.
דוחות
פלחי מאפיינים של מסלולי נסיעה למלונות	פלחים חדשים	הוספנו את הפלחים הבאים של מאפייני מסלול הנסיעה להזמנת מלונות ונסיעות אל Segments (ניתן לבחור באמצעות campaign,‏ ad_group ו-customer): ‫Segments.advance_booking_window: חלון הזמן להזמנה מראש של מסלול הנסיעה, בימים. ‫Segments.length_of_booking: משך ההזמנה של מסלול הנסיעה בימים. ‫Segments.start_date: תאריך ההתחלה של ההזמנה בפורמט yyyy-MM-dd. ‫Segments.start_day_of_week: יום ההתחלה של השבוע (DayOfWeek) של ההזמנה. ‫Segments.user_set_dates: מציין אם נבחרו תאריכים שהמשתמש הגדיר (HotelDateSelectionType).
מדדים של מודעות בענפים ספציפיים	מדדים חדשים	הוספנו את המדדים הבאים לדיווח על מודעות בענפי המלונאות והנסיעות ב-Metrics (ניתן לבחור אותם באמצעות campaign,‏ ad_group ו-customer): ‫Metrics.vertical_ads_average_booking_value_micros: התעריף היומי הממוצע משוקלל לפי קליקים במיקרו-שקל, כולל מיסים ועמלות, לאורך כל משך השהייה בהזמנות של חדרים במלון. ‫Metrics.vertical_ads_potential_impressions: סה"כ החשיפות התקינות עם הגבלת צפיות שזמינות בהקשר של השאילתה. ‫Metrics.vertical_ads_price_difference_percentage: הפרש באחוזים בין המחיר שהמפרסם מציע לבין המחיר הנמוך ביותר של המתחרים באותו מלון.
פלחים של מודעות לענפים ספציפיים	פלחים חדשים	הוספנו את הפלחים הבאים לדיווח על מודעות בענפי המלונות והנסיעות ב-Segments (ניתן לבחור באמצעות campaign,‏ ad_group ו-customer): Segments.vertical_ads_price_tier: רמת המחיר של המפרסם (HotelPriceBucket) בהשוואה למתחרים במכרז. ‫Segments.vertical_ads_rate_rule_id: המזהה של כלל התמחור שמשויך לכלל התמחור של המפרסם. ‫Segments.vertical_ads_rate_type: סוג התעריף (HotelRateType) של הזמנת החדר במלון.

גרסה 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. הוספנו פלחים ומדדים חדשים כדי לתמוך בניתוח של Brand Lift באמצעות LiftMeasurementConfig והמשאבים הממדיים החדשים. נוספו ערכי ה-enum הבאים: BrandLiftMeasurementType,‏ LiftMeasurementFlightStatus,‏ SurveyIntendedAction,‏ SurveyLiftFlightTargetResponseMode ו-SurveySubjectType.
מדידות של עלייה בהמרות	תכונות חדשות	הוספנו תמיכה במדידת עלייה בהמרות עם העדכונים הבאים: נוסף משאב חדש לקריאה בלבד LiftMeasurementConfig שמייצג מחקר למדידת שיפור. הוספנו פלחים חדשים שאפשר לבחור כדי לפלח ולסנן את תוצאות העלייה. הוספנו 24 מדדים חדשים של עלייה בהמרות ומדדים של ניקוד המנצח, שתומכים בניתוח סטטיסטי מפורט של ביצועי העלייה. נוספה תמיכה באחזור פרטי קמפיין ויעדי המרה. הוספנו שדה אופציונלי חדש Experiment.lift_measurement_config. הוספנו את הטיפוס המוגדר מראש 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. הוספנו את הטיפוס המוגדר מראש 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 בהתאמה, לצד השדות החדשים value_multiplier ו-high_lifetime_value_multiplier	שינוי מבני	צריך לעדכן את ההפניות לשדות האלה כי הם עכשיו חלק מ-oneof.
משאבים מדור קודם של CustomerLifecycleGoal ושל CampaignLifecycleGoal, השירותים התואמים שלהם CustomerLifecycleGoalService וCampaignLifecycleGoalService, והגדרות/ספירות מדור קודם (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	ללא	הסרה	שימוש בסכימה המשופצת של יעדים מאוחדים: משתמשים בשדה new_customer_acquisition_goal_settings במשאב Goal. משתמשים בשדה campaign_new_customer_acquisition_settings במשאב CampaignGoalConfig כדי להגדיר שינויים ספציפיים לקמפיין.
כללי
שדות enum בתוך שדות בהודעות הבקשה והתגובה של Incentive Service: 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 בגרסאות v25,‏ v24 ו-v23.
קמפיינים
היעד 'שימור חברים במועדון הלקוחות'	תכונות או הגדרות חדשות	הוספנו תמיכה ביעד 'שימור חברים במועדון הלקוחות', שמאפשר למפרסמים לבצע אופטימיזציה של קמפיינים כדי לשמר חברים במועדון הלקוחות. הוספנו את 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 לטיפוסים בני מנייה (enum) 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 כדי לאפשר הגדרה של שותפים לשילוב מוצרי Google ברמת הלקוח. הוספנו את CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners כדי לאפשר הגדרה של שותפים לשילוב מוצרי Google ברמת הקמפיין. מידע נוסף זמין במאמר הזה במרכז העזרה.
כללי
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 (מודעת וידאו In-stream שאי אפשר לדלג עליה, באורך של עד 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	שדה חדש	הוספנו תמיכה במידע של מודעות "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 חדש / שגיאה	השגיאה הזו מוחזרת כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של "Google בעלי מקצוע".
SmartCampaignErrorEnum.CREATION_FAILED	ערך enum חדש / שגיאה	מוחזרת כשמנסים ליצור קמפיינים חכמים חדשים.
המרות
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	ערכי enum חדשים	מייצגות המרות שמתרחשות כשמשתמש לוחץ על מודעה של "Google בעלי מקצוע" ומתקשר למפרסם, שולח לו הודעה או מזמין ממנו שירות.
ניסויים
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) – גרסה 23 וגרסה 22. כדי לעזור לכם לתכנן את עבודת השילוב הקרובה של גרסה 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)	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. נוספה תמיכה בבדיקות של אישור מכמה משתמשים (MPA): הוספנו את המשאב MultiPartyAuthReview ואת ה-MultiPartyAuthReviewService המתאים. הוספנו את הטיפוס המוגדר מראש 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 מכיל את הטיפוס המוגדר (enum) LOCAL_CREATOR_DATA. התכונה חושפת יוצרים מקומיים שהצופים צפו בהם או שהם נמצאים במדינה שנבחרה, ושנתנו הסכמה לשיתוף נתוני המיקום שלהם.
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 Assets. ‫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	ללא	הסרה	הסרנו את הסוגים והשדות הבאים של תוכניות ותחזיות: 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 חדשים	נוספו סוגים חדשים של פעולות המרה ב-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 לשגיאות אימות.

‫v23.2‏ (25.03.2026)

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

תכונות ועדכונים	סוג	תיאור
נכסים
VideoEnhancement	משאב חדש	מכיל מידע ספציפי על שיפורים במודעות וידאו, למשל אם השיפור נוצר על ידי Google או סופק על ידי המפרסם. מידע נוסף זמין במאמר מידע על התכונה "שיפור סרטונים".
AppTopCombinationView	משאב חדש	משאב לקריאה בלבד שמספק תובנות לגבי שילובי הנכסים שמניבים את הביצועים הכי טובים בקמפיינים לקידום אפליקציות.
CustomerAsset	תכונה חדשה	הוספנו תמיכה באחזור של CustomerAsset כשהערך של field_type מוגדר כ-BUSINESS_LOGO.
קמפיינים
AdGroupAd.start_date_time AdGroupAd.end_date_time	שדות חדשים	הגדרת אילוצים מפורטים יותר לגבי התזמון של תאריכי הקמפיין. האפשרות הזו נתמכת רק בחלק מהסוגים של קבוצות המודעות.
HotelSettingInfo.disable_hotel_setting	שדה חדש	מאפשרת להשבית את פיד המלונות בקמפיינים ליצירת ביקוש.
כללי
CustomerClientLinkError	ערכי enum חדשים / שגיאות	נוספו שני קודי שגיאה חדשים: MAX_CUSTOMER_LIMIT_REACHED ו-ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	שינוי התנהגותי	אם מנסים להשתמש בקטגוריה הזו של סוג הלקוח ברשימת משתמשים שהוצאה משימוש, מוצגת שגיאה.
תכנון
GenerateTrendingInsights GenerateCreatorInsights	תכונות חדשות	הוספנו תמיכה בשילובים מותאמים אישית של "וגם"/"או" של ישויות, נושאים וקהלים.
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	שדה חדש	תמיכה בשאילתות ובסינון של קמפיינים שחסרות בהם הצהרות לגבי השאלה אם הם מכילים פרסום פוליטי שמטורגט לאיחוד האירופי.
המרות
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 של תוויות לציון רמת הביצועים של נכסים מצטברים	ללא	הסרה	הסרנו את המדדים המצטברים של תוויות לציון רמת הביצועים של הנכסים. הערך 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	אפשרויות חדשות	עכשיו אפשר להחזיר פרטים ברמה יותר מפורטת ב-Invoice, כולל פירוט עלויות ברמת הקמפיין, עלויות רגולטוריות מפורטות ומידע על התאמות, על ידי הגדרת include_granular_level_invoice_details ב-ListInvoicesRequest.
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, שמאפשרים לדעת אם המודעה הייתה נשמעת וכמה חשיפות אפשר היה למדוד.

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

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