כאן אפשר למצוא רשימה עדכנית של תכונות שיוצאות משימוש או מתוכננות לצאת משימוש.
גרסאות ראשיות ומשניות של v25
גרסה 25 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לגרום לבעיות.
גרסה 25.2 (23.09.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 25.2 של Google Ads API. גרסאות משניות כמו v25.2 לא מכילות שינויים שעלולים לשבור את התאימות לאחור.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
אפשרויות של כתובות URL עבור AssetGroup |
שדות חדשים | הוספנו תמיכה באפשרויות של כתובות URL ב-AssetGroup, כדי לאפשר למפרסמים לציין תבניות מעקב, פרמטרים מותאמים אישית וסיומות של כתובות 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) לשיפור מחזור החיים של הלקוחות:
|
SmartCampaignSettingService.GeneratePMaxDraftCampaign |
תכונה חדשה | הוספנו את SmartCampaignSettingService.GeneratePMaxDraftCampaign כדי לתמוך ביצירת טיוטה של קמפיין למיקסום הביצועים מקמפיין חכם קיים, עם סטטוס התחלתי של CampaignStatus.PAUSED וסטטוס יצירה של CampaignCreationStatus.INCOMPLETE (ראו המרת קמפיינים חכמים לקמפיינים למיקסום הביצועים):
|
| המרות | ||
| הופעות מודעה ב-Firebase | סוגים וקטגוריות חדשים של פעולות המרה | הוספנו את סוגי פעולות ההמרה FIREBASE_ANDROID_APP_AD_IMPRESSION ו-FIREBASE_IOS_APP_AD_IMPRESSION, כך שתוכלו לאחזר ולשנות את פעולות ההמרה האלה. בנוסף, חשפנו את הקטגוריה IN_APP_AD_REVENUE ב-ConversionActionCategory כדי לעקוב אחרי הכנסות ממונטיזציה של מודעות באפליקציה. |
| כללי | ||
BusinessProfileLocationSyncError |
enum ושגיאות חדשים | הוספנו סיבות לשגיאות בסנכרון של מיקומים בפרופיל העסק כשמסנכרנים מיקומים בLOCATION_SYNC-typed AssetSet. במקום להחזיר שגיאה כללית UNKNOWN, ה-API מחזיר עכשיו BusinessProfileLocationSyncError עם סיבות ספציפיות (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED ו-NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT). |
| תכנון | ||
מדדי אחוזון BenchmarksService.GenerateBenchmarksMetrics |
תכונות חדשות |
עדכנו את המאפיין
נוספה תמיכה במדדי אחוזון לתאריכים של רבעונים פתוחים ב- נוספה שגיאה מותאמת אישית |
| כינויים לערוצי YouTube בתובנות לגבי יוצרים | תכונה חדשה | עדכנו את ContentCreatorInsightsService.GenerateCreatorInsights כדי לתמוך בחיפוש לפי כינויים של ערוצי YouTube באמצעות YouTubeChannels.youtube_channel_handles (כינויים תקינים של ערוצים צריכים להתחיל ב-@, כמו @channel_handle). האפשרות הזו דומה לחיפוש לפי מזהים של ערוצי YouTube. התשובה מכילה תובנות לגבי היוצרים המבוקשים ב-YouTube. |
| המלצות | ||
| המלצות לגבי הצעות מחיר של עלות להמרה והחזר על הוצאות הפרסום | המלצות חדשות | הוספנו את Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) ואת Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), יחד עם ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low ו-ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, כדי לתמוך בהעלאת יעד העלות להמרה או בהורדת יעד ההחזר על הוצאות הפרסום, אם הצעות המחיר נמוכות מדי בשביל שהקמפיינים לרשת החיפוש ייכנסו למכרזים:
|
| דוחות | ||
| פלחי מאפיינים של תוכנית נסיעה במלון | פלחים חדשים | הוספנו את פלחים הבאים של מאפייני מסלול נסיעה והזמנות של מלונות ל-Segments (אפשר לבחור אותם באמצעות campaign, ad_group ו-customer):
|
| מדדים של מודעות בפורמט אנכי | מדדים חדשים | הוספנו את המדדים הבאים לדיווח על מודעות בענף התיירות והאירוח ב-Metrics (אפשר לבחור אותם באמצעות campaign, ad_group ו-customer):
|
| פלחי קהל של מודעות בפורמט אנכי | פלחים חדשים | הוספנו את הפלחים הבאים לדיווח על מודעות בענף התיירות והאירוח ב-Segments (אפשר לבחור אותם באמצעות campaign, ad_group ו-customer):
|
גרסה 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 למיקסום ביצועים. |
| המרות | ||
| מדידות של התחזקות המותג | תכונות חדשות | הוספנו תמיכה במדידת התחזקות המותג עם העדכונים הבאים:
|
| מדידות של עלייה בהמרות | תכונות חדשות | הוספנו תמיכה במדידת עלייה בהמרות עם העדכונים הבאים:
|
LiftMeasurementFlight |
משאב חדש | משאב חדש לקריאה בלבד שמייצג את פרטי הטיסה בהגדרה למדידת שיפור, כולל תאריכי ההתחלה והסיום של הטיסה שנמדדה (start_date ו-end_date). |
| כללי | ||
SmartCampaignError |
ערכי enum חדשים | נוספו קודי שגיאה ספציפיים חדשים למגבלות על יצירת נכסים בקמפיינים למיקסום הביצועים: |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
ערך enum חדש / שגיאה | השגיאה מוחזרת כשפרויקט בענן של Google עם רמת גישה TEST מנסה לשלוח בקשות לחשבון שאינו חשבון בדיקה. |
| תכנון | ||
| תובנות לגבי הסנטימנט כלפי המותג | תכונות חדשות | הוספנו תמיכה בתובנות לגבי סנטימנט המותג ב-ContentCreatorInsightsService:
|
שיפורים של BenchmarksService |
תכונות חדשות | הוספנו תמיכה בקטגוריות כמסננים להגדרת היקף הניתוח של השוואות לשוק. בנוסף, יש תמיכה במדדים נוספים שחשובים לעסק:
|
| טירגוט לפי סטטוס הורה | תכונה חדשה | הוספנו תמיכה בטירגוט לפי סטטוס הורה בתכנון היקף החשיפה. הוספנו את השדה החדש parental_statuses אל Targeting בשביל השירות ReachPlanService.GenerateReachForecast, ואת השדה parental_statuses אל PlannableTargeting בשביל השירות ReachPlanService.ListPlannableProducts. |
| המלצות | ||
Recommendation.campaign_specific_app_goal_recommendation |
המלצה חדשה | מציעה להוסיף יעד המרה ספציפי לקמפיין באפליקציה. המשאב החדש EffectiveAutomaticGoal משמש לייצוג היעדים הנוכחיים בהמלצה הזו. |
| דוחות | ||
Metrics.original_conversion_value |
שדה חדש | מייצג את ערך ההמרה המקורי מהמרות שאפשר להגיש עליהן הצעות מחיר. זהו הערך המקורי של ההמרות לפני החלת התאמות של כללים לקביעת ערך, כמו כללים לקביעת ערך המרה או התאמה של יעדים שקשורים למחזור החיים של הלקוח. |
| נתונים סטטיסטיים על חברות במועדון לקוחות | תכונות חדשות | הוספנו תמיכה בפילוח נתונים סטטיסטיים לפי סטטוס המינוי של משתמש במועדון לקוחות, והוספנו את המאפיין הראשי 'חברות במועדון לקוחות' לכללים לקביעת ערכי המרות:
|
| טירגוט | ||
vertical_ads_item_bid |
סוג קריטריון חדש | נוסף סוג הקריטריון החדש vertical_ads_item_bid ל-AdGroupCriterion.criterion. |
גרסה 25 (22.07.2026)
התכונות החדשות, העדכונים והשינויים שעלולים לשבור תאימות שפורטו בהמשך נוספו לגרסה 25 של Google Ads API, שהיא גרסה ראשית.
הנחיות מפורטות זמינות במאמר בנושא שדרוג לגרסה העדכנית.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| קמפיינים | |||
שדות עצמאיים additional_value ו-additional_high_lifetime_value ב-CustomerLifecycleOptimizationValueSettings |
חלק מהשדות value_adjustment ו-high_lifetime_value_adjustment oneof בהתאמה, לצד השדות החדשים value_multiplier ו-high_lifetime_value_multiplier |
שינוי מבני | צריך לעדכן את ההפניות לשדות האלה כי הם עכשיו חלק מ-oneofs. |
משאבים מדור קודם של CustomerLifecycleGoal ושל CampaignLifecycleGoal, השירותים התואמים שלהם CustomerLifecycleGoalService וCampaignLifecycleGoalService, והגדרות/ספירות מדור קודם (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) |
ללא | הסרה | שימוש בסכימה המשופצת של היעדים המאוחדים:
|
| כללי | |||
שדות enum בתוך שדות בהודעות בקשה ותגובה של Incentive Service:
|
שדות enum עצמאיים: | שינוי שם / הסרה | משתמשים בשדות החדשים של 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. |
| קמפיינים | ||
| היעד 'שימור חברים במועדון הלקוחות' | תכונות או הגדרות חדשות | הוספנו תמיכה ביעד 'שימור נאמנות', שמאפשר למפרסמים לבצע אופטימיזציה של קמפיינים כדי לשמר חברים במועדון הלקוחות.
|
| היעד 'צירוף לקוחות חדשים' | תכונות או הגדרות חדשות | עדכנו את התמיכה ביעד 'צירוף לקוחות חדשים' ב-Google Ads API כדי לשקף את סכימת היעדים המאוחדת המשופצת:
|
| המרות | ||
| שיוך המרות ב-YouTube לצד שלישי | שדות חדשים | הוספנו תמיכה באימות של שיוך המרות ב-YouTube באמצעות שותפי צד שלישי:
|
| כללי | ||
ContactDetails.phone_number_extension |
שדה חדש | נוסף למשאב LocalServicesLead. |
IncentiveError |
ערכי enum חדשים ושגיאות | נוספו קודי שגיאה ספציפיים חדשים לבעיות במימוש תמריצים:
|
| תכנון | ||
| פרטים על ערוץ YouTube בתובנות לגבי מגמות | שדות חדשים | הוספנו תמיכה בפרטים נוספים של ערוצי YouTube של סרטונים קשורים כשמחפשים תובנות לגבי נושאים פופולריים. הוספנו את השדות החדשים channel_id, channel_name ו-channel_url אל YouTubeVideoAttributeMetadata. |
YouTubeChannelInsights.data_sharing_consent_given |
שדה חדש | נוסף אל YouTubeChannelInsights. זה נכון אם יוצר הסכים לשתף נתונים שלא גלויים לכולם. אם כן, השדות הבאים יאוכלסו:
|
| דוחות | ||
ad_sub_format_type |
פלח חדש | פירוט של מודעות וידאו In-stream ב-YouTube שלא ניתן לדלג עליהן, לפי משך:
ad_format_type. אפשר לבחור אותו באמצעות AdGroup, AdGroupAd, Campaign, Customer, Video וגם VideoEnhancement.
|
| מדדים ספציפיים לרשתות חברתיות שקשורים לסרטונים | שדות או מדדים חדשים | הוספנו מדדים ספציפיים לרשתות חברתיות לגבי סרטונים, כדי לעזור למפרסמים לעקוב אחרי האינטראקציה של המשתמשים (תגובות, לייקים ושיתופים) עם מודעות ב-Shorts ב-YouTube:
הם זמינים ב-AdGroup, ב-AdGroupAd, ב-Asset, ב-Campaign, ב-Customer וב-Video.
|
גרסאות ראשיות ומשניות של v24
גרסה 24 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור את התאימות לאחור.
גרסה 24.2 (24.06.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 24.2 של Google Ads API. גרסאות משניות כמו v24.2 לא מכילות שינויים שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT |
ערך enum חדש | יוצר מידע טקסט מדף הנחיתה שיוצג בחלונית האינטראקציות עבור מופעים של DemandGenVideoResponsiveAd (שמופעלים כברירת מחדל החל מגרסת ה-API הזו). |
| נכסים | ||
AssetGroup.google_local_services_info |
שדה חדש | הוספנו תמיכה בפרטים של מודעות לקידום עסקים מקומיים (מזהה קטגוריה ויתרונות מרכזיים) בקמפיינים למיקסום הביצועים. |
AssetGroupSignal.local_services_id |
שדה חדש | הוספנו תמיכה באותות של מזהי שירותים של מודעות "Google לבעלי מקצוע" בקמפיינים למיקסום הביצועים. |
AssetGroupSignal.vertical_ads_item_group_rule_list |
שדה חדש | הוספנו תמיכה בכללים של קבוצות פריטים של מודעות אנכיות לבחירת פריטים מפידים אנכיים שמצורפים לקמפיינים למיקסום הביצועים. התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים. |
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN |
ערך enum חדש / שגיאה | הערך הזה מוחזר כשמנסים להסיר את כל קבוצות הנכסים מקמפיין. |
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS |
ערך enum חדש / שגיאה | הערך הזה מוחזר כשמנסים להסיר את כל האותות מקבוצת נכסים. |
| קמפיינים | ||
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled |
שדות חדשים | תמיכה בזיהוי קמפיינים למיקסום ביצועים של Google בעלי מקצוע. |
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps |
שדה חדש | הוספנו את מפות Google לערוצים שאפשר לבחור לקבוצות של מודעות ליצירת ביקוש. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
ערך enum חדש / שגיאה | הערך הזה מוחזר כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של מודעות "Google לבעלי מקצוע". |
SmartCampaignErrorEnum.CREATION_FAILED |
ערך enum חדש / שגיאה | השגיאה הזו מוחזרת כשמנסים ליצור קמפיינים חכמים חדשים. |
| המרות | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
ערכי enum חדשים | ההמרה הזו מתרחשת כשמשתמש לוחץ על מודעה של ספק שירותים מקומיים ומתקשר למפרסם, שולח לו הודעה או מזמין ממנו שירות. |
| ניסויים | ||
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION |
ערכי enum חדשים | הוספנו תמיכה בסוגים חדשים של ExperimentType:
|
| כללי | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
שדות חדשים | כוללות הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו אוטומטית או סופקו על ידי המערכת).
התכונה הזו הועברה לאחור (backported) לגרסאות 23 ו-22.
כדי לעזור לכם לתכנן את עבודת השילוב הקרובה שלכם בגרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות אישור המפרסם בגרסה 22 ואילך. הממשק מוצג בגרסאות האלה, אבל אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: "The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או "Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כדי שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק. |
| אישור על ידי גורמים מרובים | תכונות חדשות |
הוספנו תמיכה בביקורות של אישורים ממספר משתמשים (MPA):
התכונה הזו הועברה לגרסאות קודמות: v23.3, v22.2 ו-v21.2. |
IncentiveService.FetchIncentive |
שינוי התנהגותי | אם בבקשה מצוינת כתובת אימייל לא תקינה, השיטה מחזירה עכשיו את תמריצי ברירת המחדל במקום להחזיר שגיאה מסוג AuthenticationError.INVALID_EMAIL_ADDRESS. |
| תכנון | ||
GenerateCreatorInsightsRequest.search_topics |
שדה חדש | נוסף לשירות ContentCreatorInsightsService.GenerateCreatorInsights. האפשרות הזו מחפשת יוצרים שמדברים על נושא במדינה שצוינה בcountry_locations (אפשר לחפש רק במדינה אחת). |
CREATOR_TOPIC_INSIGHTS |
ערך enum חדש | נוסף לInsightsKnowledgeGraphEntityCapabilities כדי לציין ישויות לחיפוש יוצרים שמדברים על נושא מסוים. צריך להשתמש בישויות האלה בשדה search_topics. הנתונים אוחזרו באמצעות AudienceInsightsService.ListAudienceInsightsAttributes. |
KnowledgeGraphEntitySearchOptions |
סוג חדש / אפשרויות חדשות | מכיל אפשרויות חיפוש נוספות לנושאים ב-ListAudienceInsightsAttributes, כולל אפשרויות לאחזור כל הנושאים שנתמכים כמאפייני יוצרים, וסינון לפי יכולות. |
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data |
שדות חדשים | נתונים אופציונליים לשיטות ContentCreatorInsightsService. אם תספקו את השדה הזה, המערכת תאכלס מיקומים נוספים או מאפיינים של יוצרים בתגובה. |
local_creator_insights related_local_creators |
שדות חדשים | המאפיין מאוכלס כש-supplemental_data מכיל את הערך LOCAL_CREATOR_DATA enum. המסנן מציג יוצרים מקומיים שהצופים צפו בהם או שהם נמצאים במדינה שנבחרה, ושנתנו הסכמה לשיתוף נתוני המיקום שלהם. |
GenerateTrendingInsightsRequest.sub_country_locations |
שדה חדש | הוספנו את האפשרות ContentCreatorInsightsService.GenerateTrendingInsights, שמאפשרת לחפש תובנות לגבי מגמות לפי מיקום במדינה ומיקומים משניים במדינה. |
| דוחות | ||
PerformanceMaxPlacementView |
תוסף פלחים | הפילוח בוצע על ידי ad_network_type. |
| קניות | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
שדה חדש | אם הערך הוא True, המערכת מתעלמת מהחרגות של מותגים במודעות שופינג. האפשרות הזו נתמכת רק בקמפיינים של שופינג. |
| טירגוט | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
ערך enum חדש / שגיאה | הערך הזה מוחזר כשמנסים לטרגט שפה שאסור לטרגט. |
| סרטונים | ||
DataLink.youtube_link_metadata |
שדה חדש | מכיל את התג brand_channel_id כדי לציין את המזהה של ערוץ המותג המקושר ב-YouTube. |
גרסה 24.1 (13.05.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 24.1 של Google Ads API. גרסאות משניות כמו v24.1 לא מכילות שינויים שעלולים לשבור את הקוד.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
DemandGenMultiAssetAdInfo.classic_display_images |
שדה חדש | תמונות מותאמות אישית לרשת המדיה שהועלו ומוצגות בלי שנדרשים נכסים רספונסיביים נוספים. |
| ניסויים | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
ערכי enum חדשים | הוספנו תמיכה בסוגים חדשים של ExperimentType:
|
Experiment.video_experiment |
שדה חדש | תמיכה בהגדרת ניסויים קיימים של YOUTUBE_CUSTOM שכוללים קמפיינים של מודעות וידאו. |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
שדות חדשים | הוספנו שדות לתמיכה בבדיקת נכסים, בקבוצות נכסים ובהגדרות של קמפיינים למיקסום הביצועים בקבוצות ניסוי:
|
| כללי | ||
CustomerUserAccess.passkey_enabled |
שדה חדש | שדה לקריאה בלבד שמציין אם מפתח הגישה של המשתמש מופעל. |
| דוחות | ||
mobile_device_platform |
פלח חדש | מאפשרת לפלח את הדוחות לפי הפלטפורמה של מכשיר המשתמש (למשל, iOS או Android). |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
ערך enum חדש / שגיאה | הערך שמוחזר כשגרעיניות הזמן היומית, השעתית או השבועית המבוקשת לא נתמכת בטווח התאריכים של השאילתה (זמינה רק ל-37 החודשים האחרונים). |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
פלחים חדשים | פלחי קהל חדשים לשימוש במודעות לפי קטגוריות. |
user_rating, venue, event_participant_display_name |
קריטריוני סינון חדשים | סינון נתמך ב-VerticalAdsItemGroupRuleInfo עבור המשאב SharedCriterion. |
| מדדים של ניסוי בקרה/ניסוי | שדות חדשים | נוספו ערכי בקרה (control_clicks וכו'), ערכי טיפול (clicks וכו'), אומדנים נקודתיים (clicks_point_estimate וכו'), שולי שגיאה (clicks_margin_of_error וכו') וערכי p (clicks_p_value וכו') בשבע קבוצות של מדדים מרכזיים (קליקים, חשיפות, עלות, המרות, עלות להמרה, ערך המרה, ערך המרה לכל עלות). |
| מדדים של שינוי אבסולוטי בהמרות | שדות חדשים | תמיכה בConversions הערכות של הפרש מוחלט באמצעות שדות של אומדן נקודתי, טווח שגיאה וערך p. |
| טירגוט | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
ערך enum חדש / שגיאה | הערך שמוחזר כשמנסים להחריג את כל קהלי היעד הדמוגרפיים. |
| סרטונים | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
ערך enum חדש | פרסמנו את ZEFR כשותפה לשילוב מוצרי Google למדידת הניראות. |
DataLink.youtube_video.channel_id |
שדה חדש | המאפיין חושף את מזהה ערוץ YouTube שמשויך לקישור הנתונים. |
גרסה 24 (22.04.2026)
בגרסה 24 של Google Ads API, שהיא גרסה ראשית, הוספנו את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות לאחור.
הנחיות מפורטות זמינות במאמר בנושא שדרוג לגרסה העדכנית.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| מודעות | |||
אופציונלי videos ו-logo_images ב-DemandGenVideoResponsiveAdInfo |
שדות חובה | שינוי באופן הפעולה | כשיוצרים או משנים מודעות וידאו רספונסיביות ליצירת ביקוש, צריך לספק את הערכים videos ו-logo_images. |
אופציונלי: videos, business_name ו-logo_images ב-VideoResponsiveAdInfo |
שדות חובה | שינוי באופן הפעולה | כשיוצרים או משנים מודעות וידאו רספונסיביות, צריך לספק את videos, business_name ו-logo_images. שימו לב: VideoResponsiveAdInfo ניתן לשינוי. |
| קמפיינים | |||
Campaign.video_brand_safety_suitability |
ללא | הסרה | הוסר אמצעי הבקרה להתאמה ברמת הקמפיין. התכונה 'התאמה למותג' עדיין זמינה ברמת הלקוח. במקום זאת, צריך להשתמש ב-Customer.video_brand_safety_suitability. |
| המרות | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
ללא | הסרה | הוסר קטגוריית המשתמשים 'הרשמות למועדון הלקוחות'. מסירים את ההפניות לקוד. |
| תכנון | |||
סוג InsightsAudienceAttributeGroup של topic_audience_combinations |
סוג common.InsightsAudienceAttributeGroup |
שינוי באופן הפעולה / שינוי סוג | צריך לעדכן את השילובים של ספריות לקוח עם הקלדה כדי להשתמש במרחבי השמות החדשים של המשאבים. |
השדה youtube_select_lineups ב-ReachPlanService.ListPlannableProducts |
ללא | הסרה | מעבר לשימוש בחבילות ערוצים מ-youtube_select_lineup_targeting. |
השדה is_brand_connect_creator ב-ContentCreatorInsightsService.GenerateCreatorInsights וב-GenerateTrendingInsights |
ללא | הסרה | במקום זאת, אפשר לבדוק אם ליוצר יש את האפשרות CREATOR_PARTNERSHIPS ב-partnership_opportunities. |
geo_modifiers ו-biddable_keywords ב-KeywordPlanIdeaService.GenerateKeywordForecastMetrics |
geo_target_constants וגם keywords |
שינוי שם / הסרה | הוחלף על ידי CampaignToForecast.geo_target_constants[] ו-ForecastAdGroup.keywords[]. |
שדות שיצאו משימוש בתחזית או בתכנון מילות מפתח ב-GenerateKeywordForecastMetrics |
ללא | הסרה | הסרנו את השדות והסוגים הבאים של תוכניות ותחזיות: מעדכנים את השילובים בהתאם. |
| דוחות | |||
פלח ad_sub_network_type בcampaign_budget |
ללא | הסרה | הוסר פלח ad_sub_network_type מהמשאב campaign_budget. |
פלח click_type בתצוגות של נכסים |
ללא | הסרה | הפלח הוסר מהתצוגות AdGroupAsset, CampaignAsset וCustomerAsset. |
| סרטונים | |||
כשל חלקי מותר בShareablePreviewService.GenerateShareablePreviews |
אין כשל חלקי | שינוי באופן הפעולה | אם אחד מהמזהים לא יעבור את האימות, הבקשות ייכשלו ותוצג שגיאה. |
ShareablePreviewError קודים מדור קודם:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
שינוי השם / שינוי באופן הפעולה | קודי השגיאה שמוחזרים לקבוצות נכסים משתנים כדי להתאים לשגיאות במודעות בקבוצות של מודעות. עדכון הלוגיקה של תפיסת אימות. |
תכונות ועדכונים (לא משבשים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
יכולת השינוי של VideoResponsiveAdInfo |
שינוי התנהגותי | אובייקטים של מידע על מודעות וידאו רספונסיביות ניתנים עכשיו לשינוי. |
| נכסים | ||
travel_feed_data ב-AssetSet |
שדה חדש | נוסף כדי לאחזר מאפיינים של נכסים בפיד נסיעות (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type). |
| קמפיינים | ||
Campaign.view_through_conversion_optimization_enabled |
שדה חדש | הגדרה שמאפשרת להפעיל אופטימיזציה להמרות בעקבות צפייה (VTC) (ברירת המחדל false) בקמפיינים ליצירת ביקוש ובקמפיינים לקידום אפליקציות. |
CampaignCriterion.gender |
תכונה חדשה | הפעלנו החרגות של מגדר בקמפיינים למיקסום הביצועים בכל הגרסאות של Google Ads API. |
| המרות | ||
| סוגי המרות של לידים | ערכי enum חדשים | נוספו סוגים חדשים של פעולות המרה ב-GA4/Firebase לרשימת הערכים המנוהלת ConversionActionType:
|
| כללי | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
ערך enum חדש / שגיאה | השגיאה הזו מוחזרת כשמנסים ליצור כמה רשימות זהות של קהלים דומים. |
| תכנון | ||
ProductCoreAttributes שדות בListPlannableProductsResponse |
שדות חדשים | הוספנו תיאור מוצר שניתן לתכנון, יעד שיווקי, מודל עלויות ושיטת רכישה אל ProductCoreAttributes בקטע ListPlannableProductsResponse. |
| דוחות | ||
CartDataSalesView |
משאב דיווח חדש | הדוחות מציגים פילוח של מדדי ההמרות לפי המוצר הספציפי שנמכר (מותג וכו') בנוסף למוצר שהלקוח לחץ עליו. |
| מדדים שלא ניתן להגיש עליהם הצעות מחיר | שדות חדשים | הוספנו מדדים שלא ניתן להגיש עליהם הצעות מחיר (מדדים שמציגים המרות שהקמפיינים לא עוברים אופטימיזציה כדי להשיג אותן) לכל המשאבים התואמים:
|
conversion_attribution_event_type |
פלח חדש | נוסף אל ShoppingPerformanceView. |
| קניות | ||
קמפיינים לקידום אפליקציות ב-ShoppingProduct |
תכונה חדשה | קמפיינים נתמכים לקידום אפליקציות במשאב ShoppingProduct. אין תמיכה בסטטוס של הערות ובבעיות שקשורות להערות. |
| סינון מוצרים לפי תגים | תכונה חדשה | הוספנו סינון באמצעות ביטויים לוגיים של קבוצות באופן דינמי:
|
גרסאות ראשיות ומשניות של v23
Google Ads API גרסה 23 כולל את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות.
גרסה 23.3 (24.06.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה v23.3 של Google Ads API. גרסאות משניות כמו v23.3 לא מכילות שינויים שעלולים לשבור את התאימות לאחור.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| כללי | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
שדות חדשים | כוללות הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו באופן אוטומטי או שסופקו על ידי המערכות של Google).
כדי לעזור לכם לתכנן את עבודת השילוב הקרובה שלכם בגרסה 25, אנחנו משיקים מוקדם את הממשק לשינוי שדות אישור המפרסם בגרסה 22 ואילך. הממשק מוצג בגרסאות האלה, אבל אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: "The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או "Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כדי שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק. |
| קבלת אישור ממספר משתמשים | תכונות חדשות |
הוספנו תמיכה בבדיקות של אישורים ממספר משתמשים (MPA):
|
גרסה 23.2 (25.03.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.2 של Google Ads API. גרסאות משניות כמו v23.2 לא מכילות שינויים שעלולים לשבור את התאימות.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
VideoEnhancement |
משאב חדש | המאפיין מכיל מידע ספציפי על מודעות וידאו ששופרו, כמו האם הן נוצרו על ידי Google או סופקו על ידי המפרסם. מידע נוסף על התכונה "שיפור סרטונים" |
AppTopCombinationView |
משאב חדש | משאב לקריאה בלבד שמספק תובנות לגבי שילובי נכסים שמניבים את הביצועים הכי טובים בקמפיינים לקידום אפליקציות. |
CustomerAsset |
תכונה חדשה | הוספנו תמיכה באחזור CustomerAsset עם 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 |
תכונות חדשות | הוספנו תמיכה בשילובים מותאמים אישית של ישויות, נושאים וקהלים באמצעות AND/OR. |
ReachPlanService.GenerateReachForecast |
ערכי enum חדשים | נוספו טווחי גילאים חדשים לטירגוט, כמו AGE_RANGE_21_44 או AGE_RANGE_21_49. |
youtube_select_lineup_targeting |
שדה חדש | התווסף אל ReachPlanService.ListPlannableProducts, שיחליף את youtube_select_lineups. שני השדות מאוכלסים כרגע. |
ReachPlanSurface |
ערך enum חדש | הוספנו את IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS כאפשרות של פלטפורמה. |
Forecast |
שדה חדש | נוסף clicks לקמפיינים ליצירת ביקוש עם אסטרטגיית הבידינג 'מקסימום קליקים' (CPC) ב-ReachPlanService.GenerateReachForecast. |
partnership_opportunities |
שדה חדש | נוסף אל ContentCreatorInsightsService.GenerateCreatorInsights ו-ContentCreatorInsightsService.GenerateTrendingInsights. |
| דוחות | ||
biddable_indirect_install_first_in_app_conversion_micros |
שדה חדש | נוספו למקורות המידע Campaign, Customer ו-AdGroup. |
| סרטונים | ||
ShareablePreviewService |
תכונה חדשה | הוספנו תמיכה בתצוגות מקדימות של YouTube בשידור חי. כדי להשתמש בה, צריך להגדיר את preview_type לערך YOUTUBE_LIVE_PREVIEW. הוספת את UNSUPPORTED_AD_TYPE ואת TOO_MANY_RESOURCES_IN_REQUEST אל ShareablePreviewError. האפשרות הזו נתמכת רק בחלק מסוגי המודעות. |
גרסה 23.1 (25.02.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.1 של Google Ads API. גרסאות משניות כמו v23.1 לא מכילות שינויים שעלולים לשבור את התאימות.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| ניהול חשבון | ||
advertising_partner_properties.allowed_domain |
שדה חדש | נוספו למשאבים של ProductLinkInvitation ושל ProductLink. השותף לקניית שטחי פרסום יוכל לפרסם רק בדומיין הזה. |
Customer.contains_eu_political_advertising |
שדה חדש | מאחזר את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם החשבון מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזיר את הערך EuPoliticalAdvertisingStatus. |
| קמפיינים | ||
Campaign.text_guidelines |
שדה חדש | הוספנו תמיכה בהנחיות לניסוח טקסטים, שאפשר להשתמש בהן בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש כדי לשלוט באופן פרוגרמטי בנכסי טקסט שנוצרו על ידי AI. במסגרת text_guidelines, אפשר להגדיר term_exclusions וmessaging_restrictions. |
CampaignPrimaryStatusReason |
ערכי enum חדשים | הוספנו את CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED ו-BOOKING_CANCELLED כדי לספק סיבות עיקריות לסטטוס של קמפיינים עם שיטת הבידינג FIXED_CPM. |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
שדות חדשים | נוספה תמיכה בגילוי נאות עצמאי לגבי הקטגוריות של מודעות בהזמנה ובפרטי הזמנה לקריאה בלבד. |
Campaign.missing_eu_political_advertising_declaration |
שדה חדש | אפשר להשתמש ב-API כדי לשלוח שאילתות ולסנן קמפיינים שחסרות בהם הצהרות לגבי מודעות פוליטיות שמטורגטות לאיחוד האירופי. |
| המרות | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
ערך enum חדש | תומך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ. |
| כללי | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
ערך enum חדש / שגיאה | הערך הזה מוחזר כשמנסים לטרגט רק את הקטגוריה 'לא ידוע' במאפיינים דמוגרפיים. |
| תמריצים | ||
IncentiveErrorEnum |
ערכי enum חדשים / שגיאות | נוספו שני קודי שגיאה חדשים: MAX_INCENTIVES_REDEEMED ו-ACCOUNT_TOO_OLD. יכול להיות שהשגיאות האלה יוחזרו לבקשות שיישלחו ב-11 במרץ 2026 או אחרי התאריך הזה. |
| תכנון | ||
GenerateBenchmarksMetrics |
תכונה חדשה | הוספנו תמיכה בפירוטים לפי תאריך באמצעות BreakdownDefinition. |
ReachPlanService.GenerateReachForecast |
ערך enum חדש | הוספנו את GOOGLE_DISPLAY_NETWORK כפלטפורמה שאפשר לטרגט בקמפיינים ליצירת ביקוש עם יעד המרות מקסימלי. |
GenerateTrendingInsights |
שדות חדשים | הוספנו מידע על קו מגמה היסטורי בTrendInsightDataPoint אל TrendInsights כשמחפשים לפי נושא. |
| דוחות | ||
| מדדים של תדירות למשתמשים ייחודיים | שדות חדשים | הוספנו מדדים חדשים שמדווחים על מספר המשתמשים שראו את המודעה שלכם לפחות פעמיים, שלוש, ארבע, חמש או עשר פעמים: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ו-unique_users_ten_plus. |
SearchTermMatchSource |
ערך enum חדש | הוספנו את VERTICAL_ADS_DATA_FEED כדי לתמוך בפידים של נתוני מודעות אנכיות, כמו טירגוט ישויות של מודעות נסיעות. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
שירות או משאב חדש | הוספנו את השירות YouTubeVideoUpload כדי לתמוך בהעלאה ובניהול של סרטונים ב-YouTube, ואת המשאב YouTubeVideoUpload כדי לתמוך באחזור של סטטוס ההעלאה ומטא-נתונים. התכונה הזו נתמכת רק ב-REST ובספריית הלקוח של Python. |
גרסה 23 (28.01.2026)
בגרסה 23 של Google Ads API, שהיא גרסה ראשית, הוספנו את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לשבור תאימות לאחור.
הנחיות מפורטות זמינות במאמר בנושא שדרוג לגרסה העדכנית.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| מודעות | |||
| השיתוף של המודעה מותר | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
שינוי באופן הפעולה | אסור יותר לשתף מודעות בין כמה קבוצות של מודעות. בקשות לשתף מודעות יחזירו שגיאת AD_SHARING_NOT_ALLOWED. |
תמיכה ב-CallAd וב-CallAdInfo |
ללא | הסרה | הסרנו את התמיכה במודעות לשיחות. מידע נוסף זמין במאמר במרכז העזרה בנושא מודעות עם קריאה לפעולה. |
| קמפיינים | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
שינוי שם / החלפה | משתמשים בשדות החדשים של תאריך ושעה כדי לציין רכיבי זמן לקמפיינים. השדות המקוריים שמכילים רק תאריך מוסרים. |
| יצירת ביקוש | |||
DemandGenMultiAssetAdInfo.lead_form_only |
ללא | הסרה | השדה lead_form_only הוסר. מעדכנים את ההפניות בקוד. |
| דוחות | |||
| מדדים וספירה של תוויות לציון רמת ביצועים של נכסים מצטברים | ללא | הסרה | הוסרו מדדים של תווית לציון רמת ביצועים של נכסים מצטברים. הספירה של תוויות לציון רמת ביצועים לא מוחזרת יותר עבור קמפיינים לרשת החיפוש וקמפיינים לרשת המדיה. |
תכונות ועדכונים (לא משבשים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
AdFormatType |
ערכי enum חדשים | נוספו סוגי פורמטים חדשים: TEXT, VERTICAL_ADS_BOOKING_LINK וVERTICAL_ADS_PROMOTION. |
| נכסים | ||
asset_group צפייה |
שדות חדשים | הוספנו את המדדים הבאים: metrics.engagements, metrics.engagement_rate ו-metrics.average_cpe. |
asset_group_asset צפייה |
שדות חדשים | הוספנו את המדדים הבאים: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views ו-metrics.interaction_event_types. |
Asset.orientation |
שדה חדש | הוספנו שדה של כיוון לקריאה בלבד לנכסי תמונות ווידאו. |
CampaignAsset |
תכונה חדשה | הוספנו תמיכה באחזור נכסים של קמפיין עם הערכים HEADLINE ו-DESCRIPTION של field_type. |
ServedAssetFieldType |
ערכי enum חדשים | נוספו HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE ו-DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO לנכסים שמוצגים כתוספי Sitelink. |
BusinessMessageAsset |
תכונות חדשות / תמיכה | נכסים מעודכנים של שליחת הודעות לעסק:
|
| חיוב | ||
InvoiceService.ListInvoices |
אפשרויות חדשות | אפשר להגדיר את include_granular_level_invoice_details ב-ListInvoicesRequest כדי לקבל עכשיו פרטים מפורטים יותר ב-Invoice, כולל פירוט עלויות ברמת הקמפיין, עלויות רגולטוריות מפורטות ומידע על התאמות. |
RegulatoryFeeType UnitOfMeasure |
סוגי enum חדשים | נוספו סוגי enum של עזר לעמלות בהתאם לחוק וליחידות מדידה. |
| קמפיינים | ||
CampaignError |
ערכי enum חדשים / שגיאות | נוספו קודי השגיאה DURATION_TOO_LONG_FOR_TOTAL_BUDGET ו-END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET. |
| המרות | ||
| ConversionActionCategory | ערך enum חדש | נוסף YOUTUBE_FOLLOW_ON_VIEWS כדי לתמוך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ. |
| יצירת ביקוש | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
שדה חדש | הוספנו תמיכה במודעות באנר נלוות במודעות וידאו רספונסיביות ליצירת ביקוש. |
| תמריצים | ||
נוספה תמיכה בתמריצים מסוג 'בחירת תמריץ' (CYO):
כדי לאפשר טיפול מפורט יותר בכשלים בתהליך התכנותי, נוסיף קודי שגיאה נוספים ל- |
||
| תכנון | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
ערך enum חדש | מאפשר ליצור קהלים באמצעות אירועים משמעותיים בחיים ב-GenerateAudienceCompositionInsights, ב-GenerateSuggestedTargetingInsights, ב-GenerateInsightsFinderReport וב-GenerateCreatorInsights.
אין תמיכה באירועים משמעותיים בחיים בשיטות אחרות של |
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 ואילך. הממשק מוצג בגרסאות האלה, אבל אם תנסו לשלוח בקשה לשינוי נתונים לאחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: "The field attempted to be mutated is immutable" (השדה שניסית לשנות הוא קבוע) או "Field cannot be set" (אי אפשר להגדיר את השדה). השדות האלה יהפכו לניתנים לשינוי באופן מלא החל מגרסה 25. מומלץ להשתמש בממשק עכשיו כדי ליצור ולבדוק את הלוגיקה הפנימית, כדי שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשהגרסה v25 תושק. |
| קבלת אישור ממספר משתמשים | תכונות חדשות |
הוספנו תמיכה בבדיקות של אישורים ממספר משתמשים (MPA):
|
גרסה 22.1 (25.02.2026)
התכונה החדשה הבאה נוספה לגרסה 22.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 גנרטיבי:
|
| קמפיינים | ||
AppCampaignBiddingStrategyGoalType |
ערכי enum חדשים | הוספנו יעדים חדשים לקמפיינים להתקנת אפליקציות (ACi) כדי לבצע אופטימיזציה בלי לציין יעד:
|
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 חדשים | הוספנו אפשרויות חדשות לאוטומציה של נכסים בקמפיינים למיקסום הביצועים:
|
| פילוחים בדוחות של קמפיינים למיקסום ביצועים | פלחים חדשים | הוספנו פלחים חדשים שייחודיים לקמפיינים למיקסום הביצועים:
|
| תכנון | ||
| רשימות של נתוני שותפים מ-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 (משך ממוצע לחשיפה). |
נתוני גרסה בארכיון
הערות הגרסה של גרסאות שיצאו משימוש