יומן שינויים

כדי לקבל הודעות רשמיות על 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 ב-Admin API v1alpha ו-v1beta. אפשר להשתמש בשדה הזה כדי לאחזר או לשנות את הגדרות השמירה של נתוני משתמשים.

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

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

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

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

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

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

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

‫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 נוספו שיטות לניהול אירועים מרכזיים

משאבים ו-methods לאירועים מרכזיים זמינים עכשיו.

משנים את שילוב ה-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.

‫14 ביולי 2023 שינויי תוכנה שעלולים לגרום לכשלים בשיטות 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.

2023-05-31 נוספה שיטה לחיפוש נכס GA4 מקושר.

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

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

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

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

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

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

נוספו שיטות GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup ל-Admin API v1alpha.

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

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

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

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

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

31.03.2023 נוספו שיטות לניהול תגי אתרים מחוברים.

הוספנו את קודי ה-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 תוסר מגרסת אלפא 1 של Admin API ב-6/1/23

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

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

2023-02-24 נוספו שיטות לניהול קהלים.

הוספנו את המשאב 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.

‫2023-02-15 שינויי תוכנה שעלולים לגרום לכשלים.

‫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, properties.webDataStreams.updateEnhancedMeasurementSettings methods יוסרו מה-API, אבל בקרוב אפשר יהיה לשנות שוב את ההגדרות של המודל המשופר לשיוך (Enhanced Attribution) באמצעות API.
  • השדה directRoles במשאב UserLink לא תומך יותר בתפקיד predefinedRoles/manage-users. במקומו צריך להשתמש בתפקיד החדש predefinedRoles/admin, שהוא שווה ערך לשילוב של התפקידים הישנים predefinedRoles/edit ו-predefinedRoles/manage-users. השינוי הזה משפיע על ההתנהגות של השיטות accounts.userLinks, properties.userLinks והוא תואם לשינויים שבוצעו ב-Google Analytics בנושא ניהול הרשאות גישה והגבלת גישה לנתונים.

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

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

  • השיטה accounts.searchChangeHistoryEvents נוספה ל-API. השיטה הזו מחפשת בכל השינויים שבוצעו בחשבון או בחשבונות הצאצא שלו, בהתאם לקבוצת המסננים שצוינה. הסיבות הנפוצות לכך הן עדכונים שבוצעו בממשק המשתמש של Google Analytics, שינויים שבוצעו על ידי תמיכת הלקוחות או שינויים אוטומטיים במערכת Google Analytics.
  • נוספו שיטות לניהול ערכי API Secret של Measurement Protocol בקטע properties.dataStreams.measurementProtocolSecrets:
    • ‫create יוצרת סוד של Measurement Protocol.
    • ‫delete מחיקת API Secret של Measurement Protocol של היעד.
    • ‫get חיפוש של API Secret יחיד של Measurement Protocol.
    • ‫list מחזירה את ערכי ה-Secret של Measurement Protocol בנכס צאצא של הנכס הראשי שצוין.
    • ‫patch מעדכן את הסוד של 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 שינויי תוכנה שעלולים לגרום לכשלים.

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

  • הוסרו מה-API השיטות properties.iosAppDataStreams.create ו-properties.androidAppDataStreams.create. צריך להשתמש ב-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. צריך לעדכן את הקוד הקיים שנכתב בהתאם לגרסה הקודמת של כתובת ה-URL של נקודת הקצה ל-API ולספריות הלקוח.