API Reference

ממשק API לניהול

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

כל סעיף במדריך הזה מגדיר את שיטת הבקשה ותגובת הבקשה לסוג אחד של ישות בנתוני התצורה של משתמש מאומת. כל הבקשות מוצגות בפורמט REST. בסוף הדף של כל שיטה, תוכלו לנסות את הבקשה באופן אינטראקטיבי ב-APIs Explorer באמצעות הקישור 'אני רוצה לנסות!'.

סוגי המשאבים

  1. סיכומי חשבון
  2. קישורי משתמש בחשבון
  3. חשבונות
  4. קישורים ל-AdWords
  5. מקורות נתונים מותאמים אישית
  6. מאפיינים מותאמים אישית
  7. מדדים מותאמים אישית
  8. ניסויים
  9. מסננים
  10. יעדים
  11. Client-ID
  12. קישורים למסנן פרופיל
  13. קישורי משתמש בפרופיל
  14. קהלים לרימרקטינג
  15. פלחים
  16. דוחות ללא דגימה
  17. העלאות
  18. צפיות (פרופילים)
  19. נכסי אינטרנט
  20. קישורי משתמש לנכס אינטרנט

סיכומי חשבון

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

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
list GET  /management/accountSummaries בתיבת הדו-שיח הזו מפורטים סיכומי חשבונות (עץ קליל שמורכב מחשבונות/נכסים/פרופילים) שלמשתמש יש גישה אליהם.

כדי לראות את פרטי המשאבים של קישורי משתמשים בחשבון, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/entityUserLinks/linkId הסרת משתמש מהחשבון הנתון.
הוספה POST  /management/accounts/accountId/entityUserLinks הוספה של משתמש חדש לחשבון הרלוונטי אם יש למשתמש פחות מ-100 חשבונות.
list GET  /management/accounts/accountId/entityUserLinks בתיבת הדו-שיח הזו מפורטים קישורים למשתמשים בחשבון.
עדכון PUT  /management/accounts/accountId/entityUserLinks/linkId המערכת מעדכנת את ההרשאות של משתמש קיים בחשבון הנתון.

חשבונות

לפרטי המשאבים של חשבונות, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
list GET  /management/accounts כל החשבונות שאליהם יש למשתמש גישה.

לפרטי המשאבים של קישורים ל-AdWords, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId מחיקת קישור של נכס אינטרנט ל-AdWords.
get GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId מחזירה קישור לנכס אינטרנט-AdWords שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks יוצר קישור בין נכס אינטרנט ל-AdWords.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks בתיבת הדו-שיח הזו מפורטים קישורי AdWords-נכס אינטרנט עבור נכס אינטרנט נתון.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId עדכון קישור קיים של נכס אינטרנט-AdWords. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId עדכון קישור קיים של נכס אינטרנט-AdWords.

מקורות נתונים מותאמים אישית

לפרטי המשאבים של מקורות נתונים מותאמים אישית, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources ליצור רשימה של מקורות נתונים מותאמים אישית שלמשתמש יש גישה אליהם.

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

לפרטי המשאבים של מאפיינים מותאמים אישית, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId קבל מאפיין מותאם אישית שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions יוצרים מאפיין מותאם אישית חדש.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions בתיבת הדו-שיח הזו מפורטים מאפיינים מותאמים אישית שלמשתמש יש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId עדכון מאפיין מותאם אישית שכבר קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId עדכון מאפיין מותאם אישית שכבר קיים.

מדדים מותאמים אישית

לפרטי המשאבים של מדדים מותאמים אישית, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
get GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId קבלת מדד מותאם אישית שיש למשתמש גישה אליו.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics יצירת מדד מותאם אישית חדש.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics בתיבת הדו-שיח הזו מפורטים מדדים מותאמים אישית שלמשתמש יש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId עדכון מדד מותאם אישית קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId עדכון מדד מותאם אישית קיים.

ניסויים

לפרטי המשאבים של ניסויים, אפשר להיכנס לדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId למחוק ניסוי.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId מחזירה ניסוי שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments יוצרים ניסוי חדש.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments בתיבת הדו-שיח הזו מפורטים ניסויים שלמשתמש יש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId מעדכנים ניסוי קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId מעדכנים ניסוי קיים.

מסננים

למידע על המסננים של פרטי המשאבים, אפשר להיכנס לדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/filters/filterId מחיקת מסנן.
get GET  /management/accounts/accountId/filters/filterId מחזירה מסנן שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/filters יצירת מסנן חדש.
list GET  /management/accounts/accountId/filters פירוט כל המסננים של חשבון
patch PATCH  /management/accounts/accountId/filters/filterId עדכון מסנן קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/filters/filterId עדכון מסנן קיים.

שערים

לפרטי המשאבים של מטרות עסקיות, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId הפונקציה מקבלת יעד שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals יוצרים יעד חדש.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals בתיבת הדו-שיח הזו מפורטים היעדים שיש למשתמש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId עדכון מטרה עסקית קיימת. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId עדכון מטרה עסקית קיימת.

Client ID

לפרטי המשאבים של Management.clientId, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
hashClientId POST  /management/clientId:hashClientId מבצעת גיבוב (hash) של מזהה הלקוח הנתון.

לפרטי המשאבים של קישורים למסנן פרופילים, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId מחיקת קישור למסנן פרופיל.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId מחזירה קישור למסנן פרופיל יחיד.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks יצירת קישור חדש למסנן פרופיל.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks בתיבת הדו-שיח הזו מפורטים כל הקישורים של מסנני הפרופילים לפרופיל.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId עדכון קישור למסנן פרופיל קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId עדכון קישור למסנן פרופיל קיים.

למידע על מקורות המידע לגבי קישורים למשתמש בפרופיל, כדאי לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId מסיר משתמש מהתצוגה המפורטת (פרופיל) הנתונה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks הוספת משתמש חדש לתצוגה המפורטת (פרופיל) הנתונה.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks בתיבת הדו-שיח הזו מפורטים קישורים למשתמש בפרופיל של תצוגה (פרופיל) מסוימת.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId מעדכן את ההרשאות של משתמש קיים בתצוגה המפורטת (פרופיל).

קהלים לרימרקטינג

לפרטי המשאבים של קהלים לרימרקטינג, מומלץ לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId מחיקת קהל לרימרקטינג.
get GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId הפונקציה מקבלת קהל לרימרקטינג שאליו יש למשתמש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences יצירת קהל חדש לרימרקטינג.
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences בתיבת הדו-שיח הזו מפורטים קהלים לרימרקטינג שלמשתמש יש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId עדכון קהל קיים לרימרקטינג. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId עדכון קהל קיים לרימרקטינג.

פלחים

לפרטי המשאבים של פלחים, אפשר להיכנס לדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
list GET  /management/segments בתיבת הדו-שיח הזו מפורטים פלחים שלמשתמש יש גישה אליהם.

דוחות ללא דגימה

לפרטי המשאבים של דוחות ללא דגימה, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId מחיקת דוח ללא דגימה.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId מחזירה דוח יחיד ללא דגימה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports יוצרים דוח חדש ללא דגימה.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports בתיבת הדו-שיח הזו מוצגים דוחות ללא דגימה שלמשתמש יש גישה אליהם.

העלאות

לפרטי המשאבים של העלאות, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData מחיקת הנתונים שמשויכים להעלאה קודמת.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId הצגת רשימה של העלאות שיש למשתמש גישה אליהן.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads הצגת רשימה של העלאות שיש למשתמש גישה אליהן.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
העלאת נתונים למקור נתונים מותאם אישית.

צפיות (פרופילים)

לפרטי המשאבים של 'תצוגות (פרופילים)', אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId מחיקת תצוגה מפורטת (פרופיל).
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId מקבל תצוגה (פרופיל) שאליה למשתמש יש גישה.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/profiles יצירת תצוגה מפורטת (פרופיל) חדשה.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles בתיבת הדו-שיח הזו מפורטים תצוגות (פרופילים) שלמשתמש יש גישה אליהן.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId עדכון של תצוגה מפורטת קיימת (פרופיל). השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId עדכון של תצוגה מפורטת קיימת (פרופיל).

נכסי אינטרנט

לפרטי המשאבים של נכסי אינטרנט, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
get GET  /management/accounts/accountId/webproperties/webPropertyId מקבלת נכס שלמשתמש יש גישה אליו.
הוספה POST  /management/accounts/accountId/webproperties יצירת נכס חדש.
list GET  /management/accounts/accountId/webproperties בתיבת הדו-שיח הזו מפורטים נכסים שיש למשתמש גישה אליהם.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId עדכון נכס קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId עדכון נכס קיים.

לפרטי המשאבים של קישורי משתמשים בנכס אינטרנט, אפשר לעיין בדף ייצוג משאבים.

שיטה בקשת HTTP תיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/analytics/v3, אלא אם צוין אחרת
מחיקה DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId מסיר משתמש מנכס אינטרנט נתון.
הוספה POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks הוספת משתמש חדש לנכס האינטרנט הנתון.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks בתיבת הדו-שיח הזו מפורטים קישורים למשתמשים בנכס אינטרנט עבור נכס אינטרנט נתון.
עדכון PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId עדכון ההרשאות של משתמש קיים בנכס האינטרנט הנתון.