יומן שינויים

כדי לקבל הודעות רשמיות על Google Analytics API, אפשר להירשם לקבוצת Google Analytics API Notify.

‫18 ביוני 2026 נוסף אמצעי התשלום UpdateReportingIdentitySettings

‫2026-06-18 נוסף השדה can_edit אל PropertySummary

  • הוספנו את השדה can_edit למשאב PropertySummary ב-Admin API v1alpha ו-v1beta. השדה הזה מציין אם למשתמש יש תפקיד ב-Google Analytics שמאפשר לו לשנות את ההגדרות בנכס.

‫14 באפריל 2026 נוסף אמצעי התשלום GetUserProvidedDataSettings

2025-08-20 נוספה שיטה GetReportingIdentitySettings

הוספנו את השיטה GetReportingIdentitySettings ל-Admin API v1alpha, שמאפשרת לאחזר את ReportingIdentitySettings של נכס.

‫2025-08-20 הוסרו שיטות מדור קודם של Universal Analytics

השיטות הבאות של Universal Analytics (UA) מהדור הקודם הוסרו מ-Admin API v1alpha: ‏ SetAutomatedGa4ConfigurationOptOut,‏ FetchAutomatedGa4ConfigurationOptOut,‏ CreateConnectedSiteTag,‏ DeleteConnectedSiteTag,‏ ListConnectedSiteTags ו-FetchConnectedGa4Property.

‫12 ביוני 2025 נוספו שיטות לניהול הגדרות הסנכרון של נכסי משנה

נוספו השיטות GetSubpropertySyncConfig,‏ ListSubpropertySyncConfig ו-UpdateSubpropertySyncConfig לניהול משאבי SubpropertySyncConfig באמצעות Admin API v1alpha.

‫16 באפריל 2025 נוספו שיטות לניהול הערות על נתוני דיווח

נוספו השיטות CreateReportingDataAnnotation,‏ GetReportingDataAnnotation,‏ ListReportingDataAnnotations,‏ UpdateReportingDataAnnotation ו-DeleteReportingDataAnnotation לניהול משאבי ReportingDataAnnotation באמצעות Admin API v1alpha.

הערות מאפשרות למשתמשים להוסיף הערות ישירות לדוחות של Google Analytics. ככה יהיה לכם קל יותר לתעד אירועים, להבין למה קורים שינויים בנתונים או להדגיש תובנות שחשובות לכם ולצוות שלכם.

‫2025-03-07 הוצאה משימוש של הפרמטר sharingWithGoogleAnySalesEnabled

הפרמטר sharingWithGoogleAnySalesEnabled של ה-method‏ getDataSharingSettings הוצא משימוש ועכשיו הוא תמיד מחזיר false. השדה יוסר מ-Google Analytics Admin API v1beta ביוני 2025.

‫2025-01-20 נוספה שמירת נתוני משתמשים ל-DataRetentionSettings

הוספנו את השדה userDataRetention אל DataRetentionSettings בגרסאות v1alpha ו-v1beta של Admin API. בשדה הזה אפשר לאחזר או לשנות את הגדרות השמירה של נתוני משתמשים.

2024-09-09 טופס סקר בנושא דוחות גישה

עדכנו את התיעוד של השיטה runAccessReport כדי לכלול קישור לטופס משוב על דוחות גישה של Google Analytics. אנחנו מעריכים את המשוב שלכם ומעודדים אתכם לשתף את המחשבות שלכם על ה-API הזה כדי לעזור לנו לשפר אותו עוד יותר.

נוספו השיטות CreateBigQueryLink, ‏UpdateBigQueryLink ו-DeleteBigQueryLink לניהול משאבי BigQueryLink באמצעות Admin API v1alpha.

השדה dataset_location נוסף למשאב BigQueryLink.

הוספנו שינויים בקישור ל-BigQuery להיסטוריית השינויים בקטע BIGQUERY_LINK value in ChangeHistoryResourceType.

‫2024-08-01 שינוי בתוכנה שעלול לגרום לכשלים בשיטה createSubproperty

שינינו את השם של createSubproperty custom method ל-provisionSubproperty ב-Admin API v1alpha כדי להתאים להנחיות בנושא custom method.

‫2024-08-01 נוסף ניהול של כללי עריכה של אירועים

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, נוספו שיטות ל-Admin API v1alpha.

