عرض تقارير متعددة في دفعة واحدة. يجب أن تكون جميع التقارير للموقع نفسه على "إحصاءات Google 4".
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي. للمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. يجب تحديد هذه السمة للدفعة. قد تكون الخاصية في RunReportRequest غير محددة أو متسقة مع هذه السمة. مثال: Property/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 وليس في النص الأساسي. للمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. ضمن الطلب المجمّع، يجب أن تكون هذه السمة غير محدّدة أو متسقة مع السمة على المستوى المجمّع. مثال: Property/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. إذا كانت القيمة "صحيح"، سيتم عرض هذه الصفوف إذا لم تتم إزالتها بشكل منفصل من خلال فلتر. بغض النظر عن إعداد على سبيل المثال، إذا لم يسجِّل أحد المواقع حدث |
returnPropertyQuota |
تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة موقع "إحصاءات Google" هذا. يتم عرض الحصة في PropertyQuota. |
comparisons[] |
اختياريّ. ضبط إعدادات المقارنات المطلوبة وعرضها. يتطلّب الطلب فقط حقل مقارنات حتى يتلقّى عمود مقارنة في الردّ. |