توضّح لك هذه الصفحة كيفية بدء استخدام الإصدار 1 من Google Analytics Data API باستخدام سطر الأوامر.
الخطوة 1. تفعيل واجهة برمجة التطبيقات
انقر على هذا الزر لإنشاء مشروع Cloud Platform جديد، وفعِّل تلقائيًا الإصدار 1 من Google Analytics Data API وأنشِئ بيانات اعتماد OAuth2 اللازمة لهذا البرنامج التعليمي:
تفعيل الإصدار 1 من Data API في "إحصاءات Google"ستتم إعادة توجيهك تلقائيًا إلى مربع حوار ضبط بيانات اعتماد OAuth2. اختَر "الكمبيوتر المكتبي" عندما يتم طرح السؤال "من أين تتصل؟"
في مربّع الحوار الذي يظهر، انقر على تنزيل إعدادات البرنامج واحفظ الملف credentials.json
في دليل العمل.
بدلاً من ذلك، يمكنك اتباع هذه الخطوات لإنشاء بيانات اعتماد OAuth2 في مشروع حالي يدويًا.
الخطوة 2. تثبيت Cloud SDK وإعداده
ستحتاج إلى تثبيت أداة سطر الأوامر gcloud على جهاز التطوير.
الخطوة 3: إجراء طلب بيانات من واجهة برمجة التطبيقات
يمكنك الآن استخدام Google Analytics Data API لطلب بحث عن موقع على "إحصاءات Google 4".
اختيار جهة الإبلاغ عن المحتوى
في هذا البرنامج التعليمي، سنستخدم متغير البيئة GA4_PROPERTY_ID
لتخزين رقم تعريف الموقع لاستخدامه في طلبات واجهة برمجة التطبيقات.
أدخِل ما يلي في سطر الأوامر لضبط المتغيّر GA4_PROPERTY_ID
:
export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]
استبدِل [YOUR-GA4-property-ID] بمعرِّف موقعك على "إحصاءات Google 4". مثال:
export GA4_PROPERTY_ID=1234567890
إنشاء ملف JSON للطلب
يوضّح ملف request.json
التالي كيفية إنشاء تقرير بسيط.
أنشئ ملف طلب JSON بالنص التالي، واحفظه كملف نص عادي request.json في دليل العمل:
request.json
{
"dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
"dimensions": [{ "name": "country" }],
"metrics": [{ "name": "activeUsers" }]
}
مصادقة
للحصول على بيانات اعتماد المستخدم في هذا المثال، شغِّل الأمر التالي واستخدِم المسار إلى ملف JSON لبيانات الاعتماد الذي تم تنزيله في الخطوة 1:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/analytics.readonly \
--client-id-file=[PATH/TO/credentials.json]
سيتم فتح مربّع حوار موافقة مستخدم OAuth في نافذة متصفِّح جديدة.
إرسال الطلب
استخدِم curl
ومحتوى النص الأساسي من request.json لإرسال الطلب إلى Data API في "إحصاءات Google". أدخل ما يلي في سطر الأوامر:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json
يستخدم الأمر curl
الأمر gcloud auth application-default print-access-token
للحصول على الرمز المميز للمصادقة.
تجدر الإشارة إلى أنّه لتمرير اسم ملف من أجل curl، يمكنك استخدام الخيار -d
(للبيانات "data") ووضع علامة @ قبل اسم الملف. يجب أن يكون هذا الملف في نفس الدليل
الذي تقوم فيه بتنفيذ الأمر curl.
تهانينا لقد أرسلتَ طلبك الأول إلى Google Analytics Data API.