כדי לקבל הודעות רשמיות לגבי Google Analytics API, אתם יכולים להירשם לקבוצת ההודעות של Google Analytics API.
18.6.2026 נוספה השיטה UpdateReportingIdentitySettings
- הוספנו את ה-method
UpdateReportingIdentitySettingsל-Admin API v1alpha, שמאפשרת לעדכן אתReportingIdentitySettingsשל נכס.
18-06-2026 הוספת השדה can_edit ל-PropertySummary
- הוספנו את השדה
can_editלמשאבPropertySummaryב-Admin API בגרסאות v1alpha ו-v1beta. השדה הזה מציין אם למשתמש יש תפקיד ב-Google Analytics שמאפשר לו לשנות את ההגדרות בנכס.
14.4.2026 נוספה השיטה GetUserProvidedDataSettings
הוספנו את השיטה
GetUserProvidedDataSettingsל-Admin API v1alpha, שמאפשרת לאחזר אתUserProvidedDataSettingsשל נכס.הוספנו את המשאב
UserProvidedDataSettingsל-Admin API v1alpha, שכולל את השדותuserProvidedDataCollectionEnabledו-automaticallyDetectedDataCollectionEnabledשל איסוף הפרטים שהמשתמשים סיפקו.
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 הזה כדי שנוכל לשפר אותו.
2024-08-01 נוסף ניהול קישורים ל-BigQuery
הוספנו את השיטות 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.
31 במאי 2023 נוספו שיטות לניהול קישורים ל-AdSense.
ה-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.
24 בפברואר 2023: קישורי גישה מחליפים את הקישורים למשתמשים לצורך ניהול הרשאות משתמשים.
המשאב AccessBinding נוסף לגרסה v1alpha של ה-API, יחד עם הפעולות הבאות:
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
הפונקציונליות הזו מאפשרת לנהל את הרשאות המשתמשים בחשבון או בנכס ב-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.
15.2.2023 הוספנו שיטות לניהול קישורים ל-BigQuery.
המשאב BigQueryLink נוסף לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.bigQueryLinks.get ו-properties.bigQueryLinks.list.
הפונקציונליות הזו מאפשרת לאחזר מידע על קישורים בין נכס GA4 לפרויקט BigQuery.
15.2.2023 נוספו שיטות לניהול קישורים ב-Search Ads 360.
המשאב SearchAds360Link נוסף לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list ו-properties.searchAds360Links.get.
הפונקציונליות הזו מאפשרת לנהל קישורים בין נכס GA4 לבין ישות ב-Search Ads 360.
15 בפברואר 2023 שינויים בתוכנה שעלולים לגרום לכשלים.
הערכים
LESS_THAN_OR_EQUALו-GREATER_THAN_OR_EQUALהוסרו מהטיפוסים בני המנייה (enum) שלNumericFilter.Operation.הערך
PARTIAL_REGEXPהוסר מה-enumStringFilter.MatchType.
15.2.2023 שינויים שונים.
- השדה
tokensPerProjectPerHourנוסף לסוגAccessQuota. - הערכים
EXPANDED_DATA_SETו-CHANNEL_GROUPנוספו לטיפוס המונה (enum)ChangeHistoryResourceType. - הערכים
searchAds360Link,expandedDataSet,bigqueryLinkנוספו אלChangeHistoryResource.
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: - שיטות לניהול מאפיינים מותאמים אישית שנוספו בקטע
properties.customDimensions: - שיטות לניהול מדדים מותאמים אישית שנוספו בקטע
properties.customMetrics: - הוספנו את השיטות
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-01-2021 נוספה תמיכה בעימוד לפעולה ListFirebaseLinks.
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 ושל ספריות הלקוח.