تعمل Google Analytics Management API على تفعيل إمكانية الوصول الآلي إلى الحسابات والمواقع والملفات الشخصية. يوضِّح هذا المستند كيفية استخدام موارد واجهة برمجة التطبيقات المختلفة لضبط إعداد حسابك في "إحصاءات Google".
مقدمة
هناك حالتا استخدام شائعتان تتناولهما Management API عندما يتعلق الأمر بتهيئة إعداد حسابك في Google Analytics. تتمثل الأولى في الحاجة إلى الحصول بسرعة على ملخّص حساب للتدرّج الهرمي الكامل للحسابات والمواقع والملفات الشخصية. الطريقة الثانية هي إجراء تغييرات معيّنة في الإعدادات.
ملخّصات الحسابات
توفّر نقطة نهاية ملخّصات الحسابات طريقة سهلة لإدراج معلومات بسيطة عن الحسابات والمواقع والملفات الشخصية على "إحصاءات Google" لمستخدم مفوّض من خلال طلب واحد وسريع.
ويمكن استخدام ملخّصات الحسابات لإنشاء فهرس للتدرّج الهرمي للحساب. من الشائع أن توفر التطبيقات التي تتكامل مع Google Analytics واجهة للمستخدمين ليختاروا حسابًا وموقعًا وملفًا شخصيًا. من خلال إرسال طلب واحد إلى واجهة برمجة التطبيقات، يمكنك استرداد جميع المعلومات ذات الصلة لإنشاء أداة الاختيار هذه. للحصول على مثال، راجع مستكشف طلبات البحث وعيّنات التعليمات البرمجية على جيت هب.
يمكنك الاطّلاع على مرجع "ملخّصات الحسابات" ومرجع طريقة إدراج للحصول على التفاصيل وأمثلة الرموز.
إعداد الحساب
وعلى عكس ملخّصات الحسابات عند استخدام طريقة القوائم في موارد الحساب والموقع والملفّ الشخصي، تعرِض واجهة برمجة التطبيقات التفاصيل الكاملة لكلّ مورد.
Accounts
نظرًا لأن حسابات الكيانات ذات المستوى الأعلى مهمة لأن كل طلب مستوى أقل من واجهة برمجة التطبيقات يتطلب رقم تعريف حساب. تسمح واجهة برمجة تطبيقات الإدارة بتشغيل القائمة في الحسابات فقط. وتجدر الإشارة إلى أنّ استجابة واجهة برمجة التطبيقات هي السمة childlink التي تقدّم طلب البيانات من واجهة برمجة التطبيقات لجميع المواقع الإلكترونية الثانوية.
أماكن إقامة
يُعرف أيضًا باسم "مواقع الويب"، وهو كيان من المستوى الثاني مهم لأن جميع عمليات جمع البيانات تتم في هذا المستوى. على سبيل المثال، عند إضافة رمز تتبّع إلى موقع إلكتروني أو تطبيق متوافق مع الأجهزة الجوّالة، يجب تضمين رقم تعريف يشبه UA-XXXXX-Y. يُطلق على هذا المعرّف اسم رقم تعريف الموقع أو رقم تعريف التتبّع، وهو يميّز بين تخزين بيانات حساب "إحصاءات Google". يمكنك استخدام واجهة برمجة التطبيقات لإنشاء المواقع أو تعديلها، ويمكنك الاطّلاع على مورد الموقع للحصول على تفاصيل وأمثلة على الرموز.
مشاهدة
تُعد الملفات الشخصية مهمة لأنّها المستوى الثالث في التسلسل الهرمي للحساب، لأنّها تمثّل المستوى الذي يتم فيه إعداد التقارير. تستخدم واجهة برمجة التطبيقات الأساسية لإعداد التقارير، رقم تعريف الملف الشخصي (الملف الشخصي) كمَعلمة رئيسية لتحديد الملف الشخصي المطلوب استرداد البيانات منه. بالإضافة إلى كونها على مستوى إعداد التقارير، تكون العديد من الموارد الأخرى مرتبطة أو هي عناصر فرعية لهذا المورد، على سبيل المثال الأهداف والتجارب والتقارير غير المستندة إلى عينات وروابط الفلترة. يمكنك استخدام واجهة برمجة التطبيقات لإنشاء طرق العرض أو تعديلها، ويمكنك الاطّلاع على مورد الملف الشخصي للحصول على تفاصيل وأمثلة على الرموز.
الخطوات التالية
بعد قراءة هذا الدليل، من المفترض أن تكون على دراية جيدة بكيفية استخدام Management API لاجتياز كيانات ضبط الحساب المختلفة ومعالجتها. يتناول الدليل التالي كيفية استخدام واجهة برمجة التطبيقات لتنفيذ إدارة المستخدمين.