يقدّم هذا المستند نظرة عامة عالية المستوى على واجهة برمجة تطبيقات البيانات الوصفية في "إحصاءات Google". للحصول على مرجع مفصّل حول واجهة برمجة التطبيقات، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.
المقدمة
تعرض واجهة برمجة التطبيقات للبيانات الوصفية قائمة وسمات الأعمدة (أي الأبعاد والمقاييس) المعروضة في واجهات برمجة التطبيقات لإعداد تقارير "إحصاءات Google". وتشمل السمات المعروضة اسم المستخدم ووصفًا ووصفًا ودعمًا للشرائح والمزيد.
يمكنك استخدام واجهة برمجة تطبيقات البيانات الوصفية لإجراء ما يلي:
- اكتشاف الأعمدة الجديدة تلقائيًا
- الوصول إلى جميع السمات والمقاييس في واجهات برمجة التطبيقات لإعداد تقارير "إحصاءات Google"
اطّلِع على استجابة مباشرة لواجهة برمجة التطبيقات للبيانات الوصفية وتعرّف على كيفية استخدام هذه الميزة من خلال الاطّلاع على دليل مطوري البرامج.
نظرة عامة على المفاهيم
في ما يلي المفاهيم الأساسية التي تستند إليها واجهة برمجة التطبيقات للبيانات الوصفية:
الأعمدة
يمثّل مورد العمود في واجهة برمجة تطبيقات البيانات الوصفية بُعدًا أو مقياسًا واحدًا ويحتوي على معلومات مثل Id والسمات الأخرى لذلك العمود. تمثّل مجموعة من موارد Column كل الأبعاد والمقاييس لواجهة برمجة التطبيقات لإعداد التقارير.
العمل باستخدام واجهة برمجة التطبيقات
عند طلب البحث عن واجهة برمجة التطبيقات، يمكنك تحديد نوع التقرير الذي تريد استرداد بياناته الوصفية. ستتضمّن الاستجابة من واجهة برمجة التطبيقات مجموعة من جميع الأعمدة (أي السمات والمقاييس) المتاحة لهذا النوع من التقارير. اطّلِع على الدليل المرجعي لواجهة برمجة تطبيقات البيانات الوصفية لمزيد من المعلومات حول استجابة واجهة برمجة التطبيقات و أمثلة الرموز، وكذلك دليل مطوّري واجهة برمجة تطبيقات البيانات الوصفية للاطّلاع على تفاصيل حول استخدام واجهة برمجة التطبيقات.
الوصول إلى API
لا تتطلب واجهة برمجة التطبيقات للبيانات الوصفية مصادقة وتفويض. وبدلاً من ذلك، الشرط الوحيد هو أن يحدّد تطبيقك نفسه في كل مرة يُرسل فيها طلبًا إلى واجهة برمجة تطبيقات "إحصاءات Google". لمعرفة التفاصيل حول كيفية تنفيذ ذلك، يُرجى الاطّلاع على القسم الوصول إلى واجهة برمجة التطبيقات من دليل مطوري البرامج.
سياسات الحصص والإهمال
وتتعامل واجهة برمجة تطبيقات البيانات الوصفية مع ملايين من العمليات. لحماية النظام من عمليات أكثر مما يمكنه التعامل معها، وضمان توزيع عادل لموارد النظام، من الضروري استخدام نظام حصة. اطّلِع على دليل الحدود والحصص.
للحصول على تفاصيل عن كيفية التعامل مع التغييرات التي تطرأ على أعمدة واجهة برمجة التطبيقات لإعداد التقارير (أي السمات والمقاييس)، يُرجى الاطّلاع على سياسة إيقاف البيانات. للاطّلاع على كيفية استخدام واجهة برمجة تطبيقات البيانات الوصفية للتحقّق من الأعمدة التي تم إيقافها، يُرجى مراجعة دليل مطوّري واجهة برمجة تطبيقات البيانات الوصفية.