GA4 API: كيفية سحب بيانتك برمجياً

بقلم Emily Redmond، محللة بيانات في Emilytics · أبريل 2026

الخلاصة السريعة: GA4 Reporting API يتيح لك سحب البيانات برمجياً. بناء التقارير الآلية، لوحات قيادة مخصصة، أو تكاملات بدون تصدير يدوي.

تصدير تقارير GA4 يدويًا ممل. API تُتمتعه. سحب البيانات مباشرة إلى جداول البيانات أو لوحات قيادة مخصصة أو مستودع البيانات الخاص بك.

ما هي GA4 API؟

GA4 Reporting API يتيح لك طلب بيانات GA4 برمجياً. بدلاً من:

1. افتح GA4
2. انقر عبر القوائم
3. صدّر CSV
4. الصق في الجدول

تكتب رمز (أو تستخدم أداة) لـ:

1. طلب البيانات من GA4 API
2. احصل على النتائج تلقائياً
3. حدّث لوحة القيادة/الجدول يومياً

هذا مفيد لـ:

• التقارير المؤتمتة اليومية: رسائل بريد مرسلة إلى أصحاب المصلحة كل صباح
• لوحات قيادة مخصصة: البيانات في Sheets و Looker و Tableau
• تكامل مع أدوات أخرى: أرسل بيانات GA4 إلى CRM و مستودع البيانات و غيره
• تحليل البيانات: سحب البيانات الخام إلى Python/R للتحليل الإحصائي

المتطلبات الأساسية

1. خاصية GA4 مع جمع البيانات
2. مشروع Google Cloud (مجاني)
3. حساب خدمة مع وصول GA4 API
4. معرفة برمجة أساسية (أو استخدم أداة مدمجة مسبقاً مثل Data Studio)

البدء: إعداد حساب الخدمة

الخطوة 1: إنشاء مشروع Google Cloud

1. انتقل إلى console.cloud.google.com
2. أنشئ مشروع جديد (أعلى اليسار، انقر على قائمة المشروع)
3. سمّه (على سبيل المثال، "GA4 API Integration")
4. إنشاء

الخطوة 2: تفعيل GA4 Reporting API

1. في Google Cloud، انتقل إلى APIs & Services → Library
2. ابحث عن "Google Analytics Reporting API"
3. انقر عليه
4. انقر تفعيل

الخطوة 3: إنشاء حساب خدمة

1. انتقل إلى APIs & Services → Credentials
2. انقر إنشاء بيانات اعتماد → حساب خدمة
3. أدخل اسم الحساب (على سبيل المثال، "ga4-api-reader")
4. إنشاء

الخطوة 4: إنشاء مفتاح

1. انقر على حساب الخدمة الذي أنشأته
2. انتقل إلى علامة مفاتيح
3. انقر إضافة مفتاح → إنشاء مفتاح جديد → JSON
4. قم بتنزيل ملف JSON (احفظه—إنه بيانات اعتماد)

الخطوة 5: منح وصول GA4

1. انتقل إلى خاصية GA4 الخاصة بك
2. انتقل إلى المسؤول → إدارة وصول الحساب
3. انقر منح الوصول
4. ادعُ بريد حساب الخدمة (من ملف JSON، يبدو مثل [email protected])
5. أعطِ دور "محرر" أو "محلل"
6. منح

GA4 الآن يثق في حساب الخدمة.

استخدام API: مثال رمز

مثال Python

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest

# هيّئ العميل مع JSON حساب الخدمة الخاص بك
client = BetaAnalyticsDataClient()

# معرّف خاصية GA4 (رقمي، من المسؤول → إعدادات الخاصية)
property_id = "1234567890"

# عرّف التقرير
request = RunReportRequest(
    property=f"properties/{property_id}",
    date_ranges=[{"start_date": "2024-01-01", "end_date": "2024-01-31"}],
    dimensions=[{"name": "date"}, {"name": "country"}],
    metrics=[{"name": "activeUsers"}, {"name": "conversions"}],
)

# شغّل التقرير
response = client.run_report(request)

# اطبع النتائج
for row in response.rows:
    print(row.dimension_values, row.metric_values)

هذا يسحب المستخدمين النشيطين اليوميين والتحويلات حسب البلد لشهر يناير 2024.

