سياسة إيقاف البيانات في واجهات برمجة تطبيقات "إحصاءات Google"

ويوضّح هذا المستند سياسة إيقاف البيانات لواجهات برمجة التطبيقات الأساسية لإعداد التقارير والبيانات الوصفية.

نظرة عامة

يتم استخدام السمات والمقاييس (الأعمدة) للاستعلام عن واجهات برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". وفي بعض الأحيان، من الضروري إضافة هذه الأعمدة أو إزالتها أو إعادة تسميتها. وتهدف سياسة إيقاف البيانات إلى زيادة الشفافية بشأن كيفية تطبيق هذه التغييرات.

سيتم إعلام جميع تغييرات الأعمدة من خلال سجلات التغييرات وسيتم تعديل واجهة برمجة التطبيقات للبيانات الوصفية لتعكس هذه التغييرات.

ما تشمله هذه السياسة

تشمل هذه السياسة السمات والمقاييس التي تعرضها واجهات برمجة التطبيقات العلنية. ولا يشمل طلب واجهة برمجة التطبيقات (معلَمات طلب البحث)، أو استجابة واجهة برمجة التطبيقات، أو القيم التي تعرضها واجهة برمجة التطبيقات، أو مجموعات صالحة من المكوّنات والمقاييس.

البيانات الجديدة

عند إضافة أعمدة جديدة إلى واجهة برمجة التطبيقات:

إزالة البيانات

عند إزالة الأعمدة من واجهة برمجة التطبيقات:

إعادة تسمية البيانات

عند إعادة تسمية الأعمدة:

  • وسيتم تعديل changelog لواجهة برمجة التطبيقات المقابلة مع تضمين تفاصيل حول الأعمدة الأصلية والبديلة.
  • في واجهة برمجة التطبيقات للبيانات الوصفية، سيتم ضبط السمة status للعمود الأصلي على DEPRECATED وسيتم ضبط السمة replacedBy على رقم تعريف العمود البديل.
  • سيستمر عمل الأعمدة الأصلية في طلبات البحث لإعداد التقارير لمدة 6 أشهر على الأقل.
  • وبعد 6 أشهر، ستتم إزالة الأعمدة الأصلية من واجهة برمجة التطبيقات للبيانات الوصفية، وسيؤدي طلب البحث عن الأعمدة في واجهة برمجة التطبيقات لإعداد التقارير إلى حدوث خطأ 400 Bad Request.

إزالة السمة

عند إزالة السمات من واجهة برمجة التطبيقات للبيانات الوصفية:

المجموعات

في بعض الأحيان، يكون من الضروري تغيير اسم المجموعة أو ترتيب الأعمدة. وعند حدوث ذلك: