המדיניות בנושא הוצאה משימוש של נתונים בממשקי API של Google Analytics

במסמך הזה מתוארת המדיניות בנושא הוצאה משימוש של נתונים ב-Core Reporting וממשקי ה-API של המטא-נתונים.

סקירה

מאפיינים ומדדים (עמודות) משמשים לשליחת שאילתות אל ממשקי Reporting API של Google Analytics. לפעמים צריך להוסיף, להסיר או לשנות את השם של העמודות האלה. המדיניות בנושא ההוצאה משימוש של הנתונים נועדה להגביר את השקיפות לגבי האופן שבו השינויים האלה מתרחשים.

כל השינויים בעמודות ידווחו באמצעות changelogs ו-Metadata API יתעדכנו באופן אוטומטי כדי לשקף את השינויים האלה.

מה מכוסה במדיניות הזו

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

נתונים חדשים

כאשר עמודות חדשות נוספות לממשק API:

הסרת נתונים

כאשר העמודות מוסרות מ-API:

  • נעדכן את יומן השינויים של ה-API המתאים עם פרטים לגבי העמודות שהוסרו.
  • ב-Metadata API, מאפיין העמודה status יוגדר כ-DEPRECATED.
  • העמודות ימשיכו לפעול בשאילתות דיווח במשך 6 חודשים לפחות.
  • אחרי 6 חודשים, העמודות יוסרו מ-Metadata API והרצת שאילתות לגבי העמודות ב-Reporting API תוביל לשגיאה 400 Bad Request.

שינוי שם הנתונים

כשהשמות של העמודות משתנים:

  • יומן השינויים של ה-API המתאים יעודכן בפרטים לגבי העמודה המקורית והעמודות החלופיות.
  • ב-Metadata API , המאפיין status של העמודה המקורית יוגדר כ-DEPRECATED והמאפיין replacedBy יוגדר בתור המזהה של העמודה החלופית.
  • העמודות המקוריות ימשיכו לפעול בשאילתות דיווח במשך 6 חודשים לפחות.
  • אחרי 6 חודשים, העמודות המקוריות יוסרו מ-Metadata API והרצת שאילתות לגבי העמודות ב-Reporting API תוביל לשגיאה 400 Bad Request.

הסרת מאפיין

כאשר מסירים מאפיינים מה-Metadata API:

  • יומן השינויים של Metadata API יעודכן עם פרטים לגבי המאפיינים יוסרו.
  • המאפיינים ימשיכו להיות זמינים ב-Metadata API למשך 6 חודשים לפחות.
  • אחרי 6 חודשים, המאפיינים יוסרו מה-Metadata API.

קבוצות

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