مثال Google Sheets (بدون رمز)

إذا كنت لا تريد الترميز، استخدم موصل Google Analytics لـ Sheets:

1. افتح Google Sheets
2. البيانات → موصلات البيانات
3. ابحث عن "Google Analytics"
4. انقر موصل Google Analytics
5. وافق واربط خاصية GA4 الخاصة بك
6. اختر الأبعاد والمقاييس
7. تُحدّث Sheets البيانات تلقائياً يومياً

لا يلزم إعداد API.

استعلامات API الشائعة

التحويلات اليومية

التاريخ، التحويلات
الخاصية: [خاصية GA4 الخاصة بك]
الأبعاد: التاريخ
المقاييس: التحويلات
نطاق التاريخ: آخر 30 يوماً

الإيرادات حسب مصدر المرور

Source/Medium، الإيرادات
الأبعاد: source/medium
المقاييس: الإيرادات
نطاق التاريخ: آخر 7 أيام

أداء الصفحة

الصفحة، المستخدمون، التحويلات، معدل التحويل
الأبعاد: pagePath
المقاييس: activeUsers، conversions
نطاق التاريخ: آخر 30 يوماً

حدود API

• المستوى المجاني: 10,000 طلب/يوم (عادة كافٍ)
• الإبلاغ: حتى 100,000 بُعد لكل طلب
• تحديد معدل: 1,000 طلب متزامن

بالنسبة لمعظم الأعمال، لن تضرب هذه الحدود.

أدوات تستخدم GA4 API داخلياً

أنت لا تحتاج دائماً للترميز. تستخدم هذه الأدوات API وتوفر واجهة:

• Google Data Studio: مجاني، لوحات قيادة مرئية
• موصل Google Sheets: مجاني، يدمج مع Sheets
• Looker Studio: مجاني/مدفوع، تحليلات متقدمة
• Supermetrics: مدفوع، يسحب GA4 إلى Sheets و Excel و البريد الإلكتروني
• أدوات الأتمتة: Zapier و Make و IFTTT يمكن تشغيل استعلامات GA4 API

بالنسبة للمستخدمين غير التقنيين، ابدأ بـ Data Studio أو Sheets Connector.

الأسئلة الشائعة

س: هل GA4 API مجاني؟ ج: نعم، بالنسبة للاستخدام المعقول (معظم الفرق تبقى تحت الحد اليومي).

س: هل أحتاج إلى حساب خدمة لـ API؟ ج: نعم، للوصول المؤتمت. بالتناوب، يمكنك استخدام تدفق OAuth (يوافق المستخدم).

س: ما الفرق بين GA4 API و BigQuery؟ ج: GA4 API جيد للاستعلامات السريعة والأتمتة. BigQuery أفضل للتحليل على نطاق واسع والبيانات التاريخية.

س: هل يمكنني سحب البيانات في الوقت الفعلي؟ ج: GA4 API لديه دعم وقت فعلي محدود. للبيانات في الوقت الفعلي، استخدم Real-Time API أو تقرير الوقت الفعلي في GA4.

س: كم مرة يجب أن أستعلم عن API؟ ج: يومياً نموذجي لمعظم لوحات القيادة. يمكن للاستعلامات في الوقت الفعلي أن تحدث عدة مرات/ساعة، لكن راقب حدود المعدل.

الخلاصة

GA4 API قوية للأتمتة. بدلاً من التصدير اليدوي، سحب البيانات عند الطلب. بناء لوحات قيادة متحدثة. أرسل التقارير اليومية عبر البريد الإلكتروني.

بالنسبة لمعظم الفرق، موصل Google Sheets أو Data Studio كافٍ. لا يلزم ترميز.

إذا كنت بحاجة إلى مزيد من التحكم، تعلّم API. إنها موثقة جيداً وأمثلة Python/JavaScript سهلة للعثور عليها.

Emily Redmond محللة بيانات في Emilytics — وكيل التحليلات الذكي الذي يراقب GA4 و Search Console وبيانات Bing الخاصة بك طوال الوقت حتى لا تفوت ما يهم. 8 سنوات من الخبرة في مساعدة المؤسسين وفرق النمو على تحويل ضوضاء البيانات إلى قرارات واضحة. قل مرحبا →