יומן שינויים

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

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

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

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

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

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

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

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

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

5 באוקטובר 2023 בנכסים שמוגדרים בהם מודלים של שיוך (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.

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.

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

הוספנו את קודי ה-methods‏ properties.dataStreams.updateEnhancedMeasurementSettings ו-properties.dataStreams.getEnhancedMeasurementSettings ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל את ההגדרות של מדידה משופרת במקור לנתוני אתר של נכס 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 תוסר מגרסת אלפא 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.

‫2023-02-15 נוספו שיטות לביטול ההסכמה לתהליך ההגדרה האוטומטית של 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 בנושא ניהול הרשאות גישה והגבלת גישה לנתונים.

‫5 ביוני 2021 נוספו תכונות.

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

  • השיטה accounts.searchChangeHistoryEvents נוספה ל-API. השיטה הזו מחפשת בכל השינויים שבוצעו בחשבון או בצאצאים שלו, בהתאם לקבוצת המסננים שצוינה. הסיבות הנפוצות לכך הן עדכונים שבוצעו בממשק המשתמש של Google Analytics, שינויים שבוצעו על ידי תמיכת הלקוחות או שינויים אוטומטיים במערכת Google Analytics.
  • נוספו שיטות לניהול ערכי API Secret של Measurement Protocol בקטע properties.webDataStreams.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: שינינו את השם של אפליקציה + אתר Web API ל-Admin API.

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