EventEditRule מגדיר תנאים שיפעילו יצירה של אירוע חדש לגמרי על סמך קריטריונים תואמים של אירוע מקור. בנוסף, EventEditRule יכול להגדיר שינויים בפרמטרים מאירוע המקור.

‫2024-08-01 שינויים שונים

המשתמש create_time הוסיף את המשאב Audience.

הוספנו את primary למשאב ChannelGroup כדי לציין אם קבוצת הערוצים היא קבוצת הערוצים שמוגדרת כברירת מחדל בדוחות. רק קבוצת ערוצים אחת יכולה להיות מוגדרת עם הערך primary ל-true בכל זמן נתון. הגדרת הערך primary ל-true עבור קבוצת ערוצים מסוימת מגדירה באופן אוטומטי את הערך primary ל-false עבור קבוצת הערוצים הראשית הקודמת.

נוסף gmp_organization למשאב Account, שמכיל את ה-URI של משאב ארגון ב-Google Marketing Platform אם החשבון מקושר לארגון GMP.

‫2024-05-06 נוספו שיטות לניהול אירועים מרכזיים

עכשיו זמינים משאבים ושיטות לאירועים מרכזיים.

משנים את שילוב ה-API כך שישתמש ב-KeyEvent במקום ב-ConversionEvent. התכונה ConversionEvent יצאה משימוש.

‫15 בדצמבר 2023 דוחות גישה לנתונים זמינים עכשיו לכל הנכסים ב-Google Analytics.

שדות מסוימים בתכונה דוחות גישה לנתונים זמינים עכשיו לכל הנכסים ב-Google Analytics, גם ללקוחות של הגרסה הרגילה וגם ללקוחות של Google Analytics 360.

מידע נוסף זמין במאמרי העזרה בנושא סכימה.

2023-12-15 המאפיין accessDateHour נוסף לסכימת הדוח 'גישה לנתונים'.

המאפיין accessDateHour שנוסף לסכימת דוח הגישה לנתונים. הוא מכיל את השעה בתאריך שבו המשתמש ב-GA ניגש לנתוני הדיווח ב-GA.

2023-10-05 בנכסים שמוגדרים בהם מודלים של שיוך (Attribution) מסוג 'קליק ראשון', 'לינארי', 'דעיכה לאורך זמן' ו'מבוסס-מיקום', מודל השיוך שמוגדר כברירת מחדל הוא DDA חוצה-ערוצים.

החל מאמצע אוקטובר 2023, לא תהיה יותר אפשרות להשתמש במודלים של שיוך (Attribution) מסוג קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום עם השיטה UpdateAttributionSettings בכל הנכסים.

אם הנכס שלכם מוגדר כרגע לשימוש באחד מהמודלים האלה, הוא ישתנה לשיוך מבוסס-נתונים (DDA) חוצה-ערוצים. עדיין תוכלו להשתמש במודלים 'קליק אחרון בכל הערוצים' או 'קליק אחרון עם העדפה ל-Google Ads'.

‫2023-09-01 נוספו שיטות להגדרת סכימה להקצאת ערכי המרות ב-SKAdNetwork.

‫GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas נוספו שיטות ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל את ההגדרה של הסכימה להקצאת ערכי המרות ב-SKAdNetwork עבור מקור נתונים מסוג iOS.

‫2023-09-01 נוספה שיטת UpdateConversionEvent.

השיטה UpdateConversionEvent נוספה ל-Admin API v1beta.

‫2023-09-01 השם של השדה BigQueryLink.enterprise_export_enabled שונה ל-fresh_daily_export_enabled.

השדה enterprise_export_enabled במשאב BigQueryLink שונה לשם fresh_daily_export_enabled.

‫2023-07-14 שינויים בתוכנה שעלולים לגרום לכשלים בשיטות properties.updateAttributionSettings ו-properties.getAttributionSettings.

החל מ-24 ביולי 2023, יבוצעו שינויי תוכנה שעלולים לגרום לכשל בגרסת אלפא 1 של Admin API, שישפיעו על הפונקציונליות של השיטות properties.getAttributionSettings ו-properties.updateAttributionSettings.

השמות של חברי ה-enum‏ ReportingAttributionModel ישתנו באופן הבא:

שם ישן שם חדש
CROSS_CHANNEL_DATA_DRIVEN PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK GOOGLE_PAID_CHANNELS_LAST_CLICK

