נתוני גרסה

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

גרסה ראשית v25

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

גרסה 25‏ (22.07.2026)

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

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

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

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
קמפיינים
שדות עצמאיים additional_value ו-additional_high_lifetime_value ב-CustomerLifecycleOptimizationValueSettings	חלק מהשדות value_adjustment ו-high_lifetime_value_adjustment oneof בהתאמה, לצד השדות החדשים value_multiplier ו-high_lifetime_value_multiplier	שינוי מבני	צריך לעדכן את ההפניות לשדות האלה כי עכשיו הם חלק מ-oneofs.
משאבים מדור קודם של CustomerLifecycleGoal ושל CampaignLifecycleGoal, השירותים התואמים שלהם CustomerLifecycleGoalService וCampaignLifecycleGoalService, והגדרות/ספירות מדור קודם (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	ללא	הסרה	שימוש בסכימה המשופצת של היעדים המאוחדים: משתמשים בשדה new_customer_acquisition_goal_settings במשאב Goal. משתמשים בשדה campaign_new_customer_acquisition_settings במשאב CampaignGoalConfig כדי להגדיר שינויים ספציפיים לקמפיין.
כללי
שדות enum בתוך שדות בהודעות בקשה ותגובה של שירות התמריצים: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	שדות enum עצמאיים: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	שינוי שם / הסרה	משתמשים בשדות החדשים של enum עצמאיים במקום בשדות הקודמים של type.
שדות אופציונליים selected_incentive_id וcustomer_id ב-ApplyIncentiveRequest	שדות חובה	שינוי באופן הפעולה	חשוב לוודא שציינתם את שני השדות כשאתם קוראים לפונקציה ApplyIncentive.
השדה של כתובת האימייל של הצרכן/ית ContactDetails.email במשאב LocalServicesLead	ללא	הסרה	צריך להסיר את ההפניות לשדה הזה כי הוא כבר לא נתמך.
שדה אופציונלי allowed_domain בAdvertisingPartnerLinkInvitationProperties	שדה חובה כשמתקשרים אל CreateProductLinkInvitation בשביל שותף לקניית שטחי פרסום	שינוי באופן הפעולה	כשיוצרים הזמנה לקישור מוצרים לשותף לקניית שטחי פרסום, חשוב לספק allowed_domain.
תכנון
השדה search_brand ב-GenerateCreatorInsightsRequest	ללא	הסרה	במקום זאת, צריך להשתמש ב-search_topics.
השדה plannable_location_id ב-Targeting והשדה cookie_frequency_cap ב-GenerateReachForecastRequest	ללא	הסרה	עוברים לשימוש ב-plannable_location_ids וב-cookie_frequency_cap_setting.
דוחות
השדה customer_metrics ב-GenerateBenchmarksMetricsResponse וב-BreakdownMetrics מסוג Metrics	שדה מסוג CustomerMetrics	שינוי בסוג או שינוי בהתנהגות	צריך לעדכן את השילובים כדי להשתמש בסוג CustomerMetrics החדש, שמכיל רק מדדים שמייצגים את ביצועי המודעות של הלקוח.

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

תכונות ועדכונים	סוג	תיאור
מודעות
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	ערך enum חדש / התנהגות חדשה	זמין בתאריכים DemandGenMultiAssetAds. אם האפשרות הזו מופעלת, המערכת יוצרת תמונות מונפשות באמצעות תמונות לא מונפשות כקלט. החל מגרסת ה-API הזו, DemandGenMultiAssetAds חדשים מופעלים כברירת מחדל.
אפשרות לשינוי של מידע על תוכן סינתטי	שינוי בהתנהגות	האובייקטים Asset.synthetic_content_info ו-Ad.synthetic_content_info ניתנים עכשיו לשינוי באופן מלא בגרסאות 25, 24 ו-23.
קמפיינים
יעד שימור נאמנות	תכונות או הגדרות חדשות	הוספנו תמיכה ביעד 'שימור חברים במועדון הלקוחות', שמאפשר למפרסמים לבצע אופטימיזציה של קמפיינים כדי לשמר חברים במועדון הלקוחות. הערך LOYALTY_RETENTION נוסף לרשימת הערכים GoalType. הוספנו את CampaignGoalConfig.campaign_loyalty_retention_settings כדי להגדיר הגדרות שימור ספציפיות לקמפיין, כולל התאמות של הצעות מחיר והצגת הטבות לחברי מועדון בפורמט PLA. נוספה האפשרות Goal.loyalty_retention_goal_settings להגדרת יעדי שימור ברמת החשבון. הוספנו קודי שגיאה חדשים: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
היעד 'צירוף לקוחות חדשים'	תכונות או הגדרות חדשות	עדכנו את התמיכה ביעד 'צירוף לקוחות חדשים' ב-Google Ads API כדי לשקף את סכימת היעדים המאוחדת המשופצת: הרחבנו את המשאב Goal כדי לתמוך בהגדרות של צירוף לקוחות חדשים באמצעות השדה new_customer_acquisition_goal_settings. הרחבנו את המשאב CampaignGoalConfig כדי לתמוך בשינויים ספציפיים לקמפיין לצירוף לקוחות חדשים באמצעות השדה campaign_new_customer_acquisition_settings. נוסף ה-enum החדש CustomerLifecycleOptimizationGoalSubType כדי להגדיר סוגי משנה נתמכים של יעדים. הערך NEW_CUSTOMER_ACQUISITION נוסף לרשימת הערכים GoalType. הוספנו סיבות חדשות לשגיאות אימות ל-GoalError: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS הוספנו סיבות חדשות לשגיאות אימות ל-CampaignGoalConfigError: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS נוסף ErrorDetails.incompatible_clo_goal_error_details כדי לחשוף את המבנה החדש של IncompatibleCloGoalsErrorDetails לשגיאות אימות.
המרות
ייחוס המרות ב-YouTube לצד שלישי	שדות חדשים	הוספנו תמיכה באימות של שיוך המרות ב-YouTube באמצעות שותפי צד שלישי: הוספנו את CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners כדי לאפשר הגדרה של שותפים לשילוב מוצרים ברמת הלקוח. הוספנו את CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners כדי לאפשר הגדרה של שותפים לשילוב מוצרים ברמת הקמפיין. מידע נוסף זמין במאמר הזה במרכז העזרה.
כללי
ContactDetails.phone_number_extension	שדה חדש	נוסף למשאב LocalServicesLead.
IncentiveError	ערכי enum חדשים / שגיאות	נוספו קודי שגיאה ספציפיים חדשים למימוש תמריצים שנכשל: ‫BILLING_COUNTRY_NOT_ELIGIBLE (המדינה לצורכי חיוב של הלקוח לא כשירה לקבלת התמריץ) ‫USER_IS_MCC_MANAGER (המשתמש הוא חשבון ניהול ואין לו אפשרות לממש את התמריץ) ‫USER_SUSPENDED (חשבון הלקוח מושעה) ‫MAX_PENDING_INCENTIVES (הלקוח הגיע למספר המקסימלי של תמריצים בהמתנה) ‫ACCOUNT_HAD_RECENT_SPEND (היו בחשבון הוצאות לאחרונה והוא לא עומד בדרישות) ‫MAX_INCENTIVES_REDEEMED_FROM_OFFER (הלקוח כבר מימש את מספר התמריצים המקסימלי מהמבצע הזה) ‫MISMATCHING_BILLING_COUNTRY_CODE (קוד המדינה לצורכי חיוב שצוין בבקשה לא תואם למדינה שמוגדרת בחשבון של הלקוח)
תכנון
פרטים על ערוץ YouTube בתובנות לגבי נושאים פופולריים	שדות חדשים	הוספנו תמיכה בפרטים נוספים של ערוצי YouTube של סרטונים קשורים כשמחפשים תובנות לגבי נושאים פופולריים. השדות החדשים channel_id,‏ channel_name ו-channel_url נוספו ל-YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given	שדה חדש	נוסף אל YouTubeChannelInsights. הדבר נכון אם יוצר הסכים לשתף נתונים שלא גלויים לכולם. אם כן, השדות הבאים יאוכלסו: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
דוחות
ad_sub_format_type	פלח חדש	פירוט של מודעות וידאו In-stream ב-YouTube שלא ניתן לדלג עליהן לפי משך: ‫INSTREAM_NON_SKIPPABLE_STANDARD (מודעת וידאו In-stream רגילה שלא ניתן לדלג עליה) ‫INSTREAM_NON_SKIPPABLE_MAX30_SEC (מודעת וידאו In-stream שלא ניתן לדלג עליה, באורך של עד 30.99 שניות) ‫INSTREAM_NON_SKIPPABLE_MAX60_SEC (מודעת וידאו Instream שאי אפשר לדלג עליה, באורך של עד 60.99 שניות) תמיד צריך לבחור את הפלח הזה יחד עם ad_format_type. אפשר לבחור אותו באמצעות AdGroup,‏ AdGroupAd,‏ Campaign,‏ Customer,‏ Video ו-VideoEnhancement.
מדדים ספציפיים לרשתות חברתיות שקשורים לסרטונים	שדות או מדדים חדשים	הוספנו מדדים ספציפיים לרשתות חברתיות לגבי סרטונים, כדי לעזור למפרסמים לעקוב אחרי מעורבות המשתמשים (תגובות, לייקים ושיתופים) במודעות ב-Shorts ב-YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares הם זמינים ב-AdGroup, ב-AdGroupAd, ב-Asset, ב-Campaign, ב-Customer וב-Video.

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

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

גרסה 24.2‏ (24.06.2026)

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

תכונות ועדכונים	סוג	תיאור
מודעות
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	ערך חדש של טיפוס בן מנייה (enum)	יוצר מידע טקסט מדף הנחיתה שיוצג בחלונית ההתקשרות עם הלקוח עבור מופעים של DemandGenVideoResponsiveAd (שמופעלים כברירת מחדל החל מגרסת ה-API הזו).
נכסים
AssetGroup.google_local_services_info	שדה חדש	הוספנו תמיכה בפרטים של מודעות לקידום עסקים מקומיים (מזהה קטגוריה ויתרונות מרכזיים) בקמפיינים למיקסום הביצועים.
AssetGroupSignal.local_services_id	שדה חדש	הוספנו תמיכה באותות של מזהי שירותים ב-"Google לבעלי מקצוע" בקמפיינים למיקסום הביצועים.
AssetGroupSignal.vertical_ads_item_group_rule_list	שדה חדש	הוספנו תמיכה בכללים של קבוצות פריטים של מודעות אנכיות לבחירת פריטים מפידים אנכיים שמצורפים לקמפיינים למיקסום הביצועים. התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים להסיר את כל קבוצות הנכסים מקמפיין.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים להסיר את כל האותות מקבוצת נכסים.
קמפיינים
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	שדות חדשים	תמיכה בזיהוי קמפיינים למיקסום ביצועים של Google בעלי מקצוע.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	שדה חדש	הוספנו את מפות Google לערוצים שאפשר לבחור לקבוצות של מודעות ליצירת ביקוש.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של קמפיין לקידום העסק המקומי.
SmartCampaignErrorEnum.CREATION_FAILED	ערך enum חדש / שגיאה	השגיאה מוחזרת כשמנסים ליצור קמפיינים חכמים חדשים.
המרות
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	ערכי enum חדשים	מייצג המרות שמתרחשות כשמשתמש לוחץ על מודעה של ספק שירותים מקומיים ומתקשר למפרסם, שולח לו הודעה או מזמין ממנו שירות.
ניסויים
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	ערכי enum חדשים	הוספנו תמיכה בסוגים חדשים של ExperimentType: ‫COMPARE_CAMPAIGNS: לניסויים בתמהיל קמפיינים ולניסויים מותאמים אישית בקמפיינים למיקסום הביצועים שמשווים בין כמה קמפיינים מאותו סוג או מסוגים שונים בניסוי אחד. ‫PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: לניסויים לאופטימיזציה של קמפיינים למיקסום הביצועים שקשורים להתאמה אישית של טקסט ולהתאמת כתובת URL סופית.
כללי
Asset.synthetic_content_info Ad.synthetic_content_info	שדות חדשים	כוללים הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו אוטומטית או שסופקו על ידי המערכת). התכונה הזו הועברה לאחור (backported) לגרסאות v23 ו-v22. כדי לעזור לכם לתכנן את עבודת השילוב הקרובה שלכם עם גרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות האישור של המפרסם בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל synthetic_content_info.advertiser_attestation.status ו- synthetic_content_info.advertiser_attestation.source יישארו ללא שינוי בגרסאות האלה. אם תנסו לשלוח בקשת שינוי לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: ‫"The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או ‫"Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק.
אישור על ידי גורמים מרובים	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. הוספנו תמיכה בבדיקות של אישור ממספר משתמשים (MPA): נוספו המשאב MultiPartyAuthReview וMultiPartyAuthReviewService התואם. נוסף ה-enum‏ MultiPartyAuthReviewStatus כדי לעקוב אחרי סטטוס הביקורת. נוספה אפשרות CustomerUserAccess.pending_multi_party_auth_review לקישור לביקורת בהמתנה. נוספו MutateCustomerUserAccessResult.multi_party_auth_review ו-MutateCustomerUserAccessInvitationResult.multi_party_auth_review כדי להחזיר את שם משאב הביקורת המשויך. נוספה MultiPartyAuthReviewError לשגיאות אימות. התכונה הזו הועברה לגרסאות קודמות: v23.3,‏ v22.2 ו-v21.2.
IncentiveService.FetchIncentive	שינוי התנהגותי	אם בבקשה מצוינת כתובת אימייל לא תקינה, השיטה מחזירה עכשיו את הצעות התמריצים שמוגדרות כברירת מחדל במקום להחזיר שגיאת AuthenticationError.INVALID_EMAIL_ADDRESS.
תכנון
GenerateCreatorInsightsRequest.search_topics	שדה חדש	נוסף לשירות ContentCreatorInsightsService.GenerateCreatorInsights. האפשרות הזו מחפשת יוצרים שמדברים על נושא במדינה שצוינה בcountry_locations (אפשר לחפש רק במדינה אחת).
CREATOR_TOPIC_INSIGHTS	ערך חדש של טיפוס בן מנייה (enum)	התווסף לInsightsKnowledgeGraphEntityCapabilities כדי לציין ישויות לחיפוש יוצרים שמדברים על נושא מסוים. צריך להשתמש בישויות האלה בשדה search_topics. הנתונים אוחזרו באמצעות AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	סוג חדש / אפשרויות	מכיל אפשרויות חיפוש נוספות לנושאים ב-ListAudienceInsightsAttributes, כולל אפשרויות לאחזור כל הנושאים שנתמכים כמאפייני יוצרים, וסינון לפי יכולות.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	שדות חדשים	קלט אופציונלי לשיטות ContentCreatorInsightsService. הזנת השדה הזה מאכלסת מיקומים נוספים או מאפיינים של יוצרים בתגובה.
local_creator_insights related_local_creators	שדות חדשים	המאפיין מאוכלס כשהמאפיין supplemental_data מכיל את הערך LOCAL_CREATOR_DATA enum. התכונה מאפשרת לראות יוצרים מקומיים שצפו בהם או שהם נמצאים במדינה שנבחרה, ושנתנו הסכמה לשיתוף נתוני המיקום שלהם.
GenerateTrendingInsightsRequest.sub_country_locations	שדה חדש	הוספנו את ContentCreatorInsightsService.GenerateTrendingInsights, כך שאפשר לחפש תובנות לגבי מגמות לפי מיקום במדינה ומיקומים משניים במדינה.
דוחות
PerformanceMaxPlacementView	תוסף פלחים	הפילוח בוצע על ידי ad_network_type.
קניות
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	שדה חדש	אם הערך הוא True, המערכת מתעלמת מהחרגות של מותגים במודעות שופינג. התמיכה זמינה רק לקמפיינים של שופינג.
טירגוט
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים לטרגט שפה שאסור לטרגט.
סרטונים
DataLink.youtube_link_metadata	שדה חדש	מכיל את הערך brand_channel_id כדי לציין את המזהה של ערוץ המותג המקושר ב-YouTube.

גרסה 24.1‏ (13.05.2026)

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

תכונות ועדכונים	סוג	תיאור
מודעות
DemandGenMultiAssetAdInfo.classic_display_images	שדה חדש	תמונות מותאמות אישית לרשת המדיה שהועלו ומוצגות בלי שנדרשים נכסים רספונסיביים נוספים.
ניסויים
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	ערכי enum חדשים	הוספנו תמיכה בסוגים חדשים של ExperimentType: ‫ADOPT_AI_MAX: לניסויים שבודקים איך AI למיקסום ביצועים יכול לעזור לכם להגיע ליותר לקוחות באמצעות Google AI ומילות מפתח בהתאמה רחבה. ‫ADOPT_BROAD_MATCH_KEYWORDS: לניסויים שבודקים איך מילות מפתח בהתאמה רחבה יכולות להשפיע על מספר החיפושים שבהם המודעות שלכם מופיעות. ‫OPTIMIZE_ASSETS: לניסויים בהתאמה אישית לאופטימיזציה של נכסים. ‫PMAX_REPLACEMENT_SHOPPING: לניסויים שבודקים את הביצועים של קמפיינים שופינג בהשוואה לקמפיינים למיקסום הביצועים.
Experiment.video_experiment	שדה חדש	תמיכה בהגדרת ניסויים קיימים של YOUTUBE_CUSTOM שכוללים קמפיינים של מודעות וידאו.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	שדות חדשים	הוספנו שדות לתמיכה בבדיקת נכסים, בקבוצות נכסים ובהגדרות של קמפיינים למיקסום הביצועים בקבוצות ניסוי: ‫asset_testing_info: פרטים על נכסים שמשויכים לעותקים הניסיוניים של המודעות. ‫asset_groups: רשימה של קבוצות נכסים בקבוצת הניסויים של ניסויים בנכסי Optimize. ‫performance_max_experiment_arm_info: הגדרות של קמפיינים למיקסום הביצועים בניסויים של PMAX_REPLACEMENT_SHOPPING.
כללי
CustomerUserAccess.passkey_enabled	שדה חדש	שדה לקריאה בלבד שמציין אם למשתמש יש מפתח גישה.
דוחות
mobile_device_platform	פלח חדש	מאפשר לפלח את הדוחות לפי הפלטפורמה של מכשיר המשתמש (למשל iOS או Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	ערך enum חדש / שגיאה	הערך שמוחזר כשגרעיניות הזמן היומית, השעתית או השבועית המבוקשת לא נתמכת בטווח התאריכים של השאילתה (זמינה רק ל-37 החודשים האחרונים).
vertical_ads_listing_user_rating vertical_ads_listing_venue	פלחים חדשים	פלחי קהל חדשים לשימוש במודעות לפי תחום.
user_rating,‏ venue,‏ event_participant_display_name	קריטריוני סינון חדשים	סינון נתמך ב-VerticalAdsItemGroupRuleInfo עבור המשאב SharedCriterion.
מדדים של ניסוי בקרה/ניסוי	שדות חדשים	נוספו ערכי בקרה (control_clicks וכו'), ערכי טיפול (clicks וכו'), אומדנים נקודתיים (clicks_point_estimate וכו'), שולי שגיאה (clicks_margin_of_error וכו') וערכי p (clicks_p_value וכו') בשבע קבוצות של מדדים מרכזיים (קליקים, חשיפות, עלות, המרות, עלות להמרה, ערך המרה, ערך המרה לעומת עלות).
מדדים של שינוי אבסולוטי בהמרות	שדות חדשים	תמיכה בConversions הערכות של הפרש מוחלט באמצעות שדות של הערכה נקודתית, טווח שגיאה וערך p.
טירגוט
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	ערך enum חדש / שגיאה	הערך הזה מוחזר כשמנסים להחריג את כל קבוצות היעד הדמוגרפיות.
סרטונים
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	ערך חדש של טיפוס בן מנייה (enum)	פרסמנו את ZEFR כשותפה לשילוב מוצרי Google למדידת הניראות.
DataLink.youtube_video.channel_id	שדה חדש	הפונקציה חושפת את מזהה הערוץ ב-YouTube שמשויך לקישור הנתונים.

גרסה 24‏ (22.04.2026)

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

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

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

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
מודעות
מאפייני videos ו-logo_images אופציונליים בDemandGenVideoResponsiveAdInfo	שדות חובה	שינוי באופן הפעולה	כשיוצרים או משנים מודעות וידאו רספונסיביות ליצירת ביקוש, צריך לספק videos וlogo_images.
אופציונלי: videos,‏ business_name ו-logo_images ב-VideoResponsiveAdInfo	שדות חובה	שינוי באופן הפעולה	כשיוצרים או משנים מודעות וידאו רספונסיביות, צריך לספק את הערכים videos, business_name ו-logo_images. שימו לב: VideoResponsiveAdInfo ניתן לשינוי.
קמפיינים
Campaign.video_brand_safety_suitability	ללא	הסרה	הוסר אמצעי הבקרה לשמירה על תאימות ברמת הקמפיין. התאימות להגנה על המותג עדיין זמינה ברמת הלקוח. במקום זאת, צריך להשתמש ב-Customer.video_brand_safety_suitability.
המרות
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	ללא	הסרה	קטגוריית המשתמשים 'הרשמות למועדון הלקוחות' הוסרה. מסירים את ההפניות לקוד.
תכנון
סוג InsightsAudienceAttributeGroup של topic_audience_combinations	common.InsightsAudienceAttributeGroup type	שינוי באופן הפעולה / שינוי סוג	צריך לעדכן את השילובים של ספריות לקוח עם הקלדה כדי להשתמש במרחבי השמות החדשים של המשאבים.
השדה youtube_select_lineups בReachPlanService.ListPlannableProducts	ללא	הסרה	מעבר לשימוש בחבילות ערוצים מ-youtube_select_lineup_targeting.
השדה is_brand_connect_creator ב-ContentCreatorInsightsService.GenerateCreatorInsights וב-GenerateTrendingInsights	ללא	הסרה	במקום זאת, אפשר לבדוק אם ליוצר יש CREATOR_PARTNERSHIPS זמין ב-partnership_opportunities.
‫geo_modifiers ו-biddable_keywords ב-KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants וגם keywords	שינוי שם / הסרה	הוחלף על ידי CampaignToForecast.geo_target_constants[] ו-ForecastAdGroup.keywords[].
שדות שיצאו משימוש בתחזית או בתוכנית מילות המפתח ב-GenerateKeywordForecastMetrics	ללא	הסרה	הוסרו השדות והסוגים הבאים של תוכניות ותחזיות: CampaignToForecast.keyword_plan_network הפקודה CampaignToForecast.negative_keywords והפקודה ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate מעדכנים את השילובים בהתאם.
דוחות
פלח ad_sub_network_type בcampaign_budget	ללא	הסרה	הוסר פלח ad_sub_network_type מהמשאב campaign_budget.
click_type פלח בתצוגות של נכסים	ללא	הסרה	הפלח הוסר מהתצוגות AdGroupAsset,‏ CampaignAsset ו-CustomerAsset.
סרטונים
כשל חלקי מותר בShareablePreviewService.GenerateShareablePreviews	אין כשלים חלקיים	שינוי באופן הפעולה	אם אחד מהמזהים לא יעבור את האימות, הבקשות ייכשלו ותוצג שגיאה.
ShareablePreviewError קודים מדור קודם: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	שינוי השם / שינוי באופן הפעולה	קודי השגיאה שמוחזרים לקבוצות נכסים משתנים כדי להתאים לשגיאות במודעות בקבוצות של מודעות. עדכון הלוגיקה של תפיסת אימות.

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

תכונות ועדכונים	סוג	תיאור
מודעות
יכולת השינוי של VideoResponsiveAdInfo	שינוי התנהגותי	אובייקטים של מידע על מודעות וידאו רספונסיביות ניתנים עכשיו לשינוי.
נכסים
‫travel_feed_data ב-AssetSet	שדה חדש	נוסף כדי לאחזר מאפיינים של נכסים בפיד נסיעות (hotel_center_account_id, ‏ merchant_center_id, ‏ partner_center_id, ‏ subset_id, ‏ travel_feed_vertical_type).
קמפיינים
Campaign.view_through_conversion_optimization_enabled	שדה חדש	ההגדרה הזו מאפשרת להפעיל אופטימיזציה להמרות בעקבות צפייה (VTC) (ברירת המחדל false) בקמפיינים ליצירת ביקוש ובקמפיינים לקידום אפליקציות.
CampaignCriterion.gender	תכונה חדשה	הפעלנו החרגות של מגדר בקמפיינים למיקסום הביצועים בכל הגרסאות של Google Ads API.
המרות
סוגי המרות של לידים	ערכי enum חדשים	נוספו סוגי enum חדשים של פעולות המרה ב-GA4/Firebase ב-ConversionActionType: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
כללי
UserListErrorEnum.DUPLICATE_LOOKALIKE	ערך enum חדש / שגיאה	השגיאה הזו מוחזרת כשמנסים ליצור כמה רשימות זהות של קהלים דומים.
תכנון
ProductCoreAttributes שדות בListPlannableProductsResponse	שדות חדשים	הוספנו תיאור מוצר שניתן לתכנון, יעד שיווקי, מודל עלויות ושיטת רכישה אל ProductCoreAttributes בקטע ListPlannableProductsResponse.
דוחות
CartDataSalesView	משאב דיווח חדש	הדוחות מציגים פילוח של מדדי ההמרות לפי המוצר הספציפי שנמכר (מותג וכו') בנוסף למוצר שהמשתמש לחץ עליו.
מדדים שלא ניתן להגיש עליהם הצעות מחיר	שדות חדשים	הוספנו מדדים שלא ניתן להגיש עליהם הצעות מחיר (מדדים שמציגים המרות שהקמפיינים לא עוברים אופטימיזציה כדי להשיג אותן) לכל הנכסים התואמים: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	פלח חדש	נוסף אל ShoppingPerformanceView.
קניות
קמפיינים לקידום אפליקציות בShoppingProduct	תכונה חדשה	קמפיינים נתמכים לקידום אפליקציות במשאב ShoppingProduct. אין תמיכה בסטטוס של הערות ובבעיות שקשורות להערות.
סינון מוצרים לפי תגים	תכונה חדשה	הוספנו סינון באמצעות ביטויים לוגיים של קבוצות באופן דינמי: נוספו סוגי הקריטריונים RETAIL_FILTER_BUNDLE ו-RETAIL_FILTER. נוסף סוג קבוצה משותפת RETAIL_FILTER. הוספתי את השדה retail_filter_bundle אל AdGroupCriterion. הוספתי את השדה retail_filter אל SharedCriterion. הוספת את RETAIL אל ListingGroupFilterListingSource. המאפיין RetailFilter נוסף אל AssetGroupListingGroupFilter. הוספנו שגיאות אימות חדשות שקשורות ל-CriterionError ול-AssetGroupListingGroupFilterError. התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים.

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

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

גרסה 23.3 ‏ (24.06.2026)

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

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

גרסה 23.2‏ (25.03.2026)

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

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

גרסה 23.1‏ (25.02.2026)

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

תכונות ועדכונים	סוג	תיאור
ניהול חשבון
advertising_partner_properties.allowed_domain	שדה חדש	נוסף למשאבים של ProductLinkInvitation ושל ProductLink. השותף לקניית שטחי פרסום יוכל לפרסם רק בדומיין הזה.
Customer.contains_eu_political_advertising	שדה חדש	הפונקציה מאחזרת את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם החשבון מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזירה EuPoliticalAdvertisingStatus.
קמפיינים
Campaign.text_guidelines	שדה חדש	הוספנו תמיכה בהנחיות לניסוח טקסטים, שאפשר להשתמש בהן בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש כדי לשלוט באופן פרוגרמטי בנכסי טקסט שנוצרו על ידי AI. ב-text_guidelines, אפשר להגדיר את term_exclusions ואת messaging_restrictions.
CampaignPrimaryStatusReason	ערכי enum חדשים	הוספנו את CAMPAIGN_NOT_BOOKED,‏ BOOKING_HOLD_EXPIRING,‏ BOOKING_HOLD_EXPIRED ו-BOOKING_CANCELLED כדי לספק סיבות עיקריות לסטטוס של קמפיינים עם שיטת הבידינג FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	שדות חדשים	נוספה תמיכה בגילוי נאות עצמאי לגבי הקטגוריות של מודעות בהזמנה ובפרטי הזמנה לקריאה בלבד.
Campaign.missing_eu_political_advertising_declaration	שדה חדש	אפשר להשתמש ב-API כדי לשלוח שאילתות ולסנן קמפיינים שחסרות בהם הצהרות לגבי פרסום פוליטי שמטורגט לאיחוד האירופי.
המרות
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	ערך חדש של טיפוס בן מנייה (enum)	תומך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ.
כללי
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	ערך enum חדש / שגיאה	השגיאה הזו מוחזרת כשמנסים לטרגט רק את הקטגוריה 'לא ידוע' במאפיינים הדמוגרפיים.
תמריצים
IncentiveErrorEnum	ערכי enum חדשים / שגיאות	נוספו שני קודי שגיאה חדשים: MAX_INCENTIVES_REDEEMED ו-ACCOUNT_TOO_OLD. יכול להיות שהשגיאות האלה יוחזרו לבקשות שיישלחו ב-11 במרץ 2026 או אחרי התאריך הזה.
תכנון
GenerateBenchmarksMetrics	תכונה חדשה	הוספנו תמיכה בפירוטים לפי תאריך באמצעות BreakdownDefinition.
ReachPlanService.GenerateReachForecast	ערך חדש של טיפוס בן מנייה (enum)	הוספנו את GOOGLE_DISPLAY_NETWORK כפלטפורמה שאפשר לטרגט בקמפיינים ליצירת ביקוש עם יעד המרות מקסימלי.
GenerateTrendingInsights	שדות חדשים	הוספנו מידע על קו מגמה היסטורי בTrendInsightDataPoint אל TrendInsights כשמחפשים לפי נושא.
דוחות
מדדים של תדירות החשיפה למשתמשים ייחודיים	שדות חדשים	הוספנו מדדים חדשים שמדווחים על מספר המשתמשים שראו את המודעה שלכם לפחות פעמיים, שלוש, ארבע, חמש או עשר פעמים: unique_users_two_plus,‏ unique_users_three_plus,‏ unique_users_four_plus,‏ unique_users_five_plus ו-unique_users_ten_plus.
SearchTermMatchSource	ערך חדש של טיפוס בן מנייה (enum)	הוספנו את VERTICAL_ADS_DATA_FEED כדי לתמוך בפידים של נתוני מודעות אנכיות, כמו טירגוט ישויות של מודעות נסיעות.
YouTubeVideoUpload
YouTubeVideoUpload	שירות או משאב חדשים	הוספנו את השירות YouTubeVideoUpload כדי לתמוך בהעלאה ובניהול של סרטונים ב-YouTube, ואת המשאב YouTubeVideoUpload כדי לתמוך באחזור של סטטוס ההעלאה ומטא-נתונים. התכונה הזו נתמכת רק ב-REST ובספריית הלקוח של Python.

גרסה 23 ‏ (28.01.2026)

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

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

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

מצב התחלתי	המצב החדש	סוג השינוי	הדרכה בנושא הטמעה
מודעות
הותר שיתוף מודעות	AdGroupAdError.AD_SHARING_NOT_ALLOWED	שינוי באופן הפעולה	אסור יותר לשתף מודעות בין כמה קבוצות של מודעות. בקשות לשתף מודעות יחזירו שגיאת AD_SHARING_NOT_ALLOWED.
תמיכה ב-CallAd וב-CallAdInfo	ללא	הסרה	הוסרה התמיכה במודעות לשיחות. אפשר לעיין במאמר במרכז העזרה בנושא מודעות לשיחות.
קמפיינים
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	שינוי שם / החלפה	אפשר להשתמש בשדות החדשים של תאריך ושעה כדי לציין רכיבי זמן לקמפיינים. השדות המקוריים שמכילים רק תאריכים מוסרים.
יצירת ביקוש
DemandGenMultiAssetAdInfo.lead_form_only	ללא	הסרה	השדה lead_form_only הוסר. מעדכנים את ההפניות בקוד.
דוחות
מדדים נצברים של תוויות לציון רמת ביצועים של נכסים וספירה	ללא	הסרה	הוסרו מדדים של תווית לציון רמת ביצועים של נכסים מצטברים. הספירה (enum) של תוויות לציון רמת ביצועים לא מוחזרת יותר עבור קמפיינים לרשת החיפוש ולרשת המדיה.

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

תכונות ועדכונים	סוג	תיאור
מודעות
AdFormatType	ערכי enum חדשים	נוספו סוגי פורמטים חדשים: TEXT,‏ VERTICAL_ADS_BOOKING_LINK ו-VERTICAL_ADS_PROMOTION.
נכסים
צפייה אחת (asset_group)	שדות חדשים	הוספנו את המדדים הבאים: metrics.engagements,‏ metrics.engagement_rate ו-metrics.average_cpe.
צפייה אחת (asset_group_asset)	שדות חדשים	הוספנו את המדדים הבאים: metrics.average_cpe,‏ metrics.average_cpm,‏ metrics.trueview_average_cpv,‏ metrics.video_trueview_view_rate,‏ metrics.video_trueview_views ו-metrics.interaction_event_types.
Asset.orientation	שדה חדש	הוספנו שדה של כיוון לקריאה בלבד לנכסי תמונה ווידאו.
CampaignAsset	תכונה חדשה	הוספנו תמיכה באחזור נכסים של קמפיין עם הערכים HEADLINE ו-DESCRIPTION של field_type.
ServedAssetFieldType	ערכי enum חדשים	נוספו HEADLINE_AS_SITELINK_POSITION_ONE,‏ HEADLINE_AS_SITELINK_POSITION_TWO,‏ DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE ו-DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO לנכסים שמוצגים כתוספי Sitelink.
BusinessMessageAsset	תכונות חדשות / תמיכה	נכסים מעודכנים של שליחת הודעות לעסק: הוספנו תמיכה ב-Facebook Messenger וב-Zalo כספקים. הוספת את FACEBOOK_MESSENGER ואת ZALO אל BusinessMessageProvider. נוספו השדות facebook_messenger_info ו-zalo_info. הוספת את CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS אל AssetError.
חיוב
InvoiceService.ListInvoices	אפשרויות חדשות	מעכשיו אפשר להגדיר את include_granular_level_invoice_details ב-ListInvoicesRequest כדי לקבל פרטים מפורטים יותר ב-Invoice, כולל פירוט עלויות ברמת הקמפיין, עלויות רגולטוריות מפורטות ומידע על התאמות.
RegulatoryFeeType UnitOfMeasure	סוגי enum חדשים	נוספו סוגי enum של עזרים לעמלות בהתאם לחוק וליחידות מידה.
קמפיינים
CampaignError	ערכי enum חדשים / שגיאות	נוספו קודי השגיאה DURATION_TOO_LONG_FOR_TOTAL_BUDGET ו-END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
המרות
ConversionActionCategory	ערך חדש של טיפוס בן מנייה (enum)	נוספה התכונה YOUTUBE_FOLLOW_ON_VIEWS כדי לתמוך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ.
יצירת ביקוש
DemandGenVideoResponsiveAdInfo.companion_banner	שדה חדש	הוספנו תמיכה במודעות באנר נלוות במודעות וידאו רספונסיביות ליצירת ביקוש.
תמריצים
הוספנו תמיכה בבחירת תמריצים (CYO): נוספה השיטה FetchIncentive לאחזור תמריצים מותאמים אישית שזמינים למשתמש. הוספנו את השיטה ApplyIncentive להחלת תמריץ נבחר על חשבון לקוח. הוספנו את המשאב AppliedIncentive (שאפשר ליצור לגביו שאילתה באמצעות Search ו-SearchStream) כדי לספק פרטים על מימוש. נוספו קודי שגיאה חדשים ב-IncentiveError וב-AuthenticationError.INVALID_EMAIL_ADDRESS. כדי לאפשר טיפול מפורט יותר בכשלים באמצעות תוכנות, נוסיף קודי שגיאה נוספים ל-IncentivesService בגרסאות עתידיות. מומלץ לעקוב אחרי ההודעות הקרובות והערות הגרסה לגבי קודי השגיאה החדשים האלה, כדי לוודא שהאפליקציות שלכם יכולות לטפל במצבי הכשל החדשים האלה.
תכנון
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	ערך חדש של טיפוס בן מנייה (enum)	מאפשר ליצור קהלים באמצעות אירועים משמעותיים בחיים ב-GenerateAudienceCompositionInsights, ב-GenerateSuggestedTargetingInsights, ב-GenerateInsightsFinderReport וב-GenerateCreatorInsights. אין תמיכה באירועים משמעותיים בחיים בשיטות אחרות של AudienceInsightsService, כמו AudienceInsightsService.GenerateAudienceOverlap ו-AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	שדות או אפשרויות חדשים	התשובה כוללת עכשיו פלטפורמות לתמיכה בהצעות לשיעור המרה על סמך אמצעי בקרה בפלטפורמה (למשל, Gmail, ‏ Shorts). האפשרות הזו נתמכת רק בקמפיינים ליצירת ביקוש.
LanguageDistribution	שדה חדש / סוג	נוסף ל-YouTubeChannelInsights כדי לספק פרטים על התפלגות השפות בתוכן של ערוץ YouTube.
BenchmarksService	שירות חדש	השוואה בין נתוני הפרסום ב-YouTube לבין נתונים להשוואה לשוק.
AudienceInsightsService.GenerateAudienceDefinition	שיטה חדשה	תרגום של תיאור חופשי של קהל יעד למאפייני קהל תואמים באמצעות AI גנרטיבי.
YouTubeChannelInsights.relevance_score	שדה חדש	המדד מעריך את הרלוונטיות של יוצר לנושא מסוים, לפי משקל הצפיות.
TrendInsightMetrics.trend_change_percent	שדה חדש	מייצג את השינוי באחוזים בערך של מגמה לאורך תקופת ההשוואה.
המלצות
GenerateRecommendationsRequest	שדה חדש	is_new_customer נוסף. אם מגדירים את הערך true להמלצות CAMPAIGN_BUDGET, המערכת משתמשת במודל שעבר אופטימיזציה ללקוחות חדשים (מומלץ רק ללקוחות שאין להם קמפיינים).
דוחות
AdGroupAdAssetView	תמיכה בתכונות או במדדים חדשים	הגרסה החדשה תומכת עכשיו במדדי חשיפות, ביצועים והמרות ב-RESPONSIVE_DISPLAY_AD.
פלח אחד (ad_sub_network_type)	פלח חדש	הדוח מספק פירוט מדויק של הביצועים ברשת מודעות. האפשרות הזו זמינה בשלב הראשוני לקמפיינים ליצירת ביקוש ב-YouTube (מודעות וידאו In-stream, מודעות בגוף הפיד, מודעות ב-Shorts). חובה לבחור את האפשרות הזו יחד עם ad_network_type.
דיווח בקמפיינים למיקסום הביצועים	תכונה חדשה	פירוט של סוג רשת המודעות שהופעל בקמפיינים למיקסום הביצועים.
UserLocationView GeographicView	תמיכה בפלחים חדשים	מדדי תמיכה שמפולחים לפי תאריך ההמרה: conversions_by_conversion_date,‏ all_conversions_by_conversion_date,‏ conversions_value_by_conversion_date,‏ all_conversions_value_by_conversion_date,‏ value_per_conversions_by_conversion_date,‏ value_per_all_conversions_by_conversion_date,‏ cross_device_conversions_by_conversion_date ו-cross_device_conversions_value_by_conversion_date.
פלחי קהל של מודעות בפורמט אנכי	פלחים חדשים	הוספנו את הפלחים הבאים: vertical_ads_event_participant_display_names,‏ vertical_ads_hotel_class,‏ vertical_ads_listing,‏ vertical_ads_listing_brand,‏ vertical_ads_listing_city,‏ vertical_ads_listing_country,‏ vertical_ads_listing_region,‏ vertical_ads_partner_account ו-vertical_ads_vertical.
PerStoreView MatchedLocationInterestView	כלים חדשים לדיווח	נוספו PerStoreView כדי לשלוח שאילתה לגבי פרטי מיקום של חנות, ו-MatchedLocationInterestView (לקמפיינים למיקסום ביצועים) כדי לספק מדדי ביצועים לפי מיקומים גיאוגרפיים שהמשתמשים התעניינו בהם.
קניות
ShoppingPerformanceView	תמיכה במדדים חדשים	מעכשיו יש תמיכה במדדים הבאים שמפולחים לפי תאריך ההמרה: conversions_by_conversion_date,‏ all_conversions_by_conversion_date,‏ conversions_value_by_conversion_date,‏ value_per_conversions_by_conversion_date ו-value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	תמיכה במדדים חדשים	נוספה תמיכה ב: search_budget_lost_impression_share,‏ search_rank_lost_impression_share,‏ search_budget_lost_absolute_top_impression_share ו-search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	שדה חדש	נוסף אל ShoppingProduct.
מודעות בפורמט אנכי
AdGroup.vertical_ads_format_setting	שדה חדש	ההגדרה הזו מאפשרת לכם לשלוט בפורמטים של המודעות שיוצגו בקמפיינים לרשת החיפוש באמצעות פידים של נתוני נסיעות.
AdGroupCriterion SharedCriterion	שדות או קריטריונים חדשים	הוספנו את סוג הקריטריון vertical_ads_item_group_rule_list אל AdGroupCriterion ואת vertical_ads_item_group_rule אל SharedCriterion כדי לאפשר טירגוט של קבוצות פריטים בקמפיינים לרשת החיפוש באמצעות פידים של נתוני נסיעות.
שילוב של פיד נתונים של מודעות בפורמט אנכי	תכונה חדשה	מעכשיו אפשר לקשר פיד נתונים של מודעות בענף מסוים לקמפיין לרשת החיפוש שמופעל בו AI למיקסום ביצועים, כדי להציג מודעות לקידום נכסים ומודעות עם קישור להזמנה לצד מודעות טקסט. אפשר לשלוט בפורמטים באמצעות vertical_ads_format_setting ולהגדיר כללים באמצעות vertical_ads_item_group_rule. פילוח הדיווח לפי AdFormatType ומימדים של פיד נתונים של מודעות אנכיות.
סרטונים
AdVideoAssetInfo.ad_video_asset_feature_control	שדה חדש	נוספו אפשרויות לשליטה בתכונות של נכסי וידאו למודעות.
CampaignCriterionError	ערך enum חדש / שגיאה	נוסף קוד השגיאה INVALID_VIDEO_LINEUP_ID.
מדדים של שמיעת מודעות ב-YouTube	מדדים חדשים	הוספנו מדדים של שמיעת מודעות אודיו ב-YouTube, שמאפשרים לדעת אם המודעה הייתה נשמעת וכמה חשיפות אפשר היה למדוד.

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

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

גרסה 22.2‏ (24.06.2026)

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

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

גרסה 22.1 (25.02.2026)

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

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

גרסה 22 (15.10.2025)

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

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

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

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

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

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

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

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

גרסה 21.2‏ (24.06.2026)

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

תכונות ועדכונים	סוג	תיאור
כללי
קבלת אישור ממספר משתמשים	תכונות חדשות	בטא: התכונה הזו נמצאת כרגע בגרסת בטא ועשויה להשתנות בגרסאות עתידיות. הוספנו תמיכה בבדיקות של קבלת אישור ממספר משתמשים (MPA): נוספו המשאב MultiPartyAuthReview וMultiPartyAuthReviewService התואם. נוסף ה-enum‏ MultiPartyAuthReviewStatus כדי לעקוב אחרי סטטוס הביקורת. נוספה אפשרות CustomerUserAccess.pending_multi_party_auth_review לקישור לביקורת בהמתנה. נוספו MutateCustomerUserAccessResult.multi_party_auth_review ו-MutateCustomerUserAccessInvitationResult.multi_party_auth_review כדי להחזיר את שם משאב הביקורת המשויך. נוספה MultiPartyAuthReviewError לשגיאות אימות.

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

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

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