يقدم هذا المستند نظرة عامة عالية المستوى على الإصدار 3.0 من Google Analytics Management API.
مقدمة
تسمح واجهة برمجة التطبيقات لإدارة "إحصاءات Google" بالوصول الآلي إلى بيانات ضبط "إحصاءات Google" (Universal Analytics فقط). يمكنك إنشاء تطبيقات لإدارة حسابات "إحصاءات Google" الكبيرة أو المعقدة بكفاءة أكبر. بإمكان الشركات الكبيرة التي تمتلك العديد من المواقع إعداد الحساب بشكل مبرمَج. حتى إذا كنت تنشئ تطبيقًا لإعداد التقارير توفّر لك Management API أدوات للتنقّل في حسابك.
يمكنك استخدام Google Analytics Management API من أجل:
- إدراج جميع معلومات الحساب والموقع (Universal Analytics فقط) والملف الشخصي لمستخدِم معيَّن
- إدارة المواقع (Universal Analytics فقط) والملفات الشخصية (الملفات الشخصية) والأهداف
- يمكنك إدارة أذونات المستخدمين في أحد التدرّجات الهرمية للحساب.
- استرجع رقم تعريف ملف شخصي (ملف شخصي) لاستخدامه مع واجهة برمجة التطبيقات الأساسية لإعداد التقارير.
- تحديد الأهداف النشطة والوصول إلى أسمائها التي تم تكوينها.
- يمكنك إدارة الروابط بين مواقع "إحصاءات Google" (Universal Analytics فقط) وحسابات "إعلانات Google".
- إدارة شرائح جمهور تجديد النشاط التسويقي .
قبل استخدام Google Analytics Management API، من المهم التعرّف على بنية حساب "إحصاءات Google". يتم تنظيم حساب "إحصاءات Google" في عدة مستويات، وتوفّر Management API طريقة آلية للتفاعل مع الكيانات على كل مستوى.
استخدام Management API
لاستخدام واجهة برمجة التطبيقات Google Analytics API، عليك أولاً إنشاء مشروع في وحدة تحكم المطوّرين. أثناء هذه العملية، عليك تحديد نوع التطبيق الذي تنشئه، أي تطبيق ويب أو تطبيق خدمة أو تطبيق مثبَّت. سترشدك وحدة تحكّم المطوّرين خلال خطوات إنشاء مفاتيح التفويض المناسبة، وذلك لأنّ واجهات برمجة تطبيقات "إحصاءات Google" تستخدم بروتوكول OAuth 2.0 للمصادقة والترخيص. تتوفّر مكتبات للعملاء بلغات مختلفة. ستساعدك مكتبات العملاء في إنشاء المسار المناسب لتفويض المستخدم لتطبيقك للوصول إلى بياناته على "إحصاءات Google" باستخدام النطاقات المناسبة.
استخدام هذه المستندات
سيساعدك هذا المستند والأدلّة اللاحقة على إعداد التطبيق وتشغيله في البداية، ثم ستتناول المستندات بالتفصيل المواضيع المختلفة التي من المفترض أن تساعدك في التفاعل مع واجهة برمجة التطبيقات لتنفيذ إجراءات مثل إدارة الحساب والمستخدم والبيانات. هناك أيضًا مجموعة كاملة من المستندات المرجعية التي توفر تفاصيل عن كل مَعلمة لكل نقطة نهاية لواجهة برمجة التطبيقات وتتضمّن نموذجًا للرمز البرمجي لواجهة برمجة التطبيقات.
الخطوات التالية
ينطوي الحصول على تطبيق عمل باستخدام واجهة برمجة تطبيقات جديدة دائمًا على بعض التحديات. يقدّم القسم التالي مجموعة من أدلة البدء السريع لمساعدتك في إكمال عملية الإعداد بسرعة. ستحتاج إلى اختيار لغة ونوع التطبيق:
| تطبيق الخدمة | تطبيق مُثبَّت | تطبيق الويب |
|---|---|---|
| Java | Java | -- |
| Python | Python | -- |
| PHP | -- | PHP |
| -- | -- | JavaScript |