ما هي واجهة برمجة التطبيقات للبيانات الوصفية؟ نظرة عامة

يقدّم هذا المستند نظرة عامة عالية المستوى على واجهة برمجة تطبيقات البيانات الوصفية في "إحصاءات Google". للاطّلاع على مرجع تفصيلي حول واجهة برمجة التطبيقات، يمكنك قراءة مرجع واجهة برمجة التطبيقات.

مقدمة

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

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

  • اكتشاف أعمدة جديدة تلقائيًا
  • الوصول إلى جميع سمات المقاييس والسمات لواجهات برمجة تطبيقات إعداد تقارير "إحصاءات Google"

اطّلِع على الاستجابة المباشرة من واجهة برمجة التطبيقات للبيانات الوصفية وتعرَّف على كيفية استخدامها من خلال قراءة دليل المطوّر.

نظرة عامة على المفاهيم

المفاهيم الأساسية لواجهة برمجة تطبيقات البيانات الوصفية هي:

الأعمدة

يمثّل مورد العمود في واجهة برمجة تطبيقات البيانات الوصفية سمة أو مقياسًا واحدًا ويحتوي على معلومات مثل Id وسمات أخرى لذلك العمود. تمثل مجموعة موارد Column جميع السمات والمقاييس لواجهة برمجة التطبيقات لإعداد التقارير.

العمل باستخدام واجهة برمجة التطبيقات

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

الوصول إلى API

لا تتطلب واجهة برمجة تطبيقات البيانات الوصفية المصادقة والترخيص. بدلاً من ذلك، الشرط الوحيد هو أن يعرّف تطبيقك نفسه في كل مرة يرسل فيها طلبًا إلى Analytics API. لمعرفة تفاصيل حول طريقة إجراء ذلك، يُرجى الاطّلاع على قسم الوصول إلى واجهة برمجة التطبيقات في دليل مطوّري البرامج.

سياسات الحصص والإيقاف

تعالج واجهة برمجة تطبيقات البيانات الوصفية ملايين العمليات. لحماية النظام من تلقي عمليات أكثر مما يمكنه التعامل معه، وضمان التوزيع العادل لموارد النظام، من الضروري استخدام نظام حصة. لمزيد من التفاصيل، يُرجى قراءة دليل الحدود والحصص.

للحصول على تفاصيل عن كيفية التعامل مع التغييرات في أعمدة إعداد تقارير واجهة برمجة التطبيقات (أي السمات والمقاييس)، يُرجى الاطّلاع على سياسة الإيقاف النهائي للبيانات. للاطّلاع على كيفية استخدام واجهة برمجة التطبيقات للبيانات الوصفية للتحقق من الأعمدة التي تم إيقافها نهائيًا، يمكنك مراجعة دليل مطوّري البرامج حول البيانات الوصفية.