דף זה תורגם על ידי Cloud Translation API.

יומן שינויים

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

2025-01-20 הוספת שימור של נתוני משתמשים ל-`DataRetentionSettings`

הוספנו את השדה userDataRetention ל-DataRetentionSettings ב-Admin API בגרסאות v1alpha ו-v1beta. אפשר להשתמש בשדה הזה כדי לאחזר או לשנות את הגדרות השמירה של נתוני המשתמשים.

2024-09-09 טופס הסקר בנושא דוחות גישה

המסמך של השיטה runAccessReport עודכן ונוסף לו קישור לטופס משוב על דוחות הגישה של Google Analytics. אנחנו מעריכים את המשוב שלכם, ונשמח לשמוע את דעתכם על ה-API הזה כדי שנוכל לשפר אותו עוד יותר.

01 באוגוסט 2024 נוספה ניהול קישורים ל-BigQuery

נוספו השיטות CreateBigQueryLink,‏ UpdateBigQueryLink ו-DeleteBigQueryLink לניהול משאבי BigQueryLink באמצעות Admin API v1alpha.

נוסף השדה dataset_location למשאב BigQueryLink.

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

2024-08-01 שינוי תוכנה שעלול לגרום לכשל בשיטה `createSubproperty`

שינינו את השם של השיטה המותאמת אישית createSubproperty ל-provisionSubproperty ב-Admin API v1alpha, בהתאם להנחיות לגבי שיטות בהתאמה אישית.

01 באוגוסט 2024 נוספה ניהול של כללי עריכת אירועים

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.

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

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

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

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

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

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

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

השיטה UpdateConversionEvent נוספה ל-Admin API v1beta.

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

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

2023-07-14 שינויי תוכנה שעלולים לגרום לכשלים בשיטות `properties.updateAttributionSettings` ו-`properties.getAttributionSettings`.

החל מ-24 ביולי 2023, יבוצעו שינויים משמעותיים ב-Admin API v1 alpha שישפיעו על הפונקציונליות של השיטות 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`

2023-07-10 נוספה השדה `ads_web_conversion_data_export_scope` לסוג `AttributionSettings`

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

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

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

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

31 במאי 2023 נוספו שיטות לניהול קישורי AdSense.

שיטות GetAdSenseLink,‏ CreateAdSenseLink,‏ DeleteAdSenseLink ו-ListAdSenseLinks נוספו ל-Admin API v1alpha.

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

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

השיטה FetchConnectedGa4Property נוספה ל-Admin API v1alpha

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

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

השיטות 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 במרץ 2023 נוספו שיטות `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.

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

המשאב AccessBinding נוסף לגרסה v1alpha של ה-API, יחד עם הפעולות הבאות:

הפונקציונליות הזו מאפשרת לנהל את הרשאות המשתמשים בחשבון GA4 או בנכס, וצריך להשתמש בה במקום בקישורי משתמשים.

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

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

השיטות הבאות הוצאו משימוש ויוסרו מ-Admin API v1alpha ב-1 ביוני 2023:

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.

2023-02-15 נוספו שיטות לניהול קישורים ל-BigQuery.

המשאב BigQueryLink נוסף לגרסה v1alpha של ה-API, יחד עם הפעולות התואמות properties.bigQueryLinks.get ו-properties.bigQueryLinks.list.

הפונקציה הזו מאפשרת לאחזר מידע על קישורים בין נכס GA4 לפרויקט BigQuery.

2023-02-15 נוספו שיטות לניהול קישורים ב-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.

2023-02-15 שינויים שעלולים לגרום לכשלים.

הערכים LESS_THAN_OR_EQUAL ו-GREATER_THAN_OR_EQUAL הוסרו מה-enum‏ NumericFilter.Operation.
הערך PARTIAL_REGEXP הוסר מהממשק StringFilter.MatchType.

2023-02-15 שינויים שונים.

שדה tokensPerProjectPerHour נוסף לסוג AccessQuota.
הערכים EXPANDED_DATA_SET ו-CHANNEL_GROUP נוספו למערך הערכים של ChangeHistoryResourceType.
הערכים searchAds360Link, expandedDataSet, bigqueryLink נוספו ל-ChangeHistoryResource.

11 באוגוסט 2022 נוספה השיטה `runAccessReport` ל-Admin API v1alpha.

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

11 ביולי 2022 השקנו את גרסת v1beta של Admin API.

גרסה v1beta של Google Analytics Admin API זמינה עכשיו.

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

12 באוקטובר 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 ביוני 2021 נוספו תכונות.

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

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

השינויים המשמעותיים הבאים נוספו:

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

2021-01-28 נוספה תמיכה בחלוקה לדפים עבור הפעולה `ListFirebaseLinks`.

2021-01-28 שינויים שעלולים לגרום לכשלים.

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

השם של השדה country_code השתנה ל-region_code ב-Account.
השם של השדה url_query_parameter השתנה ל-uri_query_parameter ב-EnhancedMeasurementSettings.
השדה parent הוסר מ-GoogleAdsLink.

20 באוקטובר 2020 נוספה תמיכה בסיכומי חשבון.

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

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 ושל ספריות הלקוח.