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