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