השמות של חברי ה-enum‏ AdsWebConversionDataExportScope ישתנו באופן הבא:

שם ישן שם חדש
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

‫2023-07-10 נוסף השדה ads_web_conversion_data_export_scope לסוג AttributionSettings

הוספנו את השדה ads_web_conversion_data_export_scope לסוג AttributionSettings שאפשר לשנות באמצעות השיטה UpdateAttributionSettings.

‫5 ביוני 2023 הוצאה משימוש של המודלים הבאים של שיוך (Attribution): קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום.

החל מיוני 2023, אי אפשר להשתמש בשיטה UpdateAttributionSettings כדי להגדיר נכסי GA4 עם המודלים הבאים של שיוך (Attribution): קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום. החל מספטמבר 2023, המודלים האלה לא יהיו זמינים יותר לכל הנכסים.

מידע נוסף זמין בהודעה על המוצר Google Analytics.

‫GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks נוספו ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל קישורים מ-AdSense ל-Analytics עבור נכס GA4.

31.5.2023 נוספה שיטה לחיפוש נכס GA4 מקושר.

השיטה FetchConnectedGa4Property נוספה ל-Admin API v1alpha

הפונקציונליות הזו מאפשרת לקבל מידע על נכס GA4 שמקושר לנכס Universal Analytics במהלך תהליך ההעברה ל-GA4.

31.5.2023 נוספה שיטה לניהול כללים ליצירת אירועים.

הוספנו את ה-methods‏ CreateEventCreateRule,‏ UpdateEventCreateRule,‏ DeleteEventCreateRule,‏ ListEventCreateRules ו-GetEventCreateRule ל-Admin API v1alpha.

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

31 במאי 2023 נוספו שיטות לניהול קבוצות ערוצים בהתאמה אישית.

נוספו שיטות GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup ל-Admin API בגרסת אלפא 1.

הפונקציונליות הזו מאפשרת לנהל קבוצות ערוצים מותאמות אישית של מקורות התנועה של האתר.

אחרי שיוצרים קבוצות של ערוצים מותאמים אישית, אפשר לשלוח להן שאילתות באמצעות Google Analytics Data API v1.

‫2023-03-31 נוספו שיטות לניהול הגדרות של מדידה משופרת.

הוספנו את השיטות properties.dataStreams.updateEnhancedMeasurementSettings ו-properties.dataStreams.getEnhancedMeasurementSettings לגרסה v1alpha של Admin API.

הפונקציונליות הזו מאפשרת לנהל את ההגדרות של מדידה משופרת במקור לנתוני אתר של נכס GA4.

‫2023-03-31 נוספו שיטות לניהול תגי אתרים מחוברים.

הוספנו את קודי ה-method‏ properties.createConnectedSiteTag,‏ properties.deleteConnectedSiteTag ו-properties.listConnectedSiteTags ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל תגי אתר מחוברים והיא שימושית להעברת תנועה מנכס Universal Analytics לנכס Google Analytics 4.

‫2023-03-31 נוספו שיטות runAccessReport ברמת החשבון והנכס ל-Admin API v1beta.

ה-methods‏ properties.runAccessReport ו-accounts.runAccessReport נוספו לגרסה v1beta של Admin API. השיטות מחזירות דוח מותאם אישית של רשומות גישה לנתונים.

2023-02-24 נוספו שיטות לניהול קבוצות נתונים מורחבות.

הוספנו את המשאב ExpandedDataSet לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.expandedDataSets.create,‏ properties.expandedDataSets.delete,‏ properties.expandedDataSets.patch,‏ properties.expandedDataSets.list ו-properties.expandedDataSets.get. אפשר להשתמש בפונקציונליות הזו כדי לנהל קבוצות נתונים מורחבות ב-Google Analytics 360.

הוספנו את רכיב AccessBinding לגרסה v1alpha של ה-API, יחד עם הפעולות הבאות:

הפונקציונליות הזו מאפשרת לנהל את הרשאות המשתמשים בחשבון או בנכס GA4, וצריך להשתמש בה במקום בקישורי משתמשים.

הפונקציונליות של User Links (קישורי משתמשים) תוסר מ-Admin API v1 alpha ב-6/1/23

2023-02-24 הוצאה משימוש של שיטות לביקורת הרשאות משתמשים.

