יומן שינויים

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

‫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 של השיטה 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.

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

‫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, יבוצעו שינויים שעלולים לשבור את התאימות בגרסת האלפא של Admin API v1, שישפיעו על הפונקציונליות של השיטות 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.

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.

השיטות 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:

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.

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

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

‫11 באוגוסט 2022 נוסף קוד method‏ runAccessReport ל-Admin API v1alpha.

השיטה 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, אבל בקרוב אפשר יהיה לשנות שוב את ההגדרות של המודל המשופר לשיוך (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.webDataStreams.measurementProtocolSecrets:
    • ‫create יוצרת סוד של Measurement Protocol.
    • ‫delete מחיקת ערך API Secret של Measurement Protocol.
    • get חיפוש של API Secret יחיד של Measurement Protocol.
    • ‫list מחזירה את ערכי ה-API 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 Management App + Web API שונה ל-Google Analytics Admin API. כתוצאה מכך, נקודת הקצה של ה-API השתנתה ל-analyticsadmin.googleapis.com. צריך לעדכן את הקוד הקיים שנכתב בהתאם לגרסה הקודמת של כתובת ה-URL של נקודת הקצה של ה-API ולספריות הלקוח.