يوضّح هذا المستند سياسة إيقاف البيانات نهائيًا في واجهات برمجة التطبيقات الأساسية لإعداد التقارير والبيانات الوصفية.
نظرة عامة
تُستخدَم السمات والمقاييس (الأعمدة) لإجراء طلبات بحث في واجهات برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". في بعض الأحيان، من الضروري إضافة هذه الأعمدة أو إزالتها أو إعادة تسميتها. تهدف سياسة إيقاف البيانات نهائيًا إلى زيادة الشفافية بشأن كيفية إجراء هذه التغييرات.
سيتم الإعلان عن جميع التغييرات في الأعمدة من خلال سجلات التغييرات وسيتم تعديل واجهة برمجة تطبيقات البيانات الوصفية تلقائيًا لتعكس هذه التغييرات.
المحتوى الذي تشمله هذه السياسة
تغطي هذه السياسة السمات والمقاييس التي تعرضها واجهات برمجة التطبيقات العامة. وهو لا يتناول طلب بيانات من واجهة برمجة التطبيقات (معلَمات طلب البحث) أو استجابة واجهة برمجة التطبيقات أو القيم التي تعرضها واجهة برمجة التطبيقات أو مجموعات صالحة من السمات والمقاييس.
بيانات جديدة
عند إضافة أعمدة جديدة إلى واجهة برمجة تطبيقات:
- سيتم تعديل سجل التغييرات لواجهة برمجة التطبيقات المقابلة من خلال إضافة تفاصيل حول الأعمدة الجديدة.
- ستكون الأعمدة متاحة في Metadata API.
إزالة البيانات
عند إزالة الأعمدة من واجهة برمجة التطبيقات:
- سيتم تعديل سجل التغييرات لواجهة برمجة التطبيقات المقابلة من خلال إضافة تفاصيل حول الأعمدة التي تتم إزالتها.
- في واجهة برمجة تطبيقات البيانات الوصفية، سيتم ضبط سمة العمود
status
علىDEPRECATED
. - سيستمر عمل الأعمدة في إعداد التقارير عن الطلبات لمدة 6 أشهر على الأقل.
- بعد 6 أشهر، ستتم إزالة الأعمدة من Metadata API، وسيؤدي طلب البحث عن الأعمدة في Reporting API إلى ظهور الخطأ
400 Bad Request
.
إعادة تسمية البيانات
عند إعادة تسمية الأعمدة:
- سيتم تعديل سجلّ التغييرات لواجهة برمجة التطبيقات المقابلة من خلال إضافة تفاصيل حول الأعمدة الأصلية والأعمدة البديلة.
- في واجهة برمجة تطبيقات البيانات الوصفية
، سيتم ضبط السمة
status
للعمود الأصلي علىDEPRECATED
وسيتم ضبط السمةreplacedBy
على رقم تعريف العمود البديل. - سيستمر عمل الأعمدة الأصلية في إعداد التقارير عن الطلبات لمدة 6 أشهر على الأقل.
- بعد 6 أشهر، ستتم إزالة الأعمدة الأصلية من Metadata API، وسيؤدي طلب البحث عن الأعمدة في Reporting API إلى ظهور الخطأ
400 Bad Request
.
إزالة السمة
عند إزالة السمات من Metadata API:
- سيتم تعديل سجلّ تغييرات واجهة برمجة تطبيقات البيانات الوصفية من خلال إضافة تفاصيل حول السمات التي تتم إزالتها.
- ستظل السمات متاحة في Metadata API لمدة 6 أشهر على الأقل.
- بعد 6 أشهر، ستتم إزالة السمات من Metadata API.
Groups
في بعض الأحيان، يكون من الضروري تغيير اسم مجموعة أو ترتيب الأعمدة. وعند حدوث ذلك:
- سيتم تعديل سجلّ تغييرات واجهة برمجة تطبيقات البيانات الوصفية من خلال إضافة تفاصيل حول اسم المجموعة وتغييرات الترتيب.