بيتي فريسيلا، ممثّل مطوّري برامج "إحصاءات Google" - تموز (يوليو) 2013
يتناول هذا المستند الخادم الوكيل في "إحصاءات Google" ويوضح كيفية البدء واستخدام ميزات معيّنة ومناقشة الاعتبارات المهمة.
المقدمة
يتيح لك الخادم الوكيل في "إحصاءات Google" مشاركة بيانات إعداد تقارير "إحصاءات Google" بشكل علني. ويمكنك استخدامها لتشغيل لوحات البيانات والأدوات المخصّصة، وتحويل الردود إلى تنسيقات مختلفة، والاختبار، وغير ذلك الكثير.
تعمل الخادم الوكيل المتميز في "إحصاءات Google" مع واجهة برمجة التطبيقات لإعداد التقارير الأساسية وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي وواجهة برمجة التطبيقات لإعداد التقارير في القنوات المتعددة.
العناصر المميزة:
- مشاركة بياناتك في "إحصاءات Google" بشكلٍ علني.
- ويمكنك استخدام الخادم الوكيل لتشغيل لوحات بياناتك المخصّصة.
- التحويل إلى ملف CSV أو جدول بيانات أو TSV
- تتوفّر التواريخ النسبية (مثلاً آخر 7 أيام).
- تتم إعادة تحميل بيانات التقارير تلقائيًا.
- التخزين المؤقت - ردود سريعة واستخدام فعّال للحصة.
كيفية العمل
أنشئ طلبًا للحصول على بيانات "إحصاءات Google" وستكون بيانات إعداد التقارير المحدّدة متاحة للجميع على عنوان URL جديد يمكنك مشاركته. سيتمكّن أي شخص يزور عنوان URL من الوصول إلى بيانات إعداد التقارير بدون طلب أي تفويض.
على سبيل المثال، يمكنك إنشاء طلب لاسترداد أهم 10 متصفّحات استنادًا إلى مشاهدات الصفحة على مدار الأسبوع الماضي، بالإضافة إلى طلب بحث واحد لعدد الجلسات أمس، وما إلى ذلك. ويمكنك تحديد طلبات البحث التي تريد إتاحتها للجميع وعدد المرات التي تريد فيها تعديل البيانات، وسيتولى الخادم الوكيل في "إحصاءات Google" بقية الإجراءات.
نصيحة: يمكنك استخدام
مستكشف طلبات البحث لإنشاء
التقارير ثم نسخ Query URI لاستخدامها مع الخادم الوكيل المتميز في "إحصاءات
Google".
إعداد طلب بحث وإنشائه
الخادم الوكيل المتميز في "إحصاءات Google" هو تطبيق ويب يتم تشغيله في بيئة Google App Engine. يمكنك تنزيل هذا التطبيق ونشره باتّباع مجموعة بسيطة من التعليمات.
إدارة المستخدمين
يتضمن الخادم الوكيل المتميز في "إحصاءات Google" واجهة بسيطة لإدارة المستخدمين يمكنك استخدامها لإضافة مستخدمين. وسيتمكن كل مستخدم من إدراج طلبات البحث في واجهة برمجة التطبيقات وإدارتها فقط.
لا يمكن إلا للمشرفين إدارة المستخدمين. لإضافة مستخدم جديد:
- من واجهة مشرف الخادم الوكيل في "إحصاءات Google" (مثل
https://your-application-id.appspot.com/admin)، انقر على الزر إدارة المستخدمين. - في صفحة إدارة المستخدمين، أدخِل عنوان البريد الإلكتروني للمستخدم الذي تريد إضافته وانقر على زر إضافة مستخدم. ستتم إضافة المستخدم، ولكن لن يتمكن من الوصول إليه إلا بعد تفعيل الحساب.
- اطلب من المستخدم تفعيل حسابه من خلال الانتقال إلى
صفحة
/admin/activate. مثال:https://your-application-id.appspot.com/admin/activate. يجب تسجيل الدخول إلى حساب Google للبريد الإلكتروني الذي أضفته لكي يتم التفعيل. - بعد تفعيل المستخدم لحسابه بنجاح، سيتمكّن من زيارة صفحة
/adminوتفويض الوصول إلى حسابه على"إحصاءات Google"والبدء في إنشاء طلبات بحث عن واجهة برمجة التطبيقات.
المستخدمون الإداريون
تتم إضافة المستخدمين الإداريين للخادم الوكيل في "إحصاءات Google" باستخدام وحدة تحكّم الإدارة في App Engine. وأي مستخدم تتم إضافته من خلال وحدة التحكّم هذه، أي دور، سيكون مشرفًا.
يمكن للمشرفين إدراج أي طلبات بحث في واجهة برمجة التطبيقات للمستخدم وإدارتها.
قيود النطاق
في بعض الحالات، قد ترغب في الاستفادة من الميزات التي يقدمها الخادم الوكيل "إحصاءات Google" ولكن لا تريد عرض أي بيانات بشكل علني بخلاف مجموعة معيّنة من المستخدمين أو النطاق. بشكل تلقائي، يمكن لأي مستخدم يسجّل الدخول باستخدام حساب Google الوصول إلى نقاط النهاية المتاحة للجميع لأي تطبيق مجاني تتم استضافته على App Engine.
إذا كنت تريد تقييد الوصول إلى تطبيقك بشكل أكبر، يجب تنفيذ طبقة المصادقة الخاصة بك أمام الخادم الوكيل في "إحصاءات Google" أو استخدام G Suite، التي تسمح لك بتقييد تطبيق للمستخدمين الخاضعين لإدارة نطاقك. اطّلِع على ضبط مصادقة تطبيقك للحصول على التفاصيل.
اعتبارات الحصص
يساعدك الخادم الوكيل المتميز في "إحصاءات Google" على توفير الحصة من خلال عرض بيانات إعداد التقارير من ذاكرة التخزين المؤقت/متجر البيانات. ومع ذلك، قد يتسبب ضبط فترات زمنية قصيرة لإعادة التحميل في استهلاك الحصة بسرعة. لتجنّب حدوث ذلك، تأكّد من إعادة تحميل طلبات البحث على فترات زمنية معقولة لنوع البيانات المطلوبة.
App Engine
تكون حدود الحصة التلقائية المجانية لتطبيقات App Engine سخرية وقد تكون كافية لمعظم حالات الاستخدام. ومع ذلك، يمكنك تفعيل الفوترة لزيادة الحدود التلقائية أو إزالتها. يمكنك الاطّلاع على حصص App Engine لمعرفة التفاصيل.
&أداة تتبّع المشاكل في المنتدى
منتدى SuperProxy في "إحصاءات Google" هو مجموعة مناقشة يمكنك فيها طرح الأسئلة ومشاركة الأفكار والحصول على ملاحظات حول مشاريعك الرائعة.
أداة تتبّع المشاكل هي المكان الذي يمكنك من خلاله الإبلاغ عن المشاكل وتتبّع طلبات الخادم الوكيل المتميز في "إحصاءات Google" وتتبّعها.