במאמר הוצאה משימוש של תכונות מופיעה רשימה עדכנית של תכונות שהוצאו משימוש או שיוצאו משימוש בעתיד. בלוח הזמנים להוצאה משימוש ולהפסקה של תמיכה מופיעים תאריכי מחזור החיים של הגרסאות, ובמאמר שדרוג גרסת ה-API מופיעות טבלאות של הבדלים בין גרסאות פרוטו שאפשר לסנן.
סיכום הגרסה וקישורים מהירים
אתם יכולים להשתמש בטבלה הבאה כדי לעבור ישירות לשינויי תוכנה שעלולים לגרום לכשל, לתכונות חדשות או לטבלאות של הבדלים ב-proto בגרסה מסוימת:
גרסה ראשית v26
גרסה 26 של Google Ads API כוללת את התכונות החדשות, העדכונים ושינויי התוכנה שעלולים לגרום לכשל הבאים.
גרסה 26 (14.10.2026)
גרסה 26 של Google Ads API היא גרסה ראשית, והוספנו בה את התכונות החדשות, העדכונים ושינויי התוכנה שעלולים לגרום לכשל הבאים.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| קמפיינים | |||
שדה country_code אופציונלי ב-LocalServicesPmaxCampaignSettings |
שדה חובה במהלך יצירת קמפיין למיקסום הביצועים של "Google בעלי מקצוע" (LocalServicesPmaxCampaignSettings.country_code) |
שינוי באופן הפעולה | כשיוצרים קמפיינים למיקסום הביצועים של מודעות "Google בעלי מקצוע", חשוב לציין את country_code (יחד עם listing_id שנדרש עכשיו). |
| המרות | |||
השדה enhanced_conversions_for_leads_enabled ב-ConversionTrackingSetting (Customer.conversion_tracking_setting) |
ללא | הסרה | במקום זאת, צריך להשתמש ב-ConversionTrackingSetting.enablement_setting ב-Customer.conversion_tracking_setting כדי לבדוק את ההגדרה של ההמרות המשופרות ברמת החשבון. |
| טירגוט | |||
שדות של קריטריונים ספציפיים למלונות ב-AdGroupBidModifier:
|
שדות קריטריונים שלא תלויים בענף ב-AdGroupBidModifier:
|
שינוי שם או הסרה | מעדכנים את ההפניות כך שישתמשו בשדות הקריטריונים שלא תלויים בענף, שתומכים בטירגוט בענפי נסיעות מעבר למלונות (כמו "דברים שאפשר לעשות"). מזהי הקריטריונים, התנהגות הטירגוט והתאמות קיימות של הצעות המחיר נשארים ללא שינוי. הערכים של min_nights ו-max_nights מועברים אל min_days ו-max_days כמו שהם. |
HotelDateSelectionType וסוג של segments.user_set_dates |
DateSelectionType |
שינוי שם או סוג | צריך להשתמש ב-DateSelectionType במקום ב-HotelDateSelectionType. |
סיבות לשגיאות ספציפיות למלון ב-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). |
| סרטונים | ||
| גילוי נאות לגבי תוכן שנוצר על ידי AI ב-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 |
שינוי מבני | צריך לעדכן את ההפניות לשדות האלה כי הם עכשיו חלק מ-oneof. |
משאבים מדור קודם של CustomerLifecycleGoal ו-CampaignLifecycleGoal, השירותים התואמים שלהם CustomerLifecycleGoalService ו-CampaignLifecycleGoalService, והגדרות/ערכי enum מדור קודם (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 (הצהרות שזוהו או סופקו באופן אוטומטי על ידי המערכת).
התכונה הזו הוסבה לגרסאות מוקדמות יותר (backported) – גרסה 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 מכיל את הטיפוס המוגדר (enum) LOCAL_CREATOR_DATA. המסנן מציג יוצרים מקומיים שצופים בהם במדינה שנבחרה או שהם נמצאים בה, ושהסכימו לשתף את נתוני המיקום שלהם. |
GenerateTrendingInsightsRequest.sub_country_locations |
שדה חדש | הוספנו את ContentCreatorInsightsService.GenerateTrendingInsights, שמאפשר לחפש תובנות לגבי מגמות לפי מיקום במדינה ומיקומים משניים במדינה. |
| דוחות | ||
PerformanceMaxPlacementView |
תוסף פלחים | האפשרות לפלח את הנתונים נוספה על ידי ad_network_type. |
| קניות | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
שדה חדש | אם הערך הוא True, המערכת מתעלמת מהחרגות המותגים במודעות שופינג. האפשרות הזו נתמכת רק בקמפיינים של שופינג. |
| טירגוט | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
ערך enum חדש / שגיאה | מוחזר כשמנסים לטרגט שפה שאסור לטרגט. |
| סרטונים | ||
DataLink.youtube_link_metadata |
שדה חדש | מכיל את brand_channel_id כדי לציין את המזהה של ערוץ המותג המקושר ב-YouTube. |
גרסה 24.1 (13.05.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 24.1 של Google Ads API. גרסאות משניות, כמו v24.1, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
DemandGenMultiAssetAdInfo.classic_display_images |
שדה חדש | תמונות שהועלו בהתאמה אישית לרשת המדיה מוצגות בלי צורך בנכסים רספונסיביים נוספים. |
| ניסויים | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
ערכי enum חדשים | הוספנו תמיכה בסוגים חדשים של ExperimentType:
|
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 |
שינוי באופן הפעולה או בסוג | צריך לעדכן את השילובים של ספריות לקוח מסוג 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):
|
v23.2 (25.03.2026)
התכונות והעדכונים החדשים הבאים נוספו בגרסה 23.2 של Google Ads API. גרסאות משניות כמו v23.2 לא מכילות שינויים שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| נכסים | ||
VideoEnhancement |
משאב חדש | מכיל מידע ספציפי על שיפורים במודעות וידאו, למשל אם השיפור נוצר על ידי Google או סופק על ידי המפרסם. מידע נוסף זמין במאמר מידע על התכונה "שיפור סרטונים". |
AppTopCombinationView |
משאב חדש | משאב לקריאה בלבד שמספק תובנות לגבי שילובי הנכסים שמניבים את הביצועים הכי טובים בקמפיינים לקידום אפליקציות. |
CustomerAsset |
תכונה חדשה | הוספנו תמיכה באחזור של CustomerAsset כשהערך של field_type מוגדר כ-BUSINESS_LOGO. |
| קמפיינים | ||
AdGroupAd.start_date_time AdGroupAd.end_date_time |
שדות חדשים | להגדיר אילוצים מפורטים יותר לתזמון בתאריכי הקמפיין. האפשרות הזו נתמכת רק בחלק מהסוגים של קבוצות המודעות. |
HotelSettingInfo.disable_hotel_setting |
שדה חדש | מאפשרת להשבית את פיד המלונות בקמפיינים ליצירת ביקוש. |
| כללי | ||
CustomerClientLinkError |
ערכי enum חדשים / שגיאות | נוספו שני קודי שגיאה חדשים: MAX_CUSTOMER_LIMIT_REACHED ו-ACCOUNT_CREATION_POLICY_VIOLATION. |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
שינוי התנהגותי | עכשיו, אם מנסים להשתמש בקטגוריה הזו של סוגי לקוחות ברשימת משתמשים, המערכת מקפיצה שגיאה. |
| תכנון | ||
GenerateTrendingInsights GenerateCreatorInsights |
תכונות חדשות | הוספנו תמיכה בשילובים מותאמים אישית של "וגם"/"או" של ישויות, נושאים וקהלים. |
ReachPlanService.GenerateReachForecast |
ערכי enum חדשים | הוספנו טווחי גילאים חדשים שאפשר לטרגט, כמו AGE_RANGE_21_44 או AGE_RANGE_21_49. |
youtube_select_lineup_targeting |
שדה חדש | הוספנו את ReachPlanService.ListPlannableProducts, שיחליף את youtube_select_lineups. שני השדות מאוכלסים כרגע. |
ReachPlanSurface |
ערך enum חדש | הוספנו את IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS כאפשרות לפלטפורמה. |
Forecast |
שדה חדש | נוסף clicks ל"מקסימום קליקים" (עלות לקליק) בקמפיינים ליצירת ביקוש ב-ReachPlanService.GenerateReachForecast. |
partnership_opportunities |
שדה חדש | התווסף אל ContentCreatorInsightsService.GenerateCreatorInsights ואל ContentCreatorInsightsService.GenerateTrendingInsights. |
| דוחות | ||
biddable_indirect_install_first_in_app_conversion_micros |
שדה חדש | נוספו למשאבים Campaign, Customer ו-AdGroup. |
| סרטונים | ||
ShareablePreviewService |
תכונה חדשה | הורחב כדי לתמוך בתצוגות מקדימות של YouTube בשידור חי על ידי הגדרת preview_type לערך YOUTUBE_LIVE_PREVIEW. הוספנו את UNSUPPORTED_AD_TYPE ו-TOO_MANY_RESOURCES_IN_REQUEST אל ShareablePreviewError. האפשרות הזו נתמכת רק בחלק מסוגי המודעות. |
גרסה 23.1 (25.02.2026)
התכונות והעדכונים החדשים הבאים נוספו לגרסה 23.1 של Google Ads API. גרסאות משניות, כמו v23.1, לא מכילות שינויי תוכנה שעלולים לגרום לכשל.
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| ניהול חשבון | ||
advertising_partner_properties.allowed_domain |
שדה חדש | נוסף למשאבים ProductLinkInvitation ו-ProductLink. השותף לקניית שטחי פרסום יוכל לפרסם רק בדומיין הזה. |
Customer.contains_eu_political_advertising |
שדה חדש | הפונקציה הזו מאחזרת את סטטוס ההצהרה ברמת החשבון לגבי השאלה אם הוא מכיל פרסום פוליטי שמטורגט לאיחוד האירופי, ומחזירה EuPoliticalAdvertisingStatus. |
| קמפיינים | ||
Campaign.text_guidelines |
שדה חדש | הוספנו תמיכה בהנחיות לניסוח טקסטים, שאפשר להשתמש בהן בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש כדי לשלוט באופן פרוגרמטי בנכסי טקסט שנוצרו על ידי AI. בתוך text_guidelines, אפשר להגדיר את term_exclusions ואת messaging_restrictions. |
CampaignPrimaryStatusReason |
ערכי enum חדשים | הוספנו את CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED ו-BOOKING_CANCELLED כדי לספק סיבות לסטטוס הראשי של קמפיינים עם שיטת הבידינג FIXED_CPM. |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
שדות חדשים | נוספה תמיכה בגילוי נאות עצמאי לגבי הקטגוריות של מודעות בהזמנה ובפרטי הזמנה לקריאה בלבד. |
Campaign.missing_eu_political_advertising_declaration |
שדה חדש | תמיכה בשאילתות ובסינון של קמפיינים שחסרות בהם הצהרות לגבי השאלה אם הם מכילים פרסום פוליטי שמטורגט לאיחוד האירופי. |
| המרות | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
ערך enum חדש | תמיכה במעקב אחרי משתמשים שצופים במודעה ואחר כך צופים בסרטון מאותו ערוץ. |
| כללי | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
ערך enum חדש / שגיאה | מוחזר כשמנסים לטרגט רק את הקטגוריה "לא ידוע" במאפיינים דמוגרפיים. |
| תמריצים | ||
IncentiveErrorEnum |
ערכי enum חדשים / שגיאות | נוספו שני קודי שגיאה חדשים: MAX_INCENTIVES_REDEEMED ו-ACCOUNT_TOO_OLD. השגיאות האלה יכולות להופיע בבקשות שנשלחות החל מ-11 במרץ 2026. |
| תכנון | ||
GenerateBenchmarksMetrics |
תכונה חדשה | הוספנו תמיכה בפירוט לפי תאריכים באמצעות BreakdownDefinition. |
ReachPlanService.GenerateReachForecast |
ערך enum חדש | הוספנו את GOOGLE_DISPLAY_NETWORK בתור פלטפורמה שאפשר לטרגט בקמפיינים ליצירת ביקוש עם שיטת הבידינג "מקסימום המרות". |
GenerateTrendingInsights |
שדות חדשים | הוספנו מידע על קו מגמה היסטורי ב-TrendInsightDataPoint עד TrendInsights כשמחפשים לפי נושא. |
| דוחות | ||
| מדדים של תדירות החשיפה למשתמשים ייחודיים | שדות חדשים | הוספנו מדדים חדשים שמדווחים כמה משתמשים ראו את המודעה לפחות פעמיים, שלוש, ארבע, חמש או עשר פעמים: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ו-unique_users_ten_plus. |
SearchTermMatchSource |
ערך enum חדש | הוספנו את VERTICAL_ADS_DATA_FEED כדי לתמוך בפידים של נתוני מודעות בענפים ספציפיים, כמו טירגוט ישויות במודעות להזמנת נסיעות. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
שירות או משאב חדש | הוספנו את השירות YouTubeVideoUpload כדי לתמוך בהעלאה ובניהול של סרטונים ב-YouTube, ואת המשאב YouTubeVideoUpload כדי לתמוך באחזור של סטטוס ההעלאה והמטא-נתונים. התכונה הזו נתמכת רק ב-REST ובספריית הלקוח של Python. |
גרסה 23 (28.01.2026)
גרסה 23 של Google Ads API היא גרסה ראשית, והוספנו בה את התכונות החדשות, העדכונים והשינויים המשמעותיים הבאים.
שינויים בתוכנה שעלולים לגרום לכשלים
| מצב התחלתי | המצב החדש | סוג השינוי | הדרכה בנושא הטמעה |
|---|---|---|---|
| מודעות | |||
| מותר לשתף את המודעה | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
שינוי באופן הפעולה | אסור יותר לשתף מודעות בין כמה קבוצות של מודעות. בקשות לשיתוף מודעות יחזירו שגיאת AD_SHARING_NOT_ALLOWED. |
תמיכה ב-CallAd וב-CallAdInfo |
ללא | הסרה | הוסרה התמיכה במודעות לשיחות. מידע נוסף זמין במאמר מידע על מודעות לשיחות במרכז העזרה. |
| קמפיינים | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
שינוי שם או החלפה | השתמשו בשדות החדשים של התאריך והשעה כדי לציין רכיבי זמן בקמפיינים. השדות המקוריים של התאריך בלבד יוסרו. |
| יצירת ביקוש | |||
DemandGenMultiAssetAdInfo.lead_form_only |
ללא | הסרה | השדה lead_form_only הוסר. מעדכנים את ההפניות בקוד. |
| דוחות | |||
| מדדים וערכי enum של תוויות לציון רמת הביצועים של נכסים מצטברים | ללא | הסרה | הסרנו את המדדים המצטברים של תוויות לציון רמת הביצועים של הנכסים. הערך enum של תווית הביצועים לא מוחזר יותר בקמפיינים לרשת החיפוש ולרשת המדיה. |
תכונות ועדכונים (לא קריטיים)
| תכונות ועדכונים | סוג | תיאור |
|---|---|---|
| מודעות | ||
AdFormatType |
ערכי enum חדשים | נוספו סוגי פורמטים חדשים: TEXT, VERTICAL_ADS_BOOKING_LINK ו-VERTICAL_ADS_PROMOTION. |
| נכסים | ||
תצוגת asset_group |
שדות חדשים | הוספנו את המדדים הבאים: metrics.engagements, metrics.engagement_rate ו-metrics.average_cpe. |
תצוגת asset_group_asset |
שדות חדשים | הוספנו את המדדים הבאים: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views ו-metrics.interaction_event_types. |
Asset.orientation |
שדה חדש | שדה כיוון לקריאה בלבד נוסף לנכסי תמונות ווידאו. |
CampaignAsset |
תכונה חדשה | הוספנו תמיכה באחזור נכסים של קמפיינים כשהשדה 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, שמדווחים אם מודעה הייתה שמיעה ובכמה חשיפות ניתן היה למדוד את השמיעוּת. |
נתוני גרסה שהועברו לארכיון
בקטע גרסאות שהוצאו משימוש אפשר למצוא את נתוני הגרסאות שהועברו לארכיון.