להודעות רשמיות של Google Analytics API, תוכלו להירשם לקבוצת התראות של Google Analytics API.
15.12.2023 דוחות גישה לנתונים זמינים עכשיו בכל הנכסים ב-Google Analytics.
חלק מהשדות בתכונה דוחות גישה לנתונים זמינים עכשיו לכל הנכסים ב-Google Analytics, גם ללקוחות רגילים וגם ללקוחות Google Analytics 360.
למידע נוסף, עיינו בתיעוד הסכימה.
15.12.2023 המאפיין accessDateHour
נוסף לסכימה של דוח הגישה לנתונים.
המאפיין accessDateHour
שנוסף לסכימה של דוח הגישה לנתונים. הדוח מכיל את התאריך והשעה שבהם המשתמש ב-Google Analytics ניגש לנתוני הדיווח ב-Google Analytics.
2023-10-05 בנכסים עם מודלים של שיוך מסוג קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום, מוגדרים כברירת מחדל ל-DDA חוצה-ערוצים.
החל מאמצע אוקטובר 2023, המודלים של השיוך (Attribution) קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום לא יהיו זמינים לשימוש עם השיטה UpdateAttributionSettings בכל הנכסים.
אם הנכס מוגדר כרגע לשימוש באחד מהמודלים האלה, הוא ישתנה לשיוך מבוסס-נתונים (DDA) חוצה-ערוצים. עדיין יוצגו לכם האפשרויות להשתמש במקום זאת במודל 'קליק אחרון בכל הערוצים' או 'קליק אחרון עם העדפה ל-Google Ads'.
01-09-2023 נוספו שיטות להגדרת סכימה של ערכי המרות ב-SKAdNetwork.
GetSKAdNetworkConversionValueSchema
,
CreateSKAdNetworkConversionValueSchema
,
DeleteSKAdNetworkConversionValueSchema
,
UpdateSKAdNetworkConversionValueSchema
,
ListSKAdNetworkConversionValueSchemas
נוספו ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל את הגדרת הסכימה של ערכי ההמרות ב-SKAdNetwork עבור מקור נתונים ב-iOS.
01-09-2023 נוספה שיטת UpdateConversionEvent
.
השיטה UpdateConversionEvent
נוספה ל-Admin API v1beta.
השם של השדה BigQueryLink.enterprise_export_enabled
2023-09-01 השתנה ל-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.
שמות החברים בקבוצה 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 |
שמות החברים בקבוצה 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
.
5 ביוני 2023 הוצאה משימוש של מודלים של שיוך מסוג 'קליק ראשון', 'לינארי', 'דעיכה לאורך זמן' ו'מבוסס-מיקום'.
החל מיוני 2023, לא תהיה אפשרות להשתמש בשיטה UpdateAttributionSettings כדי להגדיר נכסי GA4 באמצעות מודלים של שיוך מסוג קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום. החל מספטמבר 2023, המודלים האלה לא יהיו זמינים בכל הנכסים.
תוכלו לקרוא מידע נוסף בהודעה על המוצר Google Analytics.
31.05.2023 נוספו שיטות לניהול קישורים ב-AdSense.
GetAdSenseLink
,
CreateAdSenseLink
,
DeleteAdSenseLink
,
ListAdSenseLinks
נוספו ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל את הקישורים בין AdSense ל-Analytics בנכס GA4.
31.5.2023 נוספה שיטה לחיפוש נכס GA4 מקושר.
השיטה FetchConnectedGa4Property
שנוספה ל-Admin API v1alpha
הפונקציונליות הזו מאפשרת לקבל מידע על נכס GA4 שמקושר לנכס Universal Analytics בתהליך ההעברה מ-GA4.
31.5.2023 נוספה שיטה לניהול כללים ליצירת אירועים.
השיטות CreateEventCreateRule
,
UpdateEventCreateRule
,
DeleteEventCreateRule
,
ListEventCreateRules
,
GetEventCreateRule
שנוספו ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל כללים ליצירת אירועים שיכולים להפעיל יצירה של אירוע חדש לגמרי על סמך קריטריונים תואמים של אירוע המקור.
31.5.2023 נוספו שיטות לניהול קבוצות ערוצים בהתאמה אישית.
נוספו שיטות GetChannelGroup
,
ListChannelGroups
,
CreateChannelGroup
,
UpdateChannelGroup
,
DeleteChannelGroup
ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל קבוצות ערוצים מותאמות אישית עבור מקורות התנועה של האתר.
אחרי שיוצרים קבוצות ערוצים בהתאמה אישית, אפשר להשתמש בהן באמצעות Google Analytics Data API v1.
31.03.2023 נוספו שיטות לניהול של הגדרות מדידה משופרות.
השיטות properties.dataStreams.updateEnhancedMeasurementSettings
, properties.dataStreams.getEnhancedMeasurementSettings
שנוספו ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל את הגדרות המדידה המשופרות של מקור נתוני אתר בנכס GA4.
31.03.2023 נוספו שיטות לניהול תגי אתר מחוברים.
השיטות properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
, properties.listConnectedSiteTags
שנוספו ל-Admin API v1alpha.
הפונקציונליות הזו מאפשרת לנהל תגי אתרים מחוברים, והיא שימושית לצורך העברת תנועה מנכס Universal Analytics אל נכס Google Analytics 4.
31.03.2023 נוספו שיטות runAccessReport
ברמת החשבון או ברמת הנכס לגרסת הבטא של Admin API.
השיטות properties.runAccessReport
ו-accounts.runAccessReport
שנוספו לגרסת v1beta של Admin API. השיטות מחזירות דוח מותאם אישית של רשומות גישה לנתונים.
24.02.2023 נוספו שיטות לניהול של קבוצות נתונים מורחבות.
המשאב ExpandedDataSet
נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות המתאימות properties.expandedDataSets.create
,
properties.expandedDataSets.delete
, properties.expandedDataSets.patch
, properties.expandedDataSets.list
,
properties.expandedDataSets.get
. ניתן להשתמש בפונקציונליות הזו לניהול קבוצות נתונים מורחבות ב-Google Analytics 360.
24.02.2023 'קישורי גישה' מחליפים את קישורי המשתמשים לצורך ניהול הרשאות המשתמשים.
המשאב AccessBinding
נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות הבאות:
accounts.accessBindings.create
accounts.accessBindings.delete
accounts.accessBindings.patch
accounts.accessBindings.list
accounts.accessBindings.get
accounts.accessBindings.batchCreate
accounts.accessBindings.batchDelete
accounts.accessBindings.batchUpdate
accounts.accessBindings.batchGet
properties.accessBindings.create
properties.accessBindings.delete
properties.accessBindings.patch
properties.accessBindings.list
properties.accessBindings.get
properties.accessBindings.batchCreate
properties.accessBindings.batchDelete
properties.accessBindings.batchUpdate
properties.accessBindings.batchGet
הפונקציונליות הזו מאפשרת לנהל את הרשאות המשתמשים בחשבון או בנכס GA4, וצריך להשתמש בה במקום להשתמש בקישורי משתמש.
הפונקציונליות User Links תוסר מ-Admin API v1 alpha ב-1.6.23
24.02.2023 הוצאה משימוש של שיטות הבדיקה של הרשאות המשתמשים.
השיטות הבאות הוצאו משימוש ויוסרו מ-Admin API v1 אלפא ב-1.6.23:
24.02.2023 נוספו שיטות לניהול קהלים.
המשאב Audience
נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות המתאימות properties.audience.create
,
properties.audience.archive
, properties.audience.patch
, properties.audience.list
,
properties.audience.get
.
הפונקציונליות הזו מאפשרת לנהל קהלים בנכס GA4.
15.02.2023 נוספו שיטות לביטול הסכמה לתהליך ההגדרה האוטומטי של GA4.
properties.setAutomatedGa4ConfigurationOptOut
, פעולות properties.fetchAutomatedGa4ConfigurationOptOut
נוספו לגרסת v1alpha של ה-API.
הפונקציונליות הזו מאפשרת לנהל את סטטוס ביטול ההסכמה לתהליך ההגדרה האוטומטי של GA4 בנכס UA.
15.02.2023 נוספו שיטות לניהול קישורים ל-BigQuery.
המשאב BigQueryLink
נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות properties.bigQueryLinks.get
ו-properties.bigQueryLinks.list
התואמות.
הפונקציונליות הזו מאפשרת לאחזר מידע על קישורים בין נכס GA4 לפרויקט BigQuery.
15.02.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.2.2023 שינויי תוכנה שעלולים לגרום לכשלים.
LESS_THAN_OR_EQUAL
, ערכיGREATER_THAN_OR_EQUAL
הוסרו מהטיפוסNumericFilter.Operation
.הערך
PARTIAL_REGEXP
הוסר מהטיפוסיםStringFilter.MatchType
.
15.02.2023 שינויים שונים.
- נוסף שדה
tokensPerProjectPerHour
לסוגAccessQuota
. EXPANDED_DATA_SET
,CHANNEL_GROUP
נוספו לערכים שלChangeHistoryResourceType
.- הערכים
searchAds360Link
,expandedDataSet
,bigqueryLink
נוספו ל-ChangeHistoryResource
.
11.08.2022 runAccessReport
נוספה אל Admin API v1alpha.
השיטה properties.runAccessReport
שנוספה לגרסת v1alpha של Admin API. הוא מחזיר דוח מותאם אישית של רשומות גישה לנתונים. הדוח מספק תיעוד של כל פעם שמשתמש קורא נתוני דיווח של Google Analytics. דוחות הגישה לנתונים זמינים לאדמינים של נכסי Google Analytics 360.
11.07.2022: גרסת בטא של Admin API הושקה.
הושקה גרסת v1beta של Google Analytics Admin API.
ה-Admin API עדיין תומך בערוצי אלפא ובטא של ה-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:
- השיטה
accounts.searchChangeHistoryEvents
נוספה ל-API. השיטה הזו מחפשת את כל השינויים בחשבון או בחשבונות הצאצא שלו על סמך קבוצת המסננים שצוינה. סיבות נפוצות הן עדכונים שיבוצעו בממשק המשתמש של Google Analytics, שינויים מתמיכת הלקוחות או שינויים אוטומטיים במערכת של Google Analytics. - שיטות לניהול סודות ב-Measurement Protocol שנוספו במסגרת
properties.webDataStreams.measurementProtocolSecrets
: - שיטות לניהול אירועי המרה שנוספו במסגרת
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.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 נוספה תמיכה בסיכומי חשבונות.
נוספה תמיכה בשיטת סיכומי החשבון.
13 באוקטובר 2020: השם של נכסי אפליקציה + אתר השתנה ל-Google Analytics 4 (GA4).
15 באוגוסט 2020: שם ה-API לניהול של אפליקציות + אתרים השתנה ל-Admin API.
שינינו את השם של ה-Management App + Web API של Google Analytics ועכשיו הוא נקרא Google Analytics Admin API. כתוצאה מכך, נקודת הקצה של ה-API השתנתה ל-analyticsadmin.googleapis.com. צריך לעדכן בהתאם את הקוד הקיים שנכתב על הגרסה הקודמת של כתובת ה-URL של נקודת הקצה ב-API ואת ספריות הלקוח בהתאם.