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