יומן שינויים

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

‫18.6.2026 נוספה השיטה UpdateReportingIdentitySettings

‫18-06-2026 הוספת השדה can_edit ל-PropertySummary

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

‫14.4.2026 נוספה השיטה GetUserProvidedDataSettings

‫20.8.2025 נוספה השיטה GetReportingIdentitySettings

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

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

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

‫12-06-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 v1 ביוני 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 נוסף למשאב BigQueryLink.

הוספנו שינויים בקישור ל-BigQuery להיסטוריית השינויים, בערך החדש BIGQUERY_LINK ב-ChangeHistoryResourceType.

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

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

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

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

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

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

הוספת create_time למשאב Audience.

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

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

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

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

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

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

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

מידע נוסף זמין במסמכי התיעוד של הסכימה.

‫15.12.2023 המאפיין accessDateHour נוסף לסכימה של דוח הגישה לנתונים.

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

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

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

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

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

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

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

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

ה-method‏ UpdateConversionEvent נוספה ל-Admin API v1beta.

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

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

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

‫10-07-2023 הוספת השדה ads_web_conversion_data_export_scope לסוג AttributionSettings

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

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

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

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

ה-methods‏ GetAdSenseLink,‏ CreateAdSenseLink,‏ DeleteAdSenseLink ו-ListAdSenseLinks נוספו ל-Admin API v1alpha.

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

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

ה-method‏ FetchConnectedGa4Property נוספה ל-Admin API v1alpha

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

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

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

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

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

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

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

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

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

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

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

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

השיטות properties.createConnectedSiteTag,‏ properties.deleteConnectedSiteTag ו-properties.listConnectedSiteTags נוספו ל-Admin API v1alpha.

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

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

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

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

המשאב 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, וצריך להשתמש בה במקום בקישורי משתמשים.

הפונקציונליות של קישורי משתמשים תוסר מגרסת האלפא של Admin API v1 ב-1 ביוני 2023

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

השיטות הבאות הוצאו משימוש ויוסרו מגרסת אלפא של Admin API v1 ב-1 ביוני 2023:

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.2.2023 שינויים שונים.

11.8.2022 הוספנו את השיטה runAccessReport ל-Admin API v1alpha.

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

‫11.07.2022 הושקה גרסת Admin API v1beta.

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

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

‫12.10.2021 השיטות של EnhancedMeasurementSettings הוסרו מה-API.

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

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

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

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

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

השינויים הבאים עלולים לגרום לכשל:

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

28.1.2021 שינויים בתוכנה שעלולים לגרום לכשלים.

שינויי תוכנה שעלולים לגרום לכשל: - השדה update_mask נדרש לכל פעולות העדכון.

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

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

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

20.10.2020 נוספה תמיכה בסיכומי חשבונות.

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

13.10.2020 השם של נכסי "אפליקציה + אתר" שונה ל-Google Analytics 4 ‏(GA4).

15.8.2020 שינינו את השם של Management App + Web API ל-Admin API.

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