השיטות הבאות הוצאו משימוש ויוסרו מ-Admin API v1 alpha ב-6/1/23:

24 בפברואר 2023 נוספו שיטות לניהול קהלים.

הוספנו את המשאב Audience לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.audience.create,‏ properties.audience.archive,‏ properties.audience.patch,‏ properties.audience.list ו-properties.audience.get.

הפונקציונליות הזו מאפשרת לנהל קהלים בנכס GA4.

15 בפברואר 2023 נוספו שיטות לביטול ההסכמה לתהליך ההגדרה האוטומטית של GA4.

הוספנו את הפעולות properties.setAutomatedGa4ConfigurationOptOut ו-properties.fetchAutomatedGa4ConfigurationOptOut לגרסה v1alpha של ה-API.

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

הוספנו את רכיב המשאב BigQueryLink לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.bigQueryLinks.get ו-properties.bigQueryLinks.list.

הפונקציונליות הזו מאפשרת לאחזר מידע על קישורים בין נכס GA4 לבין פרויקט BigQuery.

הוספנו את המשאב SearchAds360Link לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.searchAds360Links.create,‏ properties.searchAds360Links.delete,‏ properties.searchAds360Links.patch,‏ properties.searchAds360Links.list ו-properties.searchAds360Links.get.

הפונקציונליות הזו מאפשרת לנהל קישורים בין נכס GA4 לבין ישות ב-Search Ads 360.

15 בפברואר 2023 שינויים בתוכנה שעלולים לגרום לכשלים.

‫15 בפברואר 2023 שינויים שונים.

  • נוסף שדה tokensPerProjectPerHour לסוג AccessQuota
  • הערכים EXPANDED_DATA_SET ו-CHANNEL_GROUP נוספו לטיפוס הנתונים ChangeHistoryResourceType מסוג enum.
  • הערכים searchAds360Link,‏ expandedDataSet ו-bigqueryLink נוספו ל-ChangeHistoryResource.

‫11.08.2022 נוסף קוד method‏ runAccessReport ל-Admin API v1alpha.

ה-method‏ properties.runAccessReport נוסף לגרסה v1alpha של Admin API. היא מחזירה דוח בהתאמה אישית של רשומות גישה לנתונים. בדוח מופיעים רשומות של כל פעם שמשתמש קורא נתוני דיווח של Google Analytics. דוחות גישה לנתונים זמינים לאדמינים בנכסי Google Analytics 360.

‫11 ביולי 2022: גרסה v1beta של Admin API הושקה.

השקנו את גרסה v1beta של Google Analytics Admin API.

אנחנו ממשיכים לתמוך בערוצי אלפא ובטא של Admin API. ערוץ הבטא מכיל קבוצת משנה של התכונות שזמינות בגרסת אלפא, שנחשבות ליציבות ולא צפויות לעבור שינוי משמעותי בעתיד. תכונות חדשות יתווספו לגרסת הבטא כשהן יהיו מוכנות.

‫2021-10-12 הוסרו מה-API השיטות EnhancedMeasurementSettings.

  • ‫properties.webDataStreams.getEnhancedMeasurementSettings,‏ ה-methods של properties.webDataStreams.updateEnhancedMeasurementSettings יוסרו מה-API, אבל בקרוב אפשר יהיה לשנות שוב את ההגדרות של המודל המשופר לשיוך (EMA) באמצעות API.
  • השדה directRoles במשאב UserLink לא תומך יותר בתפקיד predefinedRoles/manage-users. במקומו צריך להשתמש בתפקיד החדש predefinedRoles/admin, שהוא שווה ערך לשילוב של התפקידים הישנים predefinedRoles/edit ו-predefinedRoles/manage-users. השינוי הזה משפיע על ההתנהגות של השיטות accounts.userLinks, properties.userLinks והוא תואם לשינויים שבוצעו ב-Google Analytics בנושא ניהול הרשאות גישה והגבלת גישה לנתונים.

‫2021-06-05 נוספו תכונות.

התכונות הבאות נוספו ל-API:

  • ה-method ‏accounts.searchChangeHistoryEvents נוספה ל-API. השיטה הזו מחפשת בכל השינויים שבוצעו בחשבון או בחשבונות הצאצא שלו, בהתאם לקבוצת המסננים שצוינה. הסיבות הנפוצות לכך הן עדכונים שבוצעו בממשק המשתמש של Google Analytics, שינויים שבוצעו על ידי תמיכת הלקוחות או שינויים אוטומטיים במערכת Google Analytics.
  • נוספו שיטות לניהול ערכי API Secret של Measurement Protocol בקטע properties.dataStreams.measurementProtocolSecrets:
    • ‫create יוצרת סוד של Measurement Protocol.
    • ‫delete מחיקת הסוד של Measurement Protocol ביעד.
    • ‫get חיפוש של ערך API Secret יחיד של Measurement Protocol.
    • ‫list מחזירה ערכי API Secret של Measurement Protocol של נכס משני מתחת לנכס הראשי שצוין.
    • ‫patch מעדכן ערך API Secret של Measurement Protocol.
  • הוספנו שיטות לניהול אירועי המרה בקטע properties.conversionEvents:
    • ‫create יוצר אירוע המרה עם המאפיינים שצוינו.
    • delete מחיקה של אירוע המרה בנכס.
    • ‫get אחזור של אירוע המרה יחיד.
    • ‫list מחזירה רשימה של אירועי המרה בנכס האב שצוין.
  • הוספנו שיטות לניהול מאפיינים מותאמים אישית בקטע properties.customDimensions:
    • ‫archive מעבירה לארכיון מאפיין מותאם אישית בנכס.
    • ‫create יוצר מאפיין מותאם אישית.
    • ‫get חיפוש של מאפיין מותאם אישית יחיד.
    • ‫list מציג רשימה של מאפיינים מותאמים אישית בנכס.
    • patch מעדכן מאפיין מותאם אישית בנכס.
  • הוספנו שיטות לניהול מדדים מותאמים אישית בקטע properties.customMetrics:
    • ‫archive מעבירה לארכיון מדד מותאם אישית בנכס.
    • ‫create יצירת מדד מותאם אישית.
    • ‫get חיפוש של מדד מותאם אישית יחיד.
    • ‫list מציג רשימה של מדדים מותאמים אישית בנכס.
    • ‫patch מעדכן מדד מותאם אישית בנכס.
  • הוספנו את השיטות properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings שמאפשרות לשלוט בהגדרה Google Signals בנכס Google Analytics 4.
  • ‫delete_time, expire_time שדות של פלט בלבד נוספו לסוג Property.

2021-06-05 שינויים בתוכנה שעלולים לגרום לכשלים.

השינויים הבאים שעלולים לשבור את התאימות הוצגו:

  • ‫properties.iosAppDataStreams.create, properties.androidAppDataStreams.create הוסרו מה-API. צריך להשתמש ב-Firebase כדי ליצור מקורות לנתוני האפליקציה בנכס Google Analytics 4.
  • השיטה properties.delete מחזירה עכשיו את נתוני הנכס שנמחק כסוג Property במקום להחזיר תשובה ריקה.
  • השדה time_zone בסוג Property מוגדר עכשיו כשדה חובה.
  • השדה deleted הוסר מהסוג Property
  • השדה email_address של הסוג UserLink הוא עכשיו בלתי ניתן לשינוי.
  • name השדה של הסוג UserLink הוא עכשיו פלט בלבד.

2021-01-28 שינויים בתוכנה שעלולים לגרום לכשלים.

שינויים שעלולים לשבור את התאימות לאחור: – השדה update_mask נדרש לכל פעולות העדכון.

  • השם של השדה country_code שונה ל-region_code ב-Account.

  • השם של השדה url_query_parameter שונה ל-uri_query_parameter ב-EnhancedMeasurementSettings.

  • השדה parent הוסר מ-GoogleAdsLink.

2020-10-20 נוספה תמיכה בסיכומי חשבונות.

הוספנו תמיכה בשיטה account summaries.

‫13 באוקטובר 2020: נכסי 'אפליקציה + אתר' שינו את שמם ל-Google Analytics 4‏ (GA4).

‫15 באוגוסט 2020: שינינו את השם של Management App + Web API ל-Admin API.

השם של Google Analytics Management אפליקציה + אתר API שונה ל-Google Analytics Admin API. כתוצאה מכך, נקודת הקצה של ה-API השתנתה ל-analyticsadmin.googleapis.com. צריך לעדכן בהתאם קוד קיים שנכתב בהתאם לגרסה הקודמת של כתובת נקודת הקצה של ה-API וספריות הלקוח.