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

توضّح لك هذه الصفحة كيفية بدء استخدام الإصدار 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.