التشغيل السريع لواجهة برمجة التطبيقات باستخدام سطر الأوامر

توضّح لك هذه الصفحة كيفية بدء استخدام الإصدار 1 من Google Analytics Data API باستخدام الأمر الخط.

الخطوة 1: تفعيل واجهة برمجة التطبيقات

انقر على الزر التالي لإنشاء مشروع جديد على Google Cloud تلقائيًا. تفعيل الإصدار 1 من Google Analytics Data API وإنشاء بيانات اعتماد OAuth2 اللازمة لهذا الغرض الدليل التوجيهي:

تفعيل الإصدار الأول من Google Analytics Data API

ستتم إعادة توجيهك تلقائيًا إلى إعدادات بيانات اعتماد OAuth2. . عندما يسأل مربع الحوار عن السؤال من أين تتصل؟، اختَر جهاز الكمبيوتر المكتبي:

في مربّع الحوار الذي يظهر، انقر على تنزيل إعدادات البرنامج واحفظ الملف. credentials.json إلى دليل العمل.

بدلاً من ذلك، يمكنك اتباع هذه الخطوات لإنشاء OAuth2. بيانات الاعتماد في حساب حالي مشروعك يدويًا.

الخطوة 2: تثبيت حزمة تطوير البرامج (SDK) للسحابة الإلكترونية وإعدادها

ستحتاج إلى سطر الأوامر gcloud أداة أخرى مثبتة على جهاز التطوير.

الخطوة 3: إجراء طلب بيانات من واجهة برمجة التطبيقات

يمكنك الآن استخدام Google Analytics Data API لطلب بحث عن الموقع.

اختيار الكيان القائم بالإبلاغ

سنستخدم في هذا البرنامج التعليمي متغير البيئة GA_PROPERTY_ID لتخزين رقم تعريف الموقع لاستخدامه في طلبات البيانات من واجهة برمجة التطبيقات.

أدخِل ما يلي في سطر الأوامر لضبط متغيّر GA_PROPERTY_ID:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

استبدال [YOUR_GA_PROPERTY_ID] بـ موقعك على "إحصاءات Google" المعرّف. على سبيل المثال:

export GA_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 لإرسال الطلب إلى واجهة برمجة التطبيقات لبيانات "إحصاءات 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/$GA_PROPERTY_ID:runReport -d @request.json

يستخدِم الأمر curl الأمر gcloud auth application-default print-access-token للحصول على رمز مصادقة.

يُرجى العِلم أنّه لتمرير اسم ملف إلى أعلى الشاشة، استخدِم الخيار -d (لـ "data") اكتب اسم الملف بعلامة @. يجب أن يكون هذا الملف في الدليل نفسه. الذي يتم فيه تنفيذ أمر curl.