تعرض تقارير متعددة دفعة واحدة. يجب أن تكون جميع التقارير للموقع نفسه على "إحصاءات Google 4".
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي لمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. يجب تحديد هذه السمة للدُفعة. قد تكون الخاصية في RunReportRequest غير محددة أو متوافقة مع هذه السمة. مثال: المواقع الإلكترونية/1234 |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"requests": [
{
object ( |
الحقول | |
---|---|
requests[] |
الطلبات الفردية: يحتوي كل طلب على رد منفصل للتقرير. يمكن إرسال 5 طلبات كحد أقصى لكل طلب مجمّع. |
نص الاستجابة
الرد المجمّع الذي يحتوي على تقارير متعددة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"reports": [
{
object ( |
الحقول | |
---|---|
reports[] |
الردود الفردية لكل ردّ طلب تقرير منفصل. |
kind |
يحدد نوع المورد الذي ينتمي إليه هذه الرسالة. تكون قيمة |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
طلب إنشاء تقرير.
تمثيل JSON |
---|
{ "property": string, "dimensions": [ { object ( |
الحقول | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي لمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. ضمن الطلب المجمّع، يجب أن تكون هذه السمة غير محدّدة أو متوافقة مع الموقع على مستوى الدفعة. مثال: المواقع الإلكترونية/1234 |
dimensions[] |
السمات المطلوبة والمعروضة |
metrics[] |
المقاييس المطلوبة والمعروضة |
dateRanges[] |
النطاقات الزمنية للبيانات المطلوب قراءتها في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف استجابة على فهرس نطاق زمني يستند إلى صفر. وفي حال تداخل نطاقَين زمنيَين، يتم تضمين بيانات الأحداث للأيام المتداخلة في صفوف الردود لكلا النطاقَين الزمنيَين. في طلب المجموعة النموذجية، يجب عدم تحديد قيمة |
dimensionFilter |
تتيح لك فلاتر السمات طلب قيم سمات معيّنة فقط في التقرير. لمزيد من المعلومات، اطّلِع على أساسيات فلاتر السمات للحصول على أمثلة. لا يمكن استخدام المقاييس في هذا الفلتر. |
metricFilter |
عبارة تصفية المقاييس. يتم تطبيقها بعد تجميع صفوف التقرير، على غرار لغة SQL التي تحتوي على عبارة. لا يمكن استخدام الأبعاد في هذا الفلتر. |
offset |
عدد صفوف صف البداية. يتم احتساب الصف الأول على أنه الصف 0. عند الترحيل، لا يحدد الطلب الأول الإزاحة؛ أو ما يعادل ذلك، يتم تعيينها على 0؛ يعرض الطلب الأول أول لمزيد من المعلومات عن مَعلمة تقسيم النتائج على عدّة صفحات، يمكنك الاطّلاع على مقالة التقسيم على صفحات. |
limit |
عدد الصفوف المطلوب عرضها. في حال عدم تحديد قيمة الحقل، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحدٍ أقصى لكل طلب، بغض النظر عن عدد الصفوف التي تطلبها. يجب أن تكون قيمة ويمكن أن تعرض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة لمزيد من المعلومات عن مَعلمة تقسيم النتائج على صفحات، يمكنك الاطّلاع على مقالة التقسيم على صفحات. |
metricAggregations[] |
تجميع المقاييس. ستظهر قيم المقاييس المجمّعة في صفوف تم فيها ضبط قيم السمة على RESERVED_(MetricAggregation)". |
orderBys[] |
لتحديد كيفية ترتيب الصفوف في الردّ. |
currencyCode |
رمز عملة بتنسيق ISO4217، مثل "AED" و"USD" و"JPY". إذا كان الحقل فارغًا، يستخدِم التقرير العملة التلقائية للموقع. |
cohortSpec |
المجموعة النموذجية المرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، تحتوي "المجموعة النموذجية" أن يكون متوفرًا. |
keepEmptyRows |
إذا كانت القيمة "خطأ" أو "غير محدّدة"، لن يتم عرض كل صف يحتوي على جميع المقاييس التي تساوي 0. إذا كانت القيمة true، فسيتم عرض هذه الصفوف إذا لم تتم إزالتها بشكل منفصل بواسطة عامل تصفية. بغض النظر عن إعداد على سبيل المثال، إذا لم يسجِّل أحد المواقع حدث |
returnPropertyQuota |
تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة هذا الموقع على "إحصاءات Google". يتم عرض الحصة في PropertyQuota. |
comparisons[] |
اختياريّ. ضبط إعدادات المقارنات المطلوبة وعرضها لا يتطلّب الطلب سوى حقل مقارنات لكي يتلقّى عمود مقارنة في الردّ. |