סקירה כללית על Google Analytics Admin API

סיכום: במאמר הזה מפורטת סקירה כללית של Google Analytics Admin API גרסה 1.0.

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

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

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

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

מבוא

‫Google Analytics Admin API מאפשר גישה פרוגרמטית לנתוני ההגדרה של Google Analytics, והוא תואם רק לנכסי Google Analytics. מידע נוסף על נכסי Google Analytics

אתם יכולים להשתמש ב-Google Analytics Admin API כדי:

• הקצאת חשבונות חדשים.
• ניהול חשבונות.
• ניהול הגדרות שיתוף הנתונים
• הצגת סיכומים לגבי החשבון
• חיפוש אירועים בהיסטוריית השינויים
• ניהול נכסים
• ניהול נכסי משנה
• אישור איסוף נתוני משתמשים
• ניהול ההגדרה של שמירת נתונים בנכס
• ניהול ההגדרה של Google Signals בנכס (אלפא)
• ניהול שידורים חיים
• ניהול ערכי API Secret של Measurement Protocol
• ניהול סכימה להקצאת ערכי המרות של SKAdNetwork (אלפא)
• יצירת קטע קוד של Google Tag למקורות לנתוני אתר (אלפא).
• ניהול אירועים מרכזיים
• ניהול אירועי המרה (הוצא משימוש)
• ניהול כללים ליצירת אירועים (אלפא)
• ניהול כללים לעריכת אירועים (אלפא)
• ניהול מאפיינים מותאמים אישית
• ניהול מדדים מותאמים אישית
• ניהול קישורים בין נכסים ב-Google Analytics לפרויקטים ב-Firebase
• ניהול קישורים בין נכסים ב-Google Analytics לחשבונות Google Ads
• ניהול הצעות לקישור בין נכס ב-Google Analytics לבין מפרסם ב-Display & Video 360 (אלפא)
• ניהול קישורים בין נכס ב-Google Analytics לבין מפרסם ב-Display & Video 360 (אלפא)
• ניהול קישורים בין נכס ב-Google Analytics לבין Search Ads 360 (אלפא).
• ניהול קישורים בין נכס ב-Google Analytics לפרויקט BigQuery (אלפא).
• ניהול הרשאות משתמשים בהיררכיית חשבונות ובנכסי Google Analytics (אלפא)
• יצירת דוחות גישה לנתונים.
• ניהול קהלים (אלפא)
• ניהול של קבוצות נתונים מורחבות (אלפא)
• ניהול הגדרות לביטול ההסכמה לתהליך ההגדרה האוטומטי של Google Analytics (אלפא)

שיטות זמינות

אלה השיטות הזמינות.

הקצאת הרשאות לחשבון

• accounts.provisionAccountTicket

השיטה הזו מחזירה את השדה accountTicketId שצריך לכלול בכתובת ה-URL של התנאים וההגבלות:

https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID

אחרי שהמשתמש יבקר בכתובת ה-URL של התנאים וההגבלות ויאשר אותם, יצירת החשבון ב-Google Analytics תושלם. דוגמה להקצאת חשבון

ניהול חשבונות

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

ניהול הרשאות שיתוף נתונים

• accounts.getDataSharingSettings

הצגת סיכומים לגבי החשבון

• accountSummaries.list

חיפוש אירועים בהיסטוריית השינויים

• accounts.searchChangeHistoryEvents

ניהול נכסים

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

ניהול נכסי משנה (אלפא)

• properties.provisionSubproperty

אישור לאיסוף נתוני משתמשים

• properties.acknowledgeUserDataCollection

ניהול הגדרות של שמירת נתונים

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

ניהול ההגדרות של Google Signals (אלפא)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

ניהול מקורות נתונים

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

ניהול ערכי API Secret של Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

ניהול סכימה להקצאת ערכי המרות ב-SKAdNetwork (אלפא)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

ניהול אירועים מרכזיים

• properties.keyEvents.create
• properties.keyEvents.get
• properties.keyEvents.list
• properties.keyEvents.delete
• properties.keyEvents.patch

ניהול אירועי המרה

הוצא משימוש: במקום זאת, אפשר להשתמש במשאב KeyEvent ובשיטות שלו.

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.patch

ניהול כללים ליצירת אירועים (אלפא)

• properties.dataStreams.eventCreateRules.create
• properties.dataStreams.eventCreateRules.get
• properties.dataStreams.eventCreateRules.list
• properties.dataStreams.eventCreateRules.delete
• properties.dataStreams.eventCreateRules.patch

ניהול כללים לעריכת אירועים (אלפא)

• properties.dataStreams.eventEditRules.create
• properties.dataStreams.eventEditRules.get
• properties.dataStreams.eventEditRules.list
• properties.dataStreams.eventEditRules.delete
• properties.dataStreams.eventEditRules.patch
• properties.dataStreams.eventEditRules.reorder

ניהול מאפיינים מותאמים אישית

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

ניהול מדדים מותאמים אישית

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

קישור פרויקט Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

קישור חשבון Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

יצירת Google Tag (אלפא)

• properties.webDataStreams.getGlobalSiteTag

הצעות לקישור בין נכס ב-Google Analytics לבין מפרסם ב-Display & Video 360 (אלפא)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

קישור חשבון מפרסם ב-Display & Video 360 (אלפא)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

קישור חשבון Search Ads 360 (אלפא)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

מידע נוסף על הגדרת שילוב של Analytics ב-Search Ads 360 בנכס של Google Analytics

קישור חשבון BigQuery (אלפא)

• properties.bigQueryLinks.create
• properties.bigQueryLinks.delete
• properties.bigQueryLinks.get
• properties.bigQueryLinks.list
• properties.bigQueryLinks.patch

מידע נוסף על הגדרת BigQuery Export לנכס ב-Google Analytics

ניהול הרשאות משתמשים (אלפא)

• 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

דוחות גישה לנתונים

• properties.runAccessReport

מידע נוסף על התכונה הזו זמין במדריך לדוחות גישה לנתונים.

ניהול קהלים (אלפא)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

מידע נוסף על קהלים ב-Google Analytics

ניהול קבוצות נתונים מורחבות (אלפא)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

מידע נוסף על קבוצות נתונים מורחבות ב-Google Analytics 360

ביטול ההסכמה לתהליך ההגדרה האוטומטי של Google Analytics (אלפא)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

מידע נוסף על ניהול סטטוס הביטול של תהליך ההגדרה האוטומטי של Google Analytics עבור נכס UA