خط‌مشی لغو داده‌ها برای APIهای Google Analytics

این سند خط‌مشی لغو داده‌ها را برای گزارش‌های اصلی و APIهای فراداده توضیح می‌دهد.

بررسی اجمالی

ابعاد و معیارها (ستون ها) برای پرس و جو از API های گزارش Google Analytics استفاده می شود. گاهی لازم است این ستون ها را اضافه، حذف یا تغییر نام دهید. خط مشی حذف داده ها برای افزایش شفافیت در مورد نحوه انجام این تغییرات ارائه شده است.

همه تغییرات ستون از طریق تغییرات ثبت می شود و API فراداده به طور خودکار به روز می شود تا این تغییرات را منعکس کند.

آنچه توسط این خط مشی پوشش داده می شود

این خط‌مشی ابعاد و معیارهایی که توسط APIهای عمومی در معرض دید قرار می‌گیرند را پوشش می‌دهد. درخواست API (پارامترهای پرس و جو)، پاسخ API، مقادیر بازگردانده شده توسط API یا ترکیبات معتبر ابعاد و معیارها را پوشش نمی دهد.

داده های جدید

هنگامی که ستون های جدید به یک API اضافه می شوند:

حذف داده ها

هنگامی که ستون ها از یک API حذف می شوند:

  • تغییرات API مربوطه با جزئیات مربوط به ستون(های) حذف شده به روز می شود.
  • در API فراداده ، ویژگی status ستون روی DEPRECATED تنظیم می شود.
  • ستون(ها) برای حداقل 6 ماه به کار در پرس و جوهای گزارش دهی ادامه خواهند داد.
  • پس از 6 ماه، ستون(ها) از API فراداده حذف خواهد شد و پرس و جو برای ستون(ها) در API گزارش دهی منجر به خطای 400 Bad Request خواهد شد.

تغییر نام داده ها

هنگامی که ستون ها تغییر نام می دهند:

  • تغییرات API مربوطه با جزئیات مربوط به ستون(های) اصلی و جایگزین به روز می شود.
  • در Metadata API ، ویژگی status ستون اصلی روی DEPRECATED و ویژگی replacedBy روی شناسه ستون جایگزین تنظیم می‌شود.
  • ستون(های) اصلی حداقل به مدت 6 ماه در پرس و جوهای گزارش دهی کار خواهند کرد.
  • پس از 6 ماه، ستون(های) اصلی از API فراداده حذف خواهد شد و پرس و جو برای ستون(ها) در API گزارش دهی منجر به خطای 400 Bad Request خواهد شد.

حذف صفت

هنگامی که ویژگی ها از API فراداده حذف می شوند:

  • گزارش تغییرات API فراداده با جزئیات در مورد ویژگی(های) حذف شده به روز می شود.
  • ویژگی(ها) حداقل به مدت 6 ماه در API فراداده در دسترس خواهند بود.
  • پس از 6 ماه، ویژگی(ها) از API فراداده حذف خواهد شد.

گروه ها

گاهی لازم است نام یک گروه یا ترتیب ستون ها را تغییر دهید. وقتی این اتفاق می افتد: