במאמר הוצאה משימוש של תכונות מופיעה רשימה עדכנית של תכונות שהוצאו משימוש או שיוצאו משימוש בעתיד. במאמר לוח הזמנים להוצאה משימוש ולהפסקה של תמיכה מופיעים תאריכי מחזור החיים של הגרסאות, ובמאמר שדרוג גרסת ה-API מופיעות טבלאות של הבדלים בין גרסאות פרוטו שאפשר לסנן.
סיכום הגרסה וקישורים מהירים
אתם יכולים להשתמש בטבלה הבאה כדי לעבור ישירות לשינויי תוכנה שעלולים לגרום לכשל, לתכונות חדשות או לטבלאות של הבדלים ב-proto בגרסה מסוימת:
גרסאות ראשיות ומשניות של v26
גרסה 26 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לגרום לכשל.
גרסה 26.1 (28.10.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 26.1 של Google Ads API. גרסאות משניות, כמו v26.1, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
| מעקב חיצוני אחרי מימוש קידום מכירות | הודעות, שדות, ערכי enum ושגיאות חדשים |
הוספנו את השדה הבלתי ניתן לשינוי
הוספנו גם את קוד השגיאה |
| קמפיינים | ||
| תעדוף ערוצים בשיטת Waterfall ותקציבים מקסימליים לתקציבי קמפיינים | תכונות, משאבים, שירותים, שדות וערכי enum חדשים |
הוספנו תמיכה בתעדוף ערוצים בשיטת Waterfall ובתקרות תקציב בקמפיינים, שמאפשרים לכם לקבוע איך להקצות תקציב בערוצי הרשת (מוצרים ושירותים בבעלות ובהפעלת Google, רשת שותפי החיפוש ורשת המדיה של Google). מידע נוסף זמין בפוסט בבלוג בנושא תעדוף ערוצים והקצאת תקציב.
|
| שגיאה בהפעלה של קמפיין ליצירת ביקוש שהועבר | ערך enum ושגיאה חדשים | הוספנו את הטיפוס המוגדר מראש DemandGenCampaignError עם קוד השגיאה DemandGenCampaignError.CANNOT_ACTIVATE_MIGRATED_CAMPAIGN. ה-API מחזיר את השגיאה הזו אם מנסים להפעיל קמפיין ליצירת ביקוש שהועבר לפני שמסירים את הקמפיין המקורי, או כשקמפיין אחר שהועבר מאותו קמפיין מקורי פעיל. |
| כללי | ||
| פרטי השירות והקטגוריה של הזכאות ל-"Google בעלי מקצוע" | שירות, הודעות ושדות חדשים |
הוספנו את השירות
|
| הגדרות של ספק חיצוני למימוש שוברים ב-"Google בעלי מקצוע" | שדה מעודכן, הודעות חדשות ושדות חדשים | השדה Customer.local_services_settings עודכן מ-OUTPUT_ONLY ל-mutable. הוספנו גם את השדה LocalServicesSettings.redemption_provider_info מסוג RedemptionProviderInfo כדי להגדיר את ספק מימוש השוברים החיצוני בחשבון "Google בעלי מקצוע". ההודעה הזו מכילה את השדה הנדרש RedemptionProviderInfo.external_merchant_id מסוג ExternalPartnerMerchantId, שמכיל מספר שלם (numeric_id) או מחרוזת של 1-50 תווים (alphanumeric_id) של מספר חשבון Merchant. |
| המלצות | ||
| המלצה על אופטימיזציה לצירוף לקוחות חדשים | המלצה חדשה |
הוספנו את ערך ה-enum
|
| דוחות | ||
| מידע על קבוצות התדירות בדוחות של היקף החשיפה ועל מצב המדדים | מדדים, הודעות וערכי enum חדשים |
הוספנו את המדדים הבאים להודעה
הוספנו גם את המדדים הבאים של
|
| תמיכה בנתח החשיפות בראש הדף בחיפוש ובנתח הקליקים בחיפוש בפלחי מסלול הנסיעה והמודעות בענף של הזמנת חדרים במלונות | מדדים ופלחים מעודכנים |
הרחבנו את התמיכה במדדים
|
| טירגוט | ||
| החרגות לפי הכנסה למשק בית בקמפיינים למיקסום הביצועים | תמיכה מורחבת | הוספנו תמיכה בהחרגות של הכנסה למשק בית בקמפיינים למיקסום הביצועים. כדי להחריג טווחי הכנסה למשק בית, יוצרים משאב CampaignCriterion שלילי כשהשדה income_range מוגדר. |
גרסה 26 (14.10.2026)
גרסה 26 של Google Ads API היא גרסה ראשית, והוספנו בה את התכונות החדשות, העדכונים ושינויי התוכנה שעלולים לגרום לכשל הבאים.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| קמפיינים | |||
שדה country_code אופציונלי ב-LocalServicesPmaxCampaignSettings |
שדה חובה במהלך יצירת קמפיין למיקסום הביצועים של "Google בעלי מקצוע" (LocalServicesPmaxCampaignSettings.country_code) |
שינוי באופן הפעולה | כשיוצרים קמפיינים למיקסום הביצועים של "Google בעלי מקצוע", חשוב לציין את country_code (יחד עם listing_id שנדרש עכשיו). |
| המרות | |||
השדה enhanced_conversions_for_leads_enabled ב-ConversionTrackingSetting (Customer.conversion_tracking_setting) |
ללא | הסרה | במקום זאת, צריך להשתמש ב-ConversionTrackingSetting.enablement_setting ב-Customer.conversion_tracking_setting כדי לבדוק את ההגדרה של ההמרות המשופרות ברמת החשבון. |
| טירגוט | |||
שדות של קריטריונים ספציפיים למלונות ב-AdGroupBidModifier:
|
שדות קריטריונים שלא תלויים בענף ב-AdGroupBidModifier:
|
שינוי שם או הסרה | צריך לעדכן את ההפניות כך שישתמשו בשדות הקריטריונים שלא תלויים בענף, שעדיין נתמכים רק במודעות להזמנת חדרים בקמפיינים לקידום מלונות ובקמפיינים לרשת החיפוש בענף התיירות. מזהי הקריטריונים, התנהגות הטירגוט והתאמות קיימות של הצעות המחיר נשארים ללא שינוי, והערכים של min_nights ו-max_nights מועברים אל min_days ו-max_days ללא המרה. מידע נוסף זמין במאמר התאמת הצעות מחיר באמצעות התאמות של הצעות מחיר. |
HotelDateSelectionType וסוג של segments.user_set_dates |
DateSelectionType |
שינוי שם או סוג | צריך להשתמש ב-DateSelectionType במקום ב-HotelDateSelectionType עבור התאמות של הצעות מחיר ב-user_set_dates וב-segments.user_set_dates. |
סיבות לשגיאות שספציפיות למלון ב-CriterionError:
|
סיבות לשגיאות שלא קשורות לתחום מסוים ב-CriterionError:
|
שינוי שם | מעדכנים את הטיפול בשגיאות כדי לבדוק את הסיבות החדשות לשגיאות שלא קשורות לענף ספציפי. |
תכונות ועדכונים (לא קריטיים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
| ספקי הודעות לעסק ב-LINE וב-SMS | שדות חדשים וערכי טיפוסים בני מנייה (enum) | נוספה תמיכה ב-LINE וב-SMS כספקי הודעות ב-BusinessMessageAsset, כולל שדות חדשים BusinessMessageAsset.line_info ו-BusinessMessageAsset.sms_info יחד עם BusinessMessageProvider.LINE ו-BusinessMessageProvider.SMS. |
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY |
ערך enum חדש / שגיאה | התווסף אל AssetGroupError כדי לציין מתי קטגוריה שצוינה ב-GoogleLocalServicesInfo (AssetGroup.google_local_services_info) לא נתמכת בקמפיינים למיקסום הביצועים של "Google בעלי מקצוע". |
| קמפיינים | ||
| יצירת קמפיין למיקסום הביצועים של מודעות "Google בעלי מקצוע" | תכונות, שדות ושגיאות חדשים |
עדכנו את הוספנו גם את |
| שגיאות אימות בקמפיינים של "Google בעלי מקצוע" | ערכי enum ושגיאות חדשים | הוספנו שגיאות אימות חדשות בקמפיינים של "Google בעלי מקצוע": |
| אימות הקישור לחשבון Hotel Center | ערך enum חדש / שגיאה | הוספנו את קוד השגיאה CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED ל-CampaignError כדי לציין שכדי לקשר קבוצת נכסים של מלונות (Campaign.hotel_property_asset_set) לקמפיין למיקסום הביצועים לענף התיירות והאירוח, צריך קישור פעיל לחשבון Hotel Center. |
| התקציב המינימלי ליום בקמפיינים ליצירת ביקוש | שדה חדש | הוספנו את השדה demand_gen_info.minimum_budget_per_day_micros ל-CurrencyConstant, שמציין את התקציב המינימלי הנדרש ליום לקמפיינים ליצירת ביקוש במטבע הזה. הערך של השדה הזה מתעדכן כשהתקציב המינימלי שה-API אוכף משתנה. |
| הגדרת מדידת השיפור בקמפיינים | שדה חדש | הוספנו את השדה Campaign.lift_measurement_config כדי לחשוף את שם המשאב של הגדרת מדידת התחזקות המותג שמקושרת לקמפיין. |
| אימות של ניסוי בקמפיין AI למיקסום ביצועים | ערך enum חדש / שגיאה | הוספנו את קוד השגיאה ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED ל-ExperimentArmError כשמנסים ליצור ניסוי ADOPT_AI_MAX בקמפיין שכבר מופעלת בו חבילת התכונות "AI למיקסום הביצועים" (או שהיא מופעלת באותה בקשה לפני שנוצרת קבוצת הניסוי). |
| סוג כרטיס המוצר בקמפיין שופינג | תמיכה מורחבת | הרחבנו את התמיכה בCampaign.listing_type לקמפיינים של שופינג. |
| עדכונים בנושא הצהרה עצמית לגבי פרסום שקשור לפוליטיקה באיחוד האירופי | התנהגות מעודכנת ושדות חדשים |
הפרמטר
|
| המרות | ||
| הגדרה אחידה של המרות משופרות | שדות חדשים ו-enum | הוספנו את ConversionTrackingSetting.enablement_setting ואת ConversionTrackingSetting.effective_enablement_setting (ב-Customer.conversion_tracking_setting) כדי לחשוף את ההגדרה המאוחדת של ההמרות המשופרות בחשבון, שמיוצגת באמצעות הטיפוס המוגדר מראש החדש EnhancedConversionsConfig. |
ConversionActionCategory.MESSAGE_LEAD |
ערך enum חדש | נוסף ל-ConversionActionCategory כדי לתמוך באינטראקציות של הודעות או צ'אט שמצביעות על עניין בהצעות של המפרסם. |
ConversionAttributionEventType.CLICK |
ערך enum חדש | נוסף ל-ConversionAttributionEventType כדי לייצג המרות שמשויכות לקליק על מודעה, שנכללו בעבר בערך המאגר UNKNOWN. |
| כללי | ||
| עדכונים על לידים מ-"Google בעלי מקצוע" | שדה חדש וערך enum |
|
| המלצות | ||
| המלצה להגדלת התקציב בקמפיינים לרשת החיפוש | המלצה חדשה | הוספנו את RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation ו-ApplyRecommendationOperation.raise_budget_performance_too_low כדי לתמוך בהגדלת התקציבים כשהתקציבים היומיים נמוכים מדי בקמפיינים לרשת החיפוש. |
| דוחות | ||
| מדידת העלייה בנפח החיפוש | תכונות, משאבים, פלחים ומדדים חדשים | הוספנו תמיכה במדידת העלייה בנפח החיפוש:
|
| תצוגת הנכסים של התאמת כתובת URL סופית בקמפיינים של שופינג | תמיכה מורחבת | הרחבנו את final_url_expansion_asset_view כדי לתמוך בקמפיינים של שופינג (עם ad_group שאפשר לבחור כמשאב משויך לצד final_url_expansion_asset_view.ad_group). |
| סרטונים | ||
| גילוי נאות לגבי תוכן גנרטיבי ב-YouTube | שדות חדשים ו-enum | הוספנו תמיכה בגילוי נאות לגבי תוכן גנרטיבי בהעלאות ל-YouTube. השדה החדש YouTubeVideoUpload.video_content_metadata מסוג VideoContentMetadata נוסף אל YouTubeVideoUpload, והוא מכיל הגדרות גילוי נאות בקטע VideoContentMetadata.generative_content_disclosure מסוג YouTubeVideoUploadGenerativeContentDisclosure. |
גרסאות ראשיות ומשניות של v25
גרסה 25 של Google Ads API כוללת את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לגרום לכשל.
גרסה 25.2 (23.09.2026)
התכונות והעדכונים החדשים הבאים נוספו בגרסה 25.2 של Google Ads API. גרסאות משניות, כמו v25.2, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
אפשרויות של כתובות URL בחשבון AssetGroup |
שדות חדשים | הוספנו תמיכה באפשרויות של כתובות URL ב-AssetGroup, שמאפשרות למפרסמים לציין תבניות מעקב, פרמטרים מותאמים אישית וסיומות של כתובות URL סופיות ברמת קבוצת הנכסים:
|
| קמפיינים | ||
| מידע על סריקה אוטומטית של סרטונים | שדות וערכי enum חדשים | הוספנו את 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 ושגיאות חדשים | הוספנו סיבות לשגיאות בסנכרון המיקומים של פרופיל העסק כשמסנכרנים מיקומים בAssetSet מסוג LOCATION_SYNC. במקום להחזיר שגיאת 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 Cloud עם רמת גישה 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 |
חלק מ-oneof של value_adjustment ו-high_lifetime_value_adjustment בהתאמה, לצד השדות החדשים 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 בגרסאות v25, v24 ו-v23. |
| קמפיינים | ||
| יעד שימור נאמנות | תכונות או הגדרות חדשות | הוספנו תמיכה ביעד "שימור לקוחות", שמאפשר למפרסמים לבצע אופטימיזציה של הקמפיינים כדי לשמר חברים במועדון הלקוחות.
|
| היעד "צירוף לקוחות חדשים" | תכונות או הגדרות חדשות | עדכנו את התמיכה ביעד "צירוף לקוחות חדשים" ב-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 |
שדה חדש | הוספנו תמיכה במידע על מודעות של "Google בעלי מקצוע" (מזהה קטגוריה ויתרונות מרכזיים) בקמפיינים למיקסום הביצועים. |
AssetGroupSignal.local_services_id |
שדה חדש | נוסף כדי לתמוך באותות של מזהי שירות במודעות של "Google בעלי מקצוע" בקמפיינים למיקסום הביצועים. |
AssetGroupSignal.vertical_ads_item_group_rule_list |
שדה חדש | הוספנו את זה כדי לתמוך בכללים של קבוצות פריטים במודעות בענפים ספציפיים, שמאפשרים לבחור פריטים מפידים מצורפים של ענפים ספציפיים בקמפיינים למיקסום הביצועים. התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים. |
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN |
ערך enum חדש / שגיאה | מוחזר כשמנסים להסיר את כל קבוצות הנכסים מקמפיין. |
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS |
ערך enum חדש / שגיאה | מוחזר כשמנסים להסיר את כל האותות מקבוצת נכסים. |
| קמפיינים | ||
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled |
שדות חדשים | תמיכה בזיהוי קמפיינים למיקסום הביצועים של "Google בעלי מקצוע". |
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps |
שדה חדש | כולל את מפות Google בערוצים שאפשר לבחור בקבוצות של מודעות ליצירת ביקוש. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
ערך enum חדש / שגיאה | מוחזר כשמנסים להסיר את כל המיקומים מקמפיין למיקסום הביצועים של "Google בעלי מקצוע". |
SmartCampaignErrorEnum.CREATION_FAILED |
ערך enum חדש / שגיאה | מוחזרת כשמנסים ליצור קמפיינים חכמים חדשים. |
| המרות | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
ערכי enum חדשים | מייצגות המרות שמתרחשות כשמשתמש לוחץ על מודעה של "Google בעלי מקצוע" ומתקשר למפרסם, שולח לו הודעה או מזמין ממנו שירות. |
| ניסויים | ||
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION |
ערכי enum חדשים | הוספנו תמיכה בסוגים חדשים של ExperimentType:
|
| כללי | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
שדות חדשים | מכילים הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו או סופקו באופן אוטומטי על ידי המערכת).
התכונה הזו הוסבה לגרסאות מוקדמות יותר (backporting) – גרסה 23 וגרסה 22.
כדי לעזור לכם לתכנן את עבודת השילוב הקרובה של גרסה 25, הממשק לשינוי שדות ההצהרה של המפרסם מוצג מוקדם יותר בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל
אם תנסו לשלוח בקשה לשינוי נתונים באחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: "The field attempted to be mutated is immutable" או "Field cannot be set". השדות האלה יהיו ניתנים לשינוי מלא החל מגרסה 25. אנחנו ממליצים להשתמש בממשק כבר עכשיו כדי לבנות ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשגרסה 25 תושק. |
| אישור מכמה משתמשים (MPA) | תכונות חדשות |
נוספה תמיכה בבדיקות של אישור מכמה משתמשים (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. המסנן חושף יוצרים מקומיים שצופים בהם במדינה שנבחרה או שהם ממוקמים בה, ושהסכימו לשתף נתוני מיקום. |
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)
בגרסה הראשית הבאה, Google Ads API גרסה 24, הוספנו את התכונות החדשות, העדכונים והשינויים הבאים שעלולים לגרום לכשל.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| מודעות | |||
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 |
שינוי באופן הפעולה או בסוג | צריך לעדכן את השילובים של ספריות לקוח מסוג Typed כדי להשתמש במרחבי השמות החדשים של המשאבים. |
השדה youtube_select_lineups ב-ReachPlanService.ListPlannableProducts |
ללא | הסרה | עוברים לשימוש בחבילות ערוצים מ-youtube_select_lineup_targeting. |
השדה is_brand_connect_creator ב-ContentCreatorInsightsService.GenerateCreatorInsights וב-GenerateTrendingInsights |
ללא | הסרה | במקום זאת, אתם יכולים לבדוק אם ליוצר יש CREATOR_PARTNERSHIPS זמינים ב-partnership_opportunities. |
geo_modifiers ו-biddable_keywords ב-KeywordPlanIdeaService.GenerateKeywordForecastMetrics |
geo_target_constants וגם keywords |
שינוי שם או הסרה | הוחלף על ידי CampaignToForecast.geo_target_constants[] ו-ForecastAdGroup.keywords[]. |
שדות של תחזית/תוכנית מילות מפתח שיצאו משימוש ב-GenerateKeywordForecastMetrics |
ללא | הסרה | הסרנו את הסוגים והשדות הבאים של תוכניות ותחזיות: מעדכנים את השילובים בהתאם. |
| דוחות | |||
פלח ad_sub_network_type בcampaign_budget |
ללא | הסרה | הוסר הפלח ad_sub_network_type מהמשאב campaign_budget. |
פילוח לפי click_type בתצוגות של נכסים |
ללא | הסרה | הפלח הוסר מהתצוגות AdGroupAsset, CampaignAsset ו-CustomerAsset. |
| סרטונים | |||
כשל חלקי מותר ב-ShareablePreviewService.GenerateShareablePreviews |
אין כשל חלקי | שינוי באופן הפעולה | אם אחד מהמזהים בבקשה לא יעבור את האימות, הבקשה תיכשל ותופיע שגיאה. |
ShareablePreviewError קודים מדור קודם:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
שינוי שם / שינוי באופן הפעולה | קודי השגיאה שמוחזרים לגבי קבוצות נכסים משתנים כדי להתאים לשגיאות במודעות בקבוצות של מודעות. עדכון הלוגיקה של תפיסת השגיאות באימות. |
תכונות ועדכונים (לא קריטיים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
יכולת השינוי של VideoResponsiveAdInfo |
שינוי התנהגותי | אובייקטים של מידע על מודעות וידאו רספונסיביות ניתנים עכשיו לשינוי. |
| נכסים | ||
travel_feed_data ב-AssetSet |
שדה חדש | נוספו כדי לאחזר מאפיינים של נכסים בפיד נסיעות (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type). |
| קמפיינים | ||
Campaign.view_through_conversion_optimization_enabled |
שדה חדש | מאפשר להפעיל אופטימיזציית המרות בעקבות צפייה (VTC) (ברירת המחדל היא false) בקמפיינים ליצירת ביקוש ובקמפיינים לקידום אפליקציות. |
CampaignCriterion.gender |
תכונה חדשה | הפעלנו החרגות של מגדר בקמפיינים למיקסום הביצועים בכל הגרסאות של Google Ads API. |
| המרות | ||
| סוגי המרות ליצירת לידים | ערכי enum חדשים | נוספו ערכי enum חדשים של סוגי פעולות המרה ב-GA4 או ב-Firebase ב-ConversionActionType:
|
| כללי | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
ערך enum חדש / שגיאה | מוחזר כשמנסים ליצור כמה רשימות זהות של קהלים דומים. |
| תכנון | ||
ProductCoreAttributes שדות בListPlannableProductsResponse |
שדות חדשים | הוספנו תיאור של מוצר שניתן לתכנון, יעד שיווקי, מודל עלות ושיטת קנייה ל-ProductCoreAttributes בקטע ListPlannableProductsResponse. |
| דוחות | ||
CartDataSalesView |
משאב דיווח חדש | הדוחות האלה מציגים פילוח של מדדי ההמרות לפי המוצר הספציפי שנמכר (מותג וכו'), בנוסף למוצר שהמשתמש לחץ עליו. |
| מדדים שלא ניתן להגיש עליהם הצעות מחיר | שדות חדשים | הוספנו מדדים שלא ניתן להגיש עליו הצעות מחיר (מדדים שמציגים המרות שהקמפיינים לא מבצעים אופטימיזציה עבורן) לכל המשאבים התואמים:
|
conversion_attribution_event_type |
פלח חדש | נוסף אל ShoppingPerformanceView. |
| שופינג | ||
קמפיינים לקידום אפליקציות ב-ShoppingProduct |
תכונה חדשה | קמפיינים נתמכים לקידום אפליקציות במשאב ShoppingProduct. אין תמיכה בסטטוסים ובבעיות של הערות. |
| סינון מוצרים לפי תגים | תכונה חדשה | הוספנו אפשרות לסנן באופן דינמי באמצעות ביטויים לוגיים:
|
גרסאות ראשיות ומשניות של v23
גרסה 23 של Google Ads API כוללת את התכונות החדשות, העדכונים ושינויי התוכנה שעלולים לגרום לכשל הבאים.
גרסה 23.3 (24.06.2026)
התכונות והעדכונים החדשים הבאים נוספו בגרסה 23.3 של Google Ads API. גרסאות משניות, כמו v23.3, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| כללי | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
שדות חדשים | מכילים הצהרות לגבי תוכן סינתטי או תוכן שנוצר על ידי AI, שמחולקות ל-advertiser_attestation (הצהרות שסופקו ישירות על ידי המפרסם) ול-system_attestation (הצהרות שזוהו או סופקו באופן אוטומטי על ידי המערכות של Google).
כדי לעזור לכם לתכנן את עבודת השילוב הקרובה של גרסה 25, הממשק לשינוי שדות ההצהרה של המפרסם מוצג מוקדם יותר בגרסה 22 ואילך. הממשק גלוי בגרסאות האלה, אבל
אם תנסו לשלוח בקשה לשינוי נתונים באחד מהשדות האלה, תוחזר אחת מהשגיאות הבאות: "The field attempted to be mutated is immutable" או "Field cannot be set". השדות האלה יהיו ניתנים לשינוי מלא החל מגרסה 25. אנחנו ממליצים להשתמש בממשק כבר עכשיו כדי לבנות ולבדוק את הלוגיקה הפנימית, כך שהמערכת תהיה מוכנה ליכולות כתיבה מלאות כשגרסה 25 תושק. |
| קבלת אישור ממספר משתמשים | תכונות חדשות |
נוספה תמיכה בבדיקות של אישורים ממספר משתמשים (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 |
תכונות חדשות | הוספנו תמיכה בשילובים מותאמים אישית של ישויות, נושאים וקהלים באמצעות האופרטורים "וגם" או "או". |
ReachPlanService.GenerateReachForecast |
ערכי enum חדשים | הוספנו טווחי גילאים חדשים שאפשר לטרגט, כמו AGE_RANGE_21_44 או AGE_RANGE_21_49. |
youtube_select_lineup_targeting |
שדה חדש | הוספנו את ReachPlanService.ListPlannableProducts, שיחליף את youtube_select_lineups. שני השדות מאוכלסים כרגע. |
ReachPlanSurface |
ערך enum חדש | הוספנו את IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS כאפשרות לפלטפורמה. |
Forecast |
שדה חדש | נוסף clicks ל"מקסימום קליקים" (CPC) בקמפיינים ליצירת ביקוש ב-ReachPlanService.GenerateReachForecast. |
partnership_opportunities |
שדה חדש | התווסף אל ContentCreatorInsightsService.GenerateCreatorInsights ואל ContentCreatorInsightsService.GenerateTrendingInsights. |
| דוחות | ||
biddable_indirect_install_first_in_app_conversion_micros |
שדה חדש | נוספו למשאבים Campaign, Customer ו-AdGroup. |
| סרטונים | ||
ShareablePreviewService |
תכונה חדשה | הורחב כדי לתמוך בתצוגות מקדימות של YouTube בשידור חי על ידי הגדרת preview_type ל-YOUTUBE_LIVE_PREVIEW. הוספנו את UNSUPPORTED_AD_TYPE ו-TOO_MANY_RESOURCES_IN_REQUEST אל ShareablePreviewError. האפשרות הזו נתמכת רק בחלק מסוגי המודעות. |
גרסה 23.1 (25.02.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.1 של Google Ads API. גרסאות משניות, כמו v23.1, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| ניהול חשבון | ||
advertising_partner_properties.allowed_domain |
שדה חדש | נוסף למשאבים ProductLinkInvitation ו-ProductLink. השותף לקניית שטחי פרסום יוכל לפרסם רק בדומיין הזה. |
Customer.contains_eu_political_advertising |
שדה חדש | מאחזר את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם הוא מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזיר EuPoliticalAdvertisingStatus. |
| קמפיינים | ||
Campaign.text_guidelines |
שדה חדש | הוספנו תמיכה בהנחיות לניסוח טקסטים, שאפשר להשתמש בהן בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש כדי לשלוט באופן פרוגרמטי בנכסי טקסט שנוצרו על ידי AI. בתוך text_guidelines, אפשר להגדיר את term_exclusions ואת messaging_restrictions. |
CampaignPrimaryStatusReason |
ערכי enum חדשים | הוספנו את CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED ו-BOOKING_CANCELLED כדי לספק סיבות לסטטוס הראשי של קמפיינים עם שיטת הבידינג FIXED_CPM. |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
שדות חדשים | הוספנו תמיכה בגילוי נאות עצמאי לגבי הקטגוריות של מודעות בהזמנה ובפרטי הזמנה לקריאה בלבד. |
Campaign.missing_eu_political_advertising_declaration |
שדה חדש | תמיכה בשאילתות ובסינון של קמפיינים שחסרות בהם הצהרות לגבי השאלה אם הם מכילים פרסום פוליטי שמטורגט לאיחוד האירופי. |
| המרות | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
ערך enum חדש | תמיכה במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ. |
| כללי | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
ערך enum חדש / שגיאה | מוחזר כשמנסים לטרגט רק את הקטגוריה "לא ידוע" במאפיינים דמוגרפיים. |
| תמריצים | ||
IncentiveErrorEnum |
ערכי enum חדשים / שגיאות | הוספנו שני קודי שגיאה חדשים: MAX_INCENTIVES_REDEEMED ו-ACCOUNT_TOO_OLD. השגיאות האלה יכולות להופיע בבקשות שנשלחות החל מ-11 במרץ 2026. |
| תכנון | ||
GenerateBenchmarksMetrics |
תכונה חדשה | הוספנו תמיכה בפירוט לפי תאריכים באמצעות BreakdownDefinition. |
ReachPlanService.GenerateReachForecast |
ערך enum חדש | הוספנו את GOOGLE_DISPLAY_NETWORK בתור פלטפורמה שאפשר לטרגט בקמפיינים ליצירת ביקוש עם שיטת הבידינג "מקסימום המרות". |
GenerateTrendingInsights |
שדות חדשים | הוספנו מידע על קו מגמה היסטורי בTrendInsightDataPoint עד TrendInsights כשמחפשים לפי נושא. |
| דוחות | ||
| מדדים של תדירות החשיפה למשתמשים ייחודיים | שדות חדשים | הוספנו מדדים חדשים שמדווחים כמה משתמשים ראו את המודעה לפחות פעמיים, שלוש, ארבע, חמש או עשר פעמים: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ו-unique_users_ten_plus. |
SearchTermMatchSource |
ערך enum חדש | הוספנו את VERTICAL_ADS_DATA_FEED כדי לתמוך בפידים של נתוני מודעות בענפים ספציפיים, כמו טירגוט ישויות במודעות להזמנת נסיעות. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
שירות או משאב חדש | הוספנו את השירות YouTubeVideoUpload כדי לתמוך בהעלאה ובניהול של סרטונים ב-YouTube, ואת המשאב YouTubeVideoUpload כדי לתמוך באחזור של סטטוס ההעלאה והמטא-נתונים. התכונה הזו נתמכת רק ב-REST ובספריית הלקוח של Python. |
גרסה 23 (28.01.2026)
גרסה 23 של Google Ads API היא גרסה ראשית, והוספנו בה את התכונות החדשות, העדכונים ושינויי התוכנה שעלולים לגרום לכשל שמפורטים בהמשך.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| מודעות | |||
| מותר לשתף את המודעה | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
שינוי באופן הפעולה | אסור יותר לשתף מודעות בין כמה קבוצות של מודעות. בקשות לשיתוף מודעות יחזירו שגיאת AD_SHARING_NOT_ALLOWED. |
תמיכה ב-CallAd וב-CallAdInfo |
ללא | הסרה | הוסרה התמיכה במודעות לשיחות. אפשר לעיין במאמר מידע על מודעות לשיחות במרכז העזרה. |
| קמפיינים | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
שינוי שם או החלפה | השתמשו בשדות החדשים של התאריך והשעה כדי לציין רכיבי זמן בקמפיינים. השדות המקוריים של התאריך בלבד יוסרו. |
| יצירת ביקוש | |||
DemandGenMultiAssetAdInfo.lead_form_only |
ללא | הסרה | השדה lead_form_only הוסר. מעדכנים את ההפניות בקוד. |
| דוחות | |||
| מדדים וערכי enum של תוויות ביצועים מצטברות של נכסים | ללא | הסרה | הסרנו את המדדים המצטברים של תוויות הביצועים של הנכסים. הערך של סיווג הביצועים לא מוחזר יותר בקמפיינים לרשת החיפוש ולרשת המדיה. |
תכונות ועדכונים (לא קריטיים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
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 |
תכונה חדשה | הוספנו תמיכה באחזור נכסים של קמפיינים כשהשדה field_type מוגדר לערכים HEADLINE ו-DESCRIPTION. |
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 לנכסים שמוצגים כ-Sitelinks. |
BusinessMessageAsset |
תכונות חדשות / תמיכה | נכסי הודעות לעסק שעודכנו:
|
| חיוב | ||
InvoiceService.ListInvoices |
אפשרויות חדשות | עכשיו אפשר להחזיר פרטים ברמת פירוט גבוהה יותר ב-Invoice, כולל פירוט עלויות ברמת הקמפיין, עלויות מפורטות בהתאם לחוק ומידע על התאמות, על ידי הגדרת include_granular_level_invoice_details ב-ListInvoicesRequest. |
RegulatoryFeeType UnitOfMeasure |
ערכי enum חדשים | נוספו ערכי enum מסייעים לעמלות בהתאם לחוק וליחידות מידה. |
| קמפיינים | ||
CampaignError |
ערכי enum חדשים / שגיאות | נוספו קודי השגיאה DURATION_TOO_LONG_FOR_TOTAL_BUDGET ו-END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET. |
| המרות | ||
| ConversionActionCategory | ערך enum חדש | הוספנו את YOUTUBE_FOLLOW_ON_VIEWS כדי לתמוך במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ. |
| יצירת ביקוש | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
שדה חדש | הוספנו תמיכה במודעות באנר נלוות במודעות וידאו רספונסיביות ליצירת ביקוש. |
| תמריצים | ||
הוספנו תמיכה בתמריצים מסוג "בחירה אישית" (CYO):
כדי לאפשר טיפול פרוגרמטי מפורט יותר בכשלים, נוסיף עוד קודי שגיאה ל- |
||
| תכנון | ||
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 (לקמפיינים של "AI למיקסום ביצועים") כדי לספק מדדים לבדיקת ביצועים לפי מיקומים גיאוגרפיים שהתעניינו בהם. |
| שופינג | ||
ShoppingPerformanceView |
תמיכה במדדים חדשים | עכשיו יש תמיכה במדדים הבאים, מפולחים לפי תאריך ההמרה: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date. |
ShoppingPerformanceView |
תמיכה במדדים חדשים | נוספה תמיכה בשפות: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share ו-search_rank_lost_absolute_top_impression_share. |
ShoppingProduct.product_image_uri |
שדה חדש | נוסף אל ShoppingProduct. |
| מודעות בפורמט אנכי | ||
AdGroup.vertical_ads_format_setting |
שדה חדש | מאפשרת לשלוט בפורמטים של המודעות שיכולים להופיע בקמפיינים לרשת החיפוש שמשתמשים בפידים של נתוני נסיעות. |
AdGroupCriterion SharedCriterion |
שדות או קריטריונים חדשים | הוספנו את סוג הקריטריון vertical_ads_item_group_rule_list ל-AdGroupCriterion ואת vertical_ads_item_group_rule ל-SharedCriterion כדי לאפשר טירגוט של קבוצות פריטים בקמפיינים לרשת החיפוש עם פידים של נתוני נסיעות. |
| שילוב של פיד נתונים במודעות לפי ענף ספציפי | תכונה חדשה | עכשיו אפשר לקשר פיד נתונים של מודעות לענף ספציפי לקמפיין לרשת החיפוש שמופעלת בו חבילת התכונות "AI למיקסום ביצועים", כדי להציג מודעות לקידום מלונות ומודעות עם קישור להזמנה לצד מודעות טקסט. אפשר לשלוט בפורמטים באמצעות vertical_ads_format_setting ולהגדיר כללים באמצעות vertical_ads_item_group_rule. פילוח הדיווח לפי מאפיינים של AdFormatType ושל פיד נתוני המודעות לענף ספציפי. |
| סרטונים | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
שדה חדש | אפשרויות נוספות לשליטה בתכונות של נכסי וידאו שמצורפים למודעות. |
CampaignCriterionError |
ערך enum חדש / שגיאה | הוספנו את קוד השגיאה INVALID_VIDEO_LINEUP_ID. |
| מדדי שמיעוּת ב-YouTube | מדדים חדשים | הוספנו מדדי שמיעוּת למודעות אודיו ב-YouTube, שמדווחים אם מודעה הייתה שמיעה ובכמה חשיפות ניתן היה למדוד את השמיעוּת. |
נתוני גרסה שהועברו לארכיון
בקטע גרסאות שהוצאו משימוש אפשר לראות את נתוני הגרסאות שהועברו לארכיון.