במסמך הזה מתוארת המדיניות בנושא הוצאה משימוש של נתונים ב-Core Reporting וממשקי ה-API של המטא-נתונים.
סקירה
מאפיינים ומדדים (עמודות) משמשים לשליחת שאילתות אל ממשקי Reporting API של Google Analytics. לפעמים צריך להוסיף, להסיר או לשנות את השם של העמודות האלה. המדיניות בנושא ההוצאה משימוש של הנתונים נועדה להגביר את השקיפות לגבי האופן שבו השינויים האלה מתרחשים.
כל השינויים בעמודות ידווחו באמצעות changelogs ו-Metadata API יתעדכנו באופן אוטומטי כדי לשקף את השינויים האלה.
מה מכוסה במדיניות הזו
המדיניות הזו כוללת את המאפיינים והמדדים שנחשפים על ידי ממשקי API ציבוריים. הוא לא כולל את בקשת ה-API (פרמטרים של שאילתות), את תגובת ה-API, את הערכים שהוחזרו על ידי ה-API או את שילובים חוקיים של מאפיינים ומדדים.
נתונים חדשים
כאשר עמודות חדשות נוספות לממשק API:
- יומן השינויים של ה-API המתאים יעודכן בפרטים לגבי העמודות החדשות.
- העמודות יהיו זמינות ב-Metadata 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.
קבוצות
לפעמים צריך לשנות את השם של הקבוצה או את סדר העמודות. כאשר קורים הדברים הבאים:
- יומן השינויים של Metadata API יעודכן בפרטים לגבי שם הקבוצה ושינויים בסדר ההצגה.