إدارة الحساب

تعمل Google Analytics Management API على تفعيل الوصول الآلي إلى الحسابات والمواقع والملفات الشخصية. يصف هذا المستند كيفية استخدام الموارد المتنوعة لواجهة برمجة التطبيقات لضبط إعداد حسابك في Google Analytics.

مقدمة

هناك حالتا استخدام شائعتان تتناولهما Management API عندما يتعلق الأمر بتهيئة إعداد حسابك في Google Analytics. تتمثل الطريقة الأولى في الحاجة إلى الحصول بسرعة على ملخّص للحساب للتدرّج الهرمي الكامل للحسابات والمواقع والملفات الشخصية. والطريقة الثانية هي إجراء تغييرات محدَّدة على الضبط.

ملخّصات الحسابات

توفّر نقطة نهاية ملخّصات الحسابات طريقة سهلة لعرض معلومات بسيطة عن حسابات "إحصاءات Google" ومواقعها وملفاتها الشخصية لمستخدم مفوّض من خلال طلب واحد سريع.

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

يمكنك الاطّلاع على مرجع مراجع "ملخّصات الحسابات" وإدراج مرجع طريقة للاطّلاع على التفاصيل والأمثلة على الرموز.

إعداد الحساب

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

Accounts

تعتبر حسابات الكيانات ذات المستوى الأعلى مهمة لأن كل طلب بمستوى أقل من واجهة برمجة التطبيقات يتطلب رقم تعريف حساب. لا تسمح واجهة برمجة التطبيقات Management API إلا بتشغيل عملية list على الحسابات. جدير بالذكر أنّ استجابة واجهة برمجة التطبيقات هي السمة childlink التي تقدّم طلب البيانات من واجهة برمجة التطبيقات لجميع المواقع الإلكترونية الفرعية.

أماكن إقامة

يُعرف أيضًا باسم "مواقع الويب"، وهو كيان من المستوى الثاني مهمًا لأن جميع عمليات جمع البيانات تحدث على هذا المستوى. على سبيل المثال، عند إضافة رمز تتبّع إلى موقع إلكتروني أو تطبيق متوافق مع الأجهزة الجوّالة، يجب تضمين رقم تعريفي يشبه UA-XXXXX-Y. يُطلق على هذا المعرّف اسم رقم تعريف الموقع أو رقم تعريف التتبّع، وهو يميّز بين تخزين بيانات حساب "إحصاءات Google". ويمكنك استخدام واجهة برمجة التطبيقات لإنشاء المواقع أو تعديلها، ويمكنك الاطّلاع على مورد الموقع للحصول على تفاصيل وأمثلة على الرموز.

المشاهدات

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

الخطوات التالية

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