יומן שינויים

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

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

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

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

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

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

01.08.2024 שינוי תוכנה שעלול לגרום לכשלים ב-method createSubproperty

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

01.08.2024 נוסף ניהול כללים לעריכת אירועים

GetEventEditRule CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, methods שנוספו ל-Admin API v1alpha.

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

01.08.2024 שינויים שונים

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

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

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

6.05.2024 נוספו שיטות לניהול אירועים מרכזיים

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

שינוי שילוב ה-API לשימוש KeyEvent במקום ConversionEvent האפשרות ConversionEvent הוצאה משימוש.

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

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

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

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

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

5.10.2023 בנכסים עם מודלים של שיוך מסוג קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום מוגדר כברירת מחדל לשיוך DDA חוצה-ערוצים.

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

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

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

GetSKAdNetworkConversionValueSchema CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas methods שנוספו ל-Admin API v1alpha.

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

01.09.2023 נוספה שיטת UpdateConversionEvent.

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

11.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 methods.

החל מ-24 ביולי 2023, יבוצעו שינויי תוכנה שעלולים לגרום לכשלים ב-Admin API v1. שישפיע על הפונקציונליות של properties.getAttributionSettings, properties.updateAttributionSettings שיטות.

חברים ב-ReportingAttributionModel השם של 'טיפוסים בני מנייה (enum)' ישתנה כך:

שם ישן שם חדש
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 השם של 'טיפוסים בני מנייה (enum)' ישתנה כך:

שם ישן שם חדש
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 לא ניתן להשתמש ב-method כדי להגדיר נכסי GA4 עם קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום מודלים של שיוך. החל מספטמבר 2023, המודלים האלה יהפכו לא זמין לכל הנכסים.

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

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

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

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

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

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

31.05.2023 נוספה שיטה לניהול כללים ליצירת אירועים.

CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule נוספו לגרסה 1alpha של Admin API.

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

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

ההוספה של GetChannelGroup בוצעה, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup ל-Admin API בגרסה 1alpha.

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

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

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

ה-methods 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 במרץ 2023 נוספו שיטות runAccessReport ברמת החשבון והנכס לגרסה 1בטא של Admin API.

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

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

ExpandedDataSet המשאב נוסף לגרסת v1alpha של ה-API, יחד עם properties.expandedDataSets.create המתאים, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get ב-Analytics. אתם יכולים להשתמש בפונקציונליות הזו כדי לנהל קבוצות נתונים מורחבות ב-Google Analytics 360.

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

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

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

24.02.2023 הוצאה משימוש של שיטות הביקורת בנושא הרשאות משתמשים.

השיטות הבאות הוצאו משימוש ויוסרו מ-Admin API v1 alpha ב-1/6/23:

24.02.2023 נוספו שיטות לניהול קהלים.

Audience המשאב נוסף לגרסת v1alpha של ה-API, יחד עם properties.audience.create המתאים, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get ב-Analytics.

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

15.02.2023 נוספו שיטות לביטול הסכמה לתהליך הגדרה אוטומטי של GA4.

properties.setAutomatedGa4ConfigurationOptOut נוספו פעולות properties.fetchAutomatedGa4ConfigurationOptOut לגרסת v1alpha של ה-API.

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

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

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

SearchAds360Link המשאב נוסף לגרסת v1alpha של ה-API, יחד עם properties.searchAds360Links.create המתאים, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get ב-Analytics.

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

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

  • LESS_THAN_OR_EQUAL, GREATER_THAN_OR_EQUAL ערכים הוסרו NumericFilter.Operation טיפוסים בני מנייה (enum)

  • הערך של PARTIAL_REGEXP הוסר מה-StringFilter.MatchType טיפוסים בני מנייה (enum)

15.02.2023 שינויים שונים.

  • השדה tokensPerProjectPerHour נוסף אל AccessQuota מהסוג הזה.
  • EXPANDED_DATA_SET, CHANNEL_GROUP ערכים נוספו אל ChangeHistoryResourceType טיפוסים בני מנייה (enum)
  • searchAds360Link, expandedDataSet ו-bigqueryLink נוספו לערכים ChangeHistoryResource.

11 באוגוסט 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 הושק.

האדמין ימשיך לתמוך בערוצי האלפא והבטא של ה-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.

5 ביוני 2021 נוספו תכונות.

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

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

5.6.2021 שינויי תוכנה.

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

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

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

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

  • השם של השדה country_code השתנה ל-region_code בתאריך Account.

  • השם של השדה url_query_parameter השתנה ל-uri_query_parameter בתאריך EnhancedMeasurementSettings.

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

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

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

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

15.08.2020 השם של Admin App + Web API השתנה ל-Admin API.

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