يقدّم هذا المستند نظرة عامة عالية المستوى على الإصدار 3.0 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". للحصول على مرجع مفصّل حول واجهة برمجة التطبيقات، يمكنك الاطّلاع على الدليل المرجعي.
المقدمة
تتيح لك واجهة برمجة التطبيقات الأساسية في "إحصاءات Google" إمكانية الوصول إلى معظم بيانات التقارير في "إحصاءات Google". باستخدام واجهة برمجة التطبيقات الأساسية لإعداد التقارير، يمكنك إجراء ما يلي:
- إنشاء لوحات بيانات مخصصة لعرض بيانات "إحصاءات Google".
- وفِّر الوقت من خلال برمجة مهام إعداد التقارير بشكلٍ مُعقَّد.
- دمج بياناتك في "إحصاءات Google" مع تطبيقات الأنشطة التجارية الأخرى
اختيار إصدار
أطلقنا مؤخرًا إصدارًا جديدًا من واجهة برمجة التطبيقات الأساسية لإعداد التقارير.
- هل تريد إنشاء تطبيق جديد؟ – ننصح باستخدام أحدث إصدار 3.0.
- هل تستخدم الإصدار القديم 2.3؟ – يمكنك الاطّلاع على دليل نقل البيانات للحصول على مزيد من التفاصيل حول طريقة تحديث التطبيق لاستخدام الإصدار الجديد.
البدء
هل تريد البدء على الفور؟ اطّلِع على البرنامج التعليمي لواجهة برمجة تطبيقات Hello Analytics API.
يجب أن يتّخذ كل تطبيق يستخدم واجهة برمجة التطبيقات خطوتَين للتسجيل وتفويض المستخدم والعمل باستخدام واجهة برمجة التطبيقات. سيرشدك هذا البرنامج التعليمي خلال كل خطوة، وفي النهاية، سيكون لديك تطبيق يعمل يمكنك تخصيصه.
نظرة عامة على المفاهيم
تعرِض واجهة برمجة التطبيقات الأساسية لإعداد التقارير بيانات التقارير التي تتألف من الإحصاءات المستمدة من البيانات التي تجمعها رمز التتبّع في "إحصاءات Google". يتم تنظيم كل تقرير حسب الأبعاد والمقاييس. يمكنك استخدام واجهة برمجة التطبيقات الأساسية لإعداد التقارير للاستعلام عن الأبعاد والمقاييس من أجل إنشاء تقارير مخصصة.
هناك 3 مفاهيم أساسية يمكن استخدامها في واجهة برمجة التطبيقات الأساسية لإعداد التقارير:
- كيفية ارتباط التقارير بالمستخدمين والملفات الشخصية (الملفات الشخصية).
- بنية التقرير وكيفية إنشاء طلبات البحث
- التعامل مع استجابة واجهة برمجة التطبيقات
التقارير والمستخدمون والملفات الشخصية (الملفات الشخصية)
لطلب بيانات التقرير لأحد المستخدمين، يجب أن يحدد تطبيقك الملف الشخصي ويحدد الملف الشخصي الذي يمكن من خلاله استرداد البيانات. يتم تحديد المستخدم من خلال الحصول على بيانات اعتماد التفويض وتمريرها في كل طلب من طلبات واجهة برمجة التطبيقات. الملف الشخصي هو جزء من التدرج الهرمي لضبط "إحصاءات Google" ويتم تحديده من خلال رقم تعريف الملف الشخصي.
هناك طريقتان للعثور على رقم تعريف ملفك الشخصي.
- يمكن أن يستخدم تطبيقك واجهة برمجة التطبيقات للإدارة بغرض اجتياز التدرّج الهرمي لعملية ضبط الإدارة للحصول على معرّف ملف شخصي.
- في عنوان URL لكل تقرير في "إحصاءات Google"
لقطة شاشة
- في إحصاءات Google، انقر على
المشرف في شريط القوائم. اختَر الحساب والموقع الذي ينتمي إليه الملف الشخصي. في عمود الملف الشخصي، انقر على إعدادات الملف الشخصي
للحصول على رقم تعريف الملف الشخصي.
لقطة شاشة
طلب البحث عن الأبعاد والمقاييس
يمكنك إرسال طلب بحث عن بيانات تقرير واجهة برمجة التطبيقات الخاصة بخدمة "إحصاءات Google"، والتي تتألف من الأبعاد والمقاييس. المقاييس هي قياسات فردية لنشاط المستخدم على موقعك الإلكتروني، مثل الجلسات ومرات مشاهدة الصفحة. تعمل السمات على تقسيم المقاييس حسب بعض المعايير الشائعة، مثل البلد أو المتصفّح. عند إنشاء طلب بحث، عليك تحديد السمات والمقاييس التي تريدها في بيانات تقريرك.
يمكنك استخدام الدليل المرجعي للمقاييس والسمات التفاعلي لاستكشاف جميع السمات والمقاييس التي يتم عرضها من خلال واجهة برمجة التطبيقات. اقرأ أيضًا الدليل المرجعي لواجهة برمجة التطبيقات لإعداد التقارير الأساسية للتعرّف على كيفية تحديد الأبعاد والمقاييس في طلب بحث في واجهة برمجة التطبيقات.
التعامل مع التقارير
البيانات التي يتم عرضها من النموذج يمكن اعتبارها واجهة برمجة تطبيقات على أنها جدول يتضمّن عنوانًا وقائمة صفوف. وتتألف كل استجابة لواجهة برمجة تطبيقات من عنوان يصف اسم كل نوع من أنواع البيانات ونوعه. تحتوي الاستجابة أيضًا على قائمة من الصفوف، حيث يكون كل صف عبارة عن قائمة بخلايا تحتوي على بيانات بنفس ترتيب الرؤوس. ويمكنك استخدام المعلومات الواردة في العنوان لتحديد نوع البيانات في كل خلية.
اطّلِع على الدليل المرجعي لإعداد التقارير المرجعي في واجهة برمجة التطبيقات لمزيد من المعلومات حول استجابة واجهة برمجة التطبيقات.
سياسات الحصص والإهمال
تتعامل Google Analytics API مع ملايين من العمليات. لحماية النظام من تلقّي عمليات تشغيل أكثر مما يمكنه التعامل معها، وضمان توزيع موارد النظام بشكل عادل، من الضروري استخدام نظام حصة. اطّلِع على دليل الحدود والحصص لمعرفة حدود معيّنة.
للحصول على تفاصيل عن كيفية التعامل مع التغييرات التي تطرأ على أعمدة واجهة برمجة التطبيقات لإعداد التقارير الأساسية (أي السمات والمقاييس)، يُرجى الاطّلاع على سياسة إيقاف البيانات. للاطّلاع على كيفية استخدام واجهة برمجة تطبيقات البيانات الوصفية للتحقّق من الأعمدة التي تم إيقافها، يُرجى مراجعة دليل مطوّري واجهة برمجة تطبيقات البيانات الوصفية.
الخطوات التالية
الآن وبعد أن تعرّفت على آلية عمل واجهة برمجة التطبيقات، لدينا مجموعة من المراجع لمساعدتك في البدء:
- اطّلِع على دليل المطوِّر لمعرفة كيفية العمل باستخدام واجهة برمجة التطبيقات.
- استخدِم أداة طلبات البحث التفاعلية لإنشاء طلبات البحث والاطّلاع على الاستجابة من خلال واجهة برمجة التطبيقات.
- اقرأ مقالة طلبات البحث الشائعة التي تسرد العديد من طلبات البحث الأكثر شيوعًا إلى واجهة برمجة التطبيقات لإعداد التقارير الأساسية.
- راجِع مرجع المكوّنات والمقاييس، المكوّنات للاطّلاع على قائمة بجميع البيانات المتاحة من خلال واجهة برمجة التطبيقات.
- تحقّق من صفحة المكتبات والعيّنات للاطّلاع على قائمة بجميع مكتبات العملاء المتاحة التي يمكن استخدامها مع واجهة برمجة التطبيقات هذه.