Method: reports.batchGet

عرض بيانات "إحصاءات Google".

طلب HTTP

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

يستخدم عنوان URL بنية gRPC Transcoding.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
الحقول
reportRequests[]

object(ReportRequest)

الطلبات، سيكون لكل طلب رد منفصل. يمكن ألا يزيد عدد الطلبات عن 5. يجب أن تحتوي جميع الطلبات على dateRanges وviewId وsegments وsamplingLevel وcohortGroup نفسها.

useResourceQuotas

boolean

تعمل هذه السياسة على تفعيل الحصص المستندة إلى الموارد، (يتم ضبطها تلقائيًا على False). وفي حال ضبط هذا الحقل على True، ستخضع الحصص لكل مشاهدة (الملف الشخصي) للتكلفة الحاسوبية للطلب. لاحظ أن استخدام الحصص المستندة إلى التكلفة سيؤدي إلى زيادة معدلات أخذ العينات. (10 ملايين مقابل SMALL، و100 مليون مقابل LARGE. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات الحدود والحصص.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

فئة الرد الرئيسية التي تحتفظ بالتقارير من طلب batchGet لواجهة برمجة التطبيقات لإعداد التقارير.

تمثيل JSON 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
الحقول
reports[]

object(Report)

الردود المناسبة لكل طلب.

queryCost

number

مقدار الرموز المميّزة لحصة الموارد التي تم خصمها لتنفيذ طلب البحث. يتضمن جميع الردود.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

يشير هذا إلى حجم حصة الموارد المتبقية للموقع.

نطاقات الأذونات

يتطلّب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

طلب تقرير

فئة الطلب الرئيسية التي تحدّد طلب واجهة برمجة التطبيقات لإعداد التقارير.

تمثيل JSON 
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
الحقول
viewId

string

رقم تعريف الملف الشخصي في "إحصاءات Google" الذي يمكن من خلاله استرداد البيانات. يجب أن يحتوي كل ReportRequest في طريقة batchGet على viewId نفسها.

dateRanges[]

object(DateRange)

النطاقات الزمنية في الطلب يمكن أن يتضمّن الطلب نطاقَين زمنيَين كحدّ أقصى. ستحتوي الاستجابة على مجموعة من قيم المقاييس لكل مجموعة من الأبعاد لكل نطاق زمني في الطلب. وبالتالي، إذا كان هناك نطاقان زمنيان، ستكون هناك مجموعتان من قيم المقياس، إحداهما للنطاق الزمني الأصلي والأخرى للنطاق الزمني الثاني. يجب عدم تحديد الحقل reportRequest.dateRanges للمجموعات النموذجية أو طلبات القيمة الدائمة. في حال عدم توفير نطاق زمني، يكون النطاق الزمني التلقائي هو (startDate: التاريخ الحالي - 7 أيام، أو تاريخ الانتهاء: التاريخ الحالي - يوم واحد). يجب أن يحتوي كل ReportRequest ضمن طريقة batchGet على تعريف dateRanges نفسه.

samplingLevel

enum(Sampling)

حجم نموذج التقرير المطلوب وإذا لم يتم تحديد الحقل samplingLevel، يتم استخدام مستوى أخذ العينات DEFAULT. يجب أن يحتوي كل ReportRequest ضمن طريقة batchGet على تعريف samplingLevel نفسه. اطّلِع على دليل المطوِّر لمعرفة التفاصيل.

dimensions[]

object(Dimension)

الأبعاد المطلوبة. يمكن أن يصل إجمالي الطلبات إلى 9 أبعاد.

dimensionFilterClauses[]

object(DimensionFilterClause)

عبارات فلتر المكوّن لفلترة قيم السمات. يتم دمجها بشكلٍ منطقي مع عامل تشغيل AND. لاحظ أن الفلترة تحدث قبل تجميع أي سمات، بحيث تمثل المقاييس المعروضة إجمالي الأبعاد ذات الصلة فقط.

metrics[]

object(Metric)

المقاييس المطلوبة. يجب أن تحدّد الطلبات مقياسًا واحدًا على الأقل. يمكن أن تحتوي الطلبات على 10 مقاييس في المجمل.

metricFilterClauses[]

object(MetricFilterClause)

عبارات فلتر المقياس. يتم دمجها بشكلٍ منطقي مع عامل تشغيل AND. تفحص فلاتر المقاييس النطاق الزمني الأول فقط وليس النطاق الزمني لمقارنة البيانات. يُرجى العِلم أن الفلترة حسب المقاييس تحدث بعد تجميع المقاييس.

filtersExpression

string

فلاتر المكوّنات أو المقاييس التي تحدّ من البيانات المعروضة لطلبك. لاستخدام filtersExpression، أدخِل مكوّنًا أو مقياسًا للفلترة، متبوعًا بتعبير الفلتر. على سبيل المثال، يختار التعبير التالي بُعد ga:browser الذي يبدأ بـ Firefox؛ ga:browser=~^Firefox. لمزيد من المعلومات عن المكوّنات وفلاتر المقاييس، اطّلِع على مرجع الفلاتر.

orderBys[]

object(OrderBy)

ترتيب النتائج في صفوف النتائج لمقارنة صفين، يتم تطبيق عناصر ما يلي بالترتيب حتى يتم العثور على الفرق. تحصل كل النطاقات الزمنية في الناتج على ترتيب الصفوف نفسه.

segments[]

object(Segment)

قسِّم البيانات المعروضة للطلب. يساعد تعريف الشريحة في فحص مجموعة فرعية من طلب الشريحة. يمكن أن يحتوي الطلب على أربع شرائح بحدٍ أقصى. يجب أن يحتوي كل ReportRequest ضمن طريقة batchGet على تعريف segments نفسه. يجب أن تحتوي الطلبات المصحوبة بشرائح على السمة ga:segment.

pivots[]

object(Pivot)

التعريفات المحورية. يمكن أن تتضمن الطلبات محورَين رئيسيَين كحد أقصى.

cohortGroup

object(CohortGroup)

المجموعة النموذجية المرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، يجب أن تتوفّر السمة ga:cohort. يجب أن يحتوي كل ReportRequest ضمن طريقة batchGet على تعريف cohortGroup نفسه.

pageToken

string

رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. ستؤدي إضافة هذا إلى الطلب إلى عرض الصفوف بعد pageToken. يجب أن تكون pagepageToken القيمة التي يتم عرضها في معلّمة NextPageToken في الاستجابة لطلب report.batchGet.

pageSize

number

إنّ حجم الصفحة مخصّص للصفحات ويحدّد الحد الأقصى لعدد الصفوف المعروضة. يجب أن يكون حجم الصفحة ">= 0". يعرض طلب البحث 1,000 صف التلقائي. تعرض واجهة برمجة التطبيقات الأساسية لإعداد التقارير في "إحصاءات Google" 100,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. ويمكن أن يعرض أيضًا عددًا أقل من الصفوف المطلوبة، إذا لم يكن هناك أي عدد تتوقّعه من شرائح السمات. على سبيل المثال، هناك أقل من 300 قيمة محتملة لـ ga:country، لذلك عند التقسيم حسب البلد فقط، لا يمكنك الحصول على أكثر من 300 صف، حتى إذا ضبطت pageSize على قيمة أعلى.

includeEmptyRows

boolean

في حال ضبطها على "خطأ"، لن تتضمّن الاستجابة صفوفًا إذا كانت جميع المقاييس التي تم استردادها مساوية للصفر. الإعداد التلقائي هو "خطأ" ما سيؤدي إلى استبعاد هذه الصفوف.

hideTotals

boolean

في حال ضبطها على "صحيح"، يتم إخفاء إجمالي كل المقاييس لجميع الصفوف المطابقة لكل نطاق زمني. وسيتم عرض القيم الخاطئة بشكل تلقائي.

hideValueRanges

boolean

في حال ضبطها على "صحيح"، يتم إخفاء الحد الأدنى والأقصى في جميع الصفوف المطابقة. والقيمة التلقائية هي "خطأ" ويتم عرض نطاقات القيم.

أخذ العينات

قيم على مستوى العينات.

عمليات التعداد
SAMPLING_UNSPECIFIED وإذا لم يتم تحديد الحقل samplingLevel، يتم استخدام مستوى أخذ العينات DEFAULT.
DEFAULT تعرض الاستجابة بحجم عيّنة يوازن السرعة والدقة.
SMALL ويعرض الرد استجابة سريعة بحجم عينات أصغر.
LARGE عرض استجابة أكثر دقة باستخدام حجم أخذ العينات الكبير. وقد يؤدي ذلك إلى أن تكون الاستجابة أبطأ.

السمة

الأبعاد هي سمات بياناتك. على سبيل المثال، تشير السمة ga:city إلى المدينة، على سبيل المثال، "باريس" أو "نيويورك";التي نشأت منها جلسة.

تمثيل JSON 
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
الحقول
name

string

اسم البُعد المطلوب جلب، على سبيل المثال ga:browser.

histogramBuckets[]

string (int64 format)

وإذا لم يكن فارغًا، نضع قيم السمات في مجموعات البيانات بعد السلسلة إلى int64. وسيتم تحويل قيم السمات التي لا تمثّل سلسلة متكاملة لقيمة متكاملة إلى صفر. يجب أن تكون قيم حزمة البيانات في ترتيب متزايد. تكون كل مجموعة مغلقة في الطرف السفلي وتفتح في الجهة العلوية. تشمل الحِزمة "first"quot;جميع القيم الأقل من الحد الأول و &&;;;;;last" مجموعة البيانات التي تشمل كل القيم حتى الحد الأقصى. يتم تحويل قيم البُعد التي تقع في مجموعة إلى قيمة بُعد جديدة. على سبيل المثال، إذا قدّمت إحدى القوائم قائمة بـ "&" أو 1 أو 1 أو 3 أو 4 أو 7&quot، سيتم عرض الحِزم التالية:

  • الحزمة #1: القيم &lt؛ 0، قيمة المكوّن "<0"
  • الحزمة رقم 2: القيم في [0،1)، قيمة المكوّن "0&quot؛
  • الحزمة رقم 3: القيم في [1,3)، قيمة المكوّن "1-2&quot؛
  • الحزمة رقم 4: القيم في [3,4)، قيمة المكوّن "3&quot؛
  • الحزمة رقم 5: القيم في [4,7)، قيمة المكوّن "4-6&quot؛
  • الحزمة #6: القيم >= 7، قيمة البُعد "7+&quot؛

ملاحظة: إذا كنت تُطبِّق المدرّج التكراري على أي بُعد، وتستخدم هذا البُعد في الترتيب، ستحتاج إلى استخدام نوع الترتيب HISTOGRAM_BUCKET لهذا الغرض. وبدون ذلك، سيتم ترتيب قيم البُعد وفقًا لترتيب القاموس (المعجم). على سبيل المثال، يكون ترتيب القاموس تصاعديًا:

&;;lt;50"&&;;1001+"&&;;121-1000"&&;;00-120"

وَتَصْبِحُ مُتَوَفِّرَ HISTOGRAM_BUCKET صَاعِدًا هُوَ:

&;;lt;50"&&;;00-120"&&;;121-1000","1001+"

يجب على العميل طلب "orderType": "HISTOGRAM_BUCKET" صراحةً للبُعد المتغيّر المدرّج.

عبارة تعريف الفلتر

مجموعة من فلاتر المكوّنات حدِّد قيمة عامل التشغيل لتحديد كيفية دمج الفلاتر بشكلٍ منطقي.

تمثيل JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
الحقول
operator

enum(FilterLogicalOperator)

عامل التشغيل للدمج بين فلاتر أبعاد متعددة. إذا لم يتم تحديد الخاصية، سيتم التعامل معها على أنها OR.

filters[]

object(DimensionFilter)

مجموعة الفلاتر المتكرّرة ويتم دمجها بشكلٍ منطقي استنادًا إلى عامل التشغيل المحدّد.

عامل تشغيل LogLogical

كيفية دمج الفلاتر بطريقة منطقية

عمليات التعداد
OPERATOR_UNSPECIFIED عامل تشغيل غير محدّد. ويتم التعامل معه على أنّه OR.
OR عامل التشغيل OR المنطقي.
AND عامل التشغيل AND المنطقي.

فلتر المكوّن

يحدد فلتر البُعد خيارات الفلترة في أي بُعد.

تمثيل JSON 
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
الحقول
dimensionName

string

المكوّن الذي تريد الفلترة وفقًا له. يجب أن يحتوي فلتر البُعد على بُعد.

not

boolean

عامل تشغيل NOT المنطقي. إذا تم ضبط هذه القيمة المنطقية على "صحيح"، سيتم استبعاد قيم البُعد المطابقة في التقرير. وتكون القيمة التلقائية هي "خطأ".

operator

enum(Operator)

كيفية مطابقة البُعد مع التعبير. الإعداد التلقائي هو REGexp.

expressions[]

string

السلاسل أو التعبير العادي الذي تتطابق معه. يتم استخدام القيمة الأولى فقط للقائمة للمقارنة ما لم يكن عامل التشغيل هو IN_LIST. إذا تم استخدام عامل تشغيل IN_LIST، سيتم استخدام القائمة بأكملها لفلترة السمات كما هو موضّح في وصف عامل تشغيل IN_LIST.

caseSensitive

boolean

هل يجب أن تكون المطابقة حسّاسة لحالة الأحرف؟ الإعداد التلقائي هو "خطأ".

المُشغِّل

أنواع المطابقة المختلفة المتاحة.

عمليات التعداد
OPERATOR_UNSPECIFIED إذا لم يتم تحديد نوع المطابقة، سيتم التعامل معه على أنه REGEXP.
REGEXP يتم التعامل مع تعبير المطابقة على أنه تعبير عادي. لا يتم التعامل مع جميع أنواع المطابقة كتعبيرات عادية.
BEGINS_WITH تتطابق مع القيمة التي تبدأ بتعبير المطابقة الذي تم تقديمه.
ENDS_WITH يطابق القيم التي تنتهي بتعبير المطابقة الذي تم تقديمه.
PARTIAL مطابقة سلسلة فرعية.
EXACT يجب أن تتطابق القيمة مع تعبير المطابقة تمامًا.
NUMERIC_EQUAL

فلاتر مقارنة عدد صحيح ويتم تجاهل الحساسية لحالة الأحرف هذه ويُفترض أن يكون التعبير سلسلة تمثّل عددًا صحيحًا. شروط الفشل:

  • إذا لم يكن التعبير int64 صالحًا، يجب أن يتوقع العميل خطأ.
  • ولن تتطابق أبدًا أبعاد الإدخال التي ليست قيم int64 صالحة مع الفلتر.
NUMERIC_GREATER_THAN للتحقق مما إذا كان البُعد أكبر عددًا من تعبير المطابقة. اطّلِع على وصف NUMERIC_EQUALS لمعرفة القيود.
NUMERIC_LESS_THAN للتحقق مما إذا كان البُعد أقل من تعبير المطابقة رقميًا. اطّلِع على وصف NUMERIC_EQUALS لمعرفة القيود.
IN_LIST

يُستخدَم هذا الخيار لتحديد فلتر مكوّن يمكن أن يحصل تعبيره على أي قيمة من قائمة قيم محدّدة. ويساعد ذلك على تجنُّب تقييم فلاتر متعدّدة لمكوّنات المطابقة التامة يتم استخدامها مع كل صف استجابة واحد. مثلاً:

expressions: ["A", "B", "C"]

يتطابق أي صف استجابة ويحتوي على البُعد "أ" أو "ب" أو "ج" مع هذا المكوّن.

المقياس

المقاييس هي عبارة عن قياسات كمية. على سبيل المثال، يشير المقياس ga:users إلى إجمالي عدد المستخدمين خلال الفترة الزمنية المطلوبة.

تمثيل JSON 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
الحقول
expression

string

تمثّل هذه السمة تعبيرًا مقياسيًا في الطلب. يتم إنشاء تعبير من مقياس ورقم واحد أو أكثر. تشمل عوامل التشغيل المقبولة: علامة الجمع (+)، علامة الطرح (-)، علامة المحايدة (-)، مقسومًا على (/)، مقسومًا على (*)، الأقواس، الأرقام الأساسية الموجبة (0-9)، يمكن أن تشمل أرقامًا عشرية وتقتصر على 1024 حرفًا. على سبيل المثال ga:totalRefunds/ga:users، في معظم الحالات، يكون التعبير العادي مقياسًا واحدًا فقط مثل ga:users. إضافة MetricType مختلطة (مثل CURRENCY في مقابل PERCENTAGE) سيؤدي ذلك إلى نتائج غير متوقعة.

alias

string

الاسم المستعار لتعبير المقياس هو اسم بديل للتعبير. يمكن استخدام الاسم المستعار للفلترة والترتيب. هذا الحقل اختياري وتكون مفيدة إذا كان التعبير ليس مقياسًا واحدًا ولكنه تعبير مركّب لا يمكن استخدامه في الفلترة والترتيب. يُستخدم العنوان البديل أيضًا في عنوان عمود "الاستجابة".

formattingType

enum(MetricType)

تحدِّد كيفية تنسيق تعبير المقياس، مثل INTEGER.

نوع المقياس

أنواع المقاييس.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED لم يتم تحديد نوع المقياس.
INTEGER مقياس صحيح.
FLOAT المقياس العائم
CURRENCY مقياس العملة
PERCENT النسبة المئوية للمقياس
TIME مقياس الوقت بتنسيق HH:MM:SS.

عبارة [فلتر الفلتر]

ويمثل مجموعة من فلاتر المقاييس. حدِّد قيمة عامل التشغيل لتحديد كيفية دمج الفلاتر بشكلٍ منطقي.

تمثيل JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
الحقول
operator

enum(FilterLogicalOperator)

عامل التشغيل لدمج فلاتر مقاييس متعددة. إذا لم يتم تحديد الخاصية، سيتم التعامل معها على أنها OR.

filters[]

object(MetricFilter)

مجموعة الفلاتر المتكرّرة ويتم دمجها بشكلٍ منطقي استنادًا إلى عامل التشغيل المحدّد.

فلتر المقياس

يحدد مقياس المقياس الفلتر في مقياس.

تمثيل JSON 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
الحقول
metricName

string

المقياس الذي ستتم تصفيته يجب أن يحتوي مقياس المقياس على اسم مقياس. يمكن أن يكون اسم المقياس اسمًا مستعارًا يتم تحديده مسبقًا على أنه مقياس أو يمكن أن يكون أيضًا تعبيرًا عن المقياس.

not

boolean

عامل تشغيل NOT المنطقي. إذا تم ضبط هذه القيمة المنطقية على "صحيح"، سيتم استبعاد قيم المقياس المطابقة في التقرير. وتكون القيمة التلقائية هي "خطأ".

operator

enum(Operator)

ويتم استخدام المقياس EQUAL أو LESS_THAN أو GREATER_THAN، حيث إن المقياس التلقائي هو EQUAL. إذا كان عامل التشغيل هو IS_MISSING، يُرجى التحقّق مما إذا كان المقياس غير متوفّر وسيتجاهل قيمة المقارنة.

comparisonValue

string

القيمة التي تريد مقارنتها.

المُشغِّل

الخيارات المختلفة لأنواع المقارنة:

عمليات التعداد
OPERATOR_UNSPECIFIED إذا لم يتم تحديد عامل التشغيل، سيتم التعامل معه على أنه EQUAL.
EQUAL يجب أن تكون قيمة المقياس مساوية تمامًا لقيمة المقارنة.
LESS_THAN إذا كانت قيمة المقياس أقل من قيمة المقارنة.
GREATER_THAN يجب أن تكون قيمة المقياس أكبر من قيمة المقارنة.
IS_MISSING تحقَّق مما إذا كان المقياس غير متوفّر. لا يتم وضع المقارنة بين القيمة في الاعتبار.

ترتيب حسب

تحدّد خيارات الترتيب.

تمثيل JSON 
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
الحقول
fieldName

string

الحقل المطلوب الترتيب منه. ويتم ترتيب عمليات الترتيب التلقائية بشكل تصاعدي. مثال: ga:browser لاحظ أنه يمكنك تحديد حقل واحد فقط للترتيب هنا. مثلاً، ga:browser, ga:city غير صالح.

orderType

enum(OrderType)

نوع الطلب الترتيب التلقائي هو VALUE.

sortOrder

enum(SortOrder)

ترتيب الترتيب للحقل.

نوع الطلب

يتحكّم OrderType في طريقة تحديد الترتيب.

عمليات التعداد
ORDER_TYPE_UNSPECIFIED سيتم التعامل مع نوع الطلب غير المحدَّد على أنه مرتَّب استنادًا إلى القيمة.
VALUE يستند ترتيب الترتيب إلى قيمة العمود الذي تم اختياره، ولا ينظر إلا إلى النطاق الزمني الأول.
DELTA يستند ترتيب الترتيب إلى اختلاف قيم العمود الذي تم اختياره بين أول نطاقين زمنيين. لا يمكن استخدامها إلا إذا كان هناك نطاقان زمنيان بالضبط.
SMART يستند نظام الترتيب إلى القيمة المرجّحة للعمود الذي تم اختياره. إذا كان العمود يحتوي على تنسيق n/d، ستكون القيمة المرجّحة لهذه النسبة (n + totals.n)/(d + totals.d) قابلة للاستخدام فقط للمقاييس التي تمثّل النِسب.
HISTOGRAM_BUCKET لا يمكن استخدام نوع طلب المدرّج التكراري إلا مع أعمدة السمات التي لا تتضمّن حِزم مدرّجة مدرّجة غير فارغة.
DIMENSION_AS_INTEGER إذا كانت الأبعاد أرقامًا ثابتة، سيكون الترتيب العادي مناسبًا. يمكن استخدام DIMENSION_AS_INTEGER إذا كانت الأبعاد عبارة عن أرقام متغيّرة.

SortOrder

تمثّل هذه السمة ترتيب الترتيب.

عمليات التعداد
SORT_ORDER_UNSPECIFIED إذا لم يتم تحديد ترتيب الترتيب، سيتم الترتيب التصاعدي تلقائيًا.
ASCENDING ترتيب تصاعدي. سيتم ترتيب الحقل بطريقة تصاعدية.
DESCENDING ترتيب تنازلي. سيتم ترتيب الحقل تنازليًا.

قسم

تعريف الشريحة، إذا كان التقرير بحاجة إلى التقسيم. الشريحة هي مجموعة فرعية من بيانات "إحصاءات Google". على سبيل المثال، من بين المجموعة الكاملة من المستخدمين، قد تتألف إحدى الشرائح من المستخدِمين من بلد معيّن أو مدينة معيّنة.

تمثيل JSON 
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
الحقول
حقل الاتحاد dynamicOrById. يمكن تعريف الشريحة ديناميكيًا باستخدام شريحة ديناميكية أو باستخدام رقم تعريف لشريحة مضمّنة أو مخصّصة. يمكن أن يكون dynamicOrById واحدًا فقط مما يلي:
dynamicSegment

object(DynamicSegment)

تعريف شريحة ديناميكية في الطلب.

segmentId

string

رقم تعريف الشريحة لشريحة مدمجة أو مخصّصة، مثل gaid::-3.

شريحة ديناميكية

تعريف الشريحة الديناميكية لتعريف الشريحة في الطلب. يمكن أن تختار الشريحة مستخدمين أو جلسات أو كليهما.

تمثيل JSON 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
الحقول
name

string

اسم الشريحة الديناميكية.

userSegment

object(SegmentDefinition)

شريحة المستخدمين لاختيار المستخدمين المطلوب تضمينهم في الشريحة.

sessionSegment

object(SegmentDefinition)

شريحة الجلسة لاختيار الجلسات المراد تضمينها في الشريحة.

تعريف الشريحة

تحدّد تعريف الشريحة الشريحة من مجموعة الفلاتر، التي يتم دمجها مع عملية AND منطقية.

تمثيل JSON 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
الحقول
segmentFilters[]

object(SegmentFilter)

يتم تعريف الشريحة من خلال مجموعة من فلاتر الشرائح التي يتم دمجها مع عملية AND منطقية.

فلتر الشرائح

وتحدّد شريحة الفلتر الشريحة على أنها شريحة بسيطة أو شريحة تسلسل. يحتوي شرط الشريحة البسيطة على شروط الأبعاد والمقاييس لاختيار الجلسات أو المستخدمين. يمكن استخدام شرط شريحة التسلسل لاختيار المستخدمين أو الجلسات استنادًا إلى الشروط التسلسلية.

تمثيل JSON 
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
الحقول
not

boolean

إذا كانت القيمة صحيحة، يمكنك مطابقة مكمّل للشريحة البسيطة أو المتسلسلة. على سبيل المثال، لمطابقة جميع الزيارات التي لا تتم من "نيويورك;"، يمكننا تعريف الشريحة على النحو التالي:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

حقل الاتحاد simpleOrSequence. هل هي شريحة بسيطة أو تعريف شريحة تسلسل؟ يمكن أن يكون simpleOrSequence واحدًا فقط مما يلي:
simpleSegment

object(SimpleSegment)

تتألف شروط الشريحة البسيطة من شرط واحد أو أكثر من السمات/المقاييس التي يمكن دمجها

sequenceSegment

object(SequenceSegment)

تتألف شروط التسلسل من خطوة واحدة أو أكثر، حيث يتم تحديد كل خطوة بشرط واحد/مقياس واحد أو أكثر. يمكن دمج خطوات متعددة مع عوامل تشغيل التسلسل الخاصة.

شريحة بسيطة

تتألف شروط الشريحة البسيطة من شرط واحد أو أكثر من السمات/المقاييس التي يمكن دمجها.

تمثيل JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
الحقول
orFiltersForSegment[]

object(OrFiltersForSegment)

قائمة بمجموعات فلاتر الشرائح التي يتم دمجها مع عامل تشغيل AND المنطقي

OrFiltersForالشرائح

يتم دمج قائمة فلاتر الشرائح في المجموعة OR مع عامل التشغيل OR المنطقي.

تمثيل JSON 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
الحقول
segmentFilterClauses[]

object(SegmentFilterClause)

قائمة فلاتر الشرائح التي سيتم دمجها مع عامل تشغيل OR

نموذج فلتر الفلتر

شرط الفلتر الذي سيتم استخدامه في تعريف الشريحة، يمكن أن يكون عبارة عن مقياس أو فلتر مكوّن.

تمثيل JSON 
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
الحقول
not

boolean

تتطابق مع الملحق (!) للفلتر.

حقل الاتحاد dimensionOrMetricFilter. مكوّن أو فلتر مقياس يمكن أن يكون dimensionOrMetricFilter واحدًا فقط مما يلي:
dimensionFilter

object(SegmentDimensionFilter)

فلتر المكوّن لتعريف الشريحة.

metricFilter

object(SegmentMetricFilter)

فلتر المقاييس لتعريف الشريحة.

فلتر المكوّن

يحدد فلتر البُعد خيارات الفلترة في أي بُعد.

تمثيل JSON 
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
الحقول
dimensionName

string

اسم المكوّن الذي يتم تطبيق الفلتر عليه.

operator

enum(Operator)

عامل التشغيل المراد استخدامه لمطابقة البُعد مع التعبيرات.

caseSensitive

boolean

في حال كانت المطابقة حساسة لحالة الأحرف، سيتم تجاهلها لعامل التشغيل IN_LIST.

expressions[]

string

قائمة التعبيرات، يتم استخدام العنصر الأول فقط لكل عوامل التشغيل

minComparisonValue

string

الحد الأدنى لقيم المقارنة لنوع المطابقة BETWEEN.

maxComparisonValue

string

الحد الأقصى لقيم المقارنة لنوع المطابقة BETWEEN.

المُشغِّل

أنواع المطابقة المختلفة المتاحة.

عمليات التعداد
OPERATOR_UNSPECIFIED إذا لم يتم تحديد نوع المطابقة، يتم التعامل معه على أنه REGexp.
REGEXP يتم التعامل مع تعبير المطابقة على أنه تعبير عادي. لا يتم التعامل مع جميع أنواع المطابقة الأخرى على أنها تعبيرات عادية.
BEGINS_WITH يطابق القيم التي تبدأ بتعبير المطابقة الذي تم تقديمه.
ENDS_WITH يطابق القيم التي تنتهي بتعبير المطابقة الذي تم تقديمه.
PARTIAL مطابقة سلسلة فرعية.
EXACT يجب أن تتطابق القيمة مع تعبير المطابقة تمامًا.
IN_LIST

يُستخدَم هذا الخيار لتحديد فلتر مكوّن يمكن أن يحصل تعبيره على أي قيمة من قائمة قيم محدّدة. ويساعد ذلك على تجنُّب تقييم فلاتر متعدّدة لمكوّنات المطابقة التامة يتم استخدامها مع كل صف استجابة واحد. مثلاً:

expressions: ["A", "B", "C"]

يتطابق أي صف استجابة ويحتوي على البُعد "أ" أو "ب" أو "ج" مع هذا المكوّن.
NUMERIC_LESS_THAN

فلاتر مقارنة عدد صحيح ويتم تجاهل الحساسية لحالة الأحرف هذه ويُفترض أن يكون التعبير سلسلة تمثّل عددًا صحيحًا. شروط الفشل:

  • إذا لم يكن التعبير int64 صالحًا، يجب أن يتوقع البرنامج خطأً.
  • ولن تتطابق أبدًا أبعاد الإدخال التي ليست قيم int64 صالحة مع الفلتر.

للتحقق مما إذا كان البُعد أقل من تعبير المطابقة رقميًا.
NUMERIC_GREATER_THAN للتحقق مما إذا كان البُعد أكبر عددًا من تعبير المطابقة.
NUMERIC_BETWEEN للتحقق مما إذا كان البُعد رقميًا بين الحد الأدنى والأقصى لتعبير المطابقة، يتم استبعاد الحدود.

فلتر المقياس

فلتر المقاييس المطلوب استخدامه في عبارة فلتر الشرائح.

تمثيل JSON 
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
الحقول
scope

enum(Scope)

يحدد نطاق المقياس المستوى الذي يتم تحديد هذا المقياس فيه. يجب أن يكون نطاق المقياس المحدّد مساويًا لنطاقه الأساسي أو أكبر منه، كما هو موضّح في نموذج البيانات. يتم تحديد النطاق الأساسي حسب ما إذا كانت الشريحة تختار المستخدمين أو الجلسات.

metricName

string

المقياس الذي ستتم تصفيته يجب أن يحتوي metricFilter على اسم مقياس.

operator

enum(Operator)

تحدّد هذه السمة العملية التي يجب إجراؤها لمقارنة المقياس. والقيمة التلقائية هي EQUAL.

comparisonValue

string

القيمة التي تريد مقارنتها. إذا كان عامل التشغيل هو BETWEEN، يتم التعامل مع هذه القيمة على أنها الحد الأدنى لقيمة المقارنة.

maxComparisonValue

string

لا يُستخدَم الحد الأقصى لقيمة المقارنة إلا لعامل التشغيل BETWEEN.

النطاق

يحدّد نطاق المقياس مستوى تحديد هذا المقياس - PRODUCT أو HIT أو SESSION أو USER. ويمكن أيضًا الإبلاغ عن قيم المقياس في النطاقات الأكبر من نطاقه الأساسي. على سبيل المثال: يمكن إعداد تقارير عن ga:pageviews وga:transactions على مستوى SESSION وUSER بمجرد إضافتهما لكل نتيجة تحدث في تلك الجلسات أو لدى هؤلاء المستخدمين.

عمليات التعداد
UNSPECIFIED_SCOPE في حال لم يتم تحديد النطاق، سيتم ضبطه تلقائيًا على نطاق الشرط، USER أو SESSION استنادًا إلى ما إذا كانت الشريحة تحاول اختيار مستخدمين أو جلسات.
PRODUCT نطاق المنتج.
HIT نطاق النتيجة.
SESSION نطاق الجلسة.
USER نطاق المستخدمين.

المُشغِّل

الخيارات المختلفة لأنواع المقارنة:

عمليات التعداد
UNSPECIFIED_OPERATOR يتم التعامل مع عامل التشغيل غير المحدَّد كعامل تشغيل LESS_THAN.
LESS_THAN يتم التحقق مما إذا كانت قيمة المقياس أقل من قيمة المقارنة.
GREATER_THAN تتحقق مما إذا كانت قيمة المقياس أكبر من قيمة المقارنة.
EQUAL يساوي عامل التشغيل.
BETWEEN ويكون الحدّ الأدنى والأقصى حصريًا لكل عامل تشغيل. سنستخدم LT وGT للمقارنة.

شريحة التسلسل

تتألف شروط التسلسل من خطوة واحدة أو أكثر، حيث يتم تحديد كل خطوة بشرط واحد/مقياس واحد أو أكثر. يمكن دمج خطوات متعددة مع عوامل تشغيل التسلسل الخاصة.

تمثيل JSON 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
الحقول
segmentSequenceSteps[]

object(SegmentSequenceStep)

قائمة الخطوات في التسلسل.

firstStepShouldMatchFirstHit

boolean

وفي حال تحديده، يجب أن يتطابق شرط الخطوة الأولى مع النتيجة الأولى للزائر (في النطاق الزمني).

خطوة التسلسل

تعريف تسلسل الشريحة.

تمثيل JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
الحقول
orFiltersForSegment[]

object(OrFiltersForSegment)

يتم تحديد تسلسل باستخدام قائمة من الفلاتر"أو"المجمّعة التي يتم دمجها مع عامل تشغيل AND.

matchType

enum(MatchType)

تحدِّد هذه السياسة ما إذا كانت الخطوة تسبق الخطوة التالية أو يمكن أن تسبقها.

نوع المطابقة

نوع المطابقة للتسلسل.

عمليات التعداد
UNSPECIFIED_MATCH_TYPE يتم التعامل مع نوع المطابقة غير المحدّد على أنه سابق.
PRECEDES يشير عامل التشغيل إلى أن الخطوة السابقة تسبق الخطوة التالية.
IMMEDIATELY_PRECEDES يشير عامل التشغيل إلى أن الخطوة السابقة تسبق الخطوة التالية مباشرة.

إيقاعات محورية

يصف المحور القسم المحوري في الطلب. يساعد الارتكاز على إعادة ترتيب المعلومات في الجدول لتقارير معيّنة من خلال تغيير محور البيانات إلى بُعد ثانٍ.

تمثيل JSON 
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
الحقول
dimensions[]

object(Dimension)

قائمة الأبعاد التي يتم عرضها كأعمدة محورية. يمكن أن يتضمن المحور 4 أبعاد كحد أقصى. تُعد الأبعاد المحورية جزءًا من القيد على إجمالي عدد الأبعاد المسموح بها في الطلب.

dimensionFilterClauses[]

object(DimensionFilterClause)

يتم دمج dimensionFilterClauses بشكلٍ منطقي مع عامل تشغيل AND: لا تساهم سوى البيانات المضمّنة في جميع هذه dimensionFilterClause في القيم في هذه المنطقة المحورية. يمكن استخدام فلاتر المكوّنات لتقييد الأعمدة المعروضة في المنطقة المحورية. على سبيل المثال، إذا كان لديك ga:browser كمكوّن مطلوب في المنطقة المحورية، واخترت الفلاتر الرئيسية لحصر ga:browser لـ فقط &"IE" أو "Firefox";;; حينئذٍ، لن يظهر سوى هذين المتصفحين كأعمدة.

metrics[]

object(Metric)

المقاييس المحورية. تشكّل المقاييس المحورية جزءًا من القيد على إجمالي عدد المقاييس المسموح بها في الطلب.

startGroup

number

وفي حال طلب مقاييس k، ستحتوي الاستجابة على بعض مضاعفات k تعتمد على البيانات في التقرير. على سبيل المثال، إذا تمحورت حول البُعد "ga:browser"، ستحصل على أعمدة "k" لـ "Firefox;quot;، وk، لـ "IE"، وk، و "Chrome&quot، وما إلى ذلك. ويتم تحديد ترتيب مجموعات الأعمدة تنازليًا حسب الترتيب الأوّلي للقيم "k". ويتم تقسيم الروابط وفقًا للترتيب الأبجدي للبُعد المحوري الأول، ثم الترتيب الأبجدي للبُعد المحوري الثاني، وما إلى ذلك. على سبيل المثال، إذا كانت القيم الإجمالية لأول قيمة لكل من Firefox وIE وChrome هي 8 و2 و8 على التوالي، سيكون ترتيب الأعمدة هو Chrome وFirefox وIE.

يتيح لك ما يلي اختيار مجموعات الأعمدة k التي يتم تضمينها في الاستجابة.
maxGroupCount

number

يحدّد هذا الإعداد الحد الأقصى لعدد المجموعات التي يمكن عرضها. القيمة التلقائية هي 10، والحد الأقصى للقيمة هي 1,000.

المجموعة النموذجية

لتعريف مجموعة نموذجية. مثلاً:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
تمثيل JSON 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
الحقول
cohorts[]

object(Cohort)

تعريف المجموعة النموذجية.

lifetimeValue

boolean

تفعيل القيمة الدائمة. تقيس القيمة الدائمة القيمة الدائمة للمستخدمين المكتسبين من خلال قنوات مختلفة. يُرجى الاطّلاع على: التحليل الجماعي والقيمة الدائمة إذا كانت قيمة القيمة الدائمة غير صحيحة:

  • وتتشابه قيم المقياس مع القيم الواردة في تقرير المجموعة النموذجية لواجهة الويب.
  • يجب أن تتم محاذاة النطاقات الزمنية لتعريف المجموعة النموذجية مع أسبوع التقويم والشهر. على سبيل المثال، في حال طلب ga:cohortNthWeek في تعريف المجموعة النموذجية، يجب أن يكون الأحد والأحد هو endDate في يوم السبت التالي. وبالنسبة إلى ga:cohortNthMonth، يجب أن يكون startDate في أول يوم من الشهر وendDate هو آخر يوم من الشهر.

عندما تكون القيمة الدائمة صحيحة:

  • ستتوافق قيم المقياس مع القيم في تقرير قيمة LifeTime لواجهة الويب.
  • يوضّح لك تقرير "القيمة الدائمة" مدى نمو قيمة المستخدم (الأرباح) والتفاعل (مرات مشاهدة التطبيق، والأهداف المكتملة، والجلسات، ومدة الجلسة) خلال فترة 90 يومًا بعد اكتساب مستخدم.
  • ويتم حساب المقاييس على أنها متوسط تراكمي لكل مستخدم حسب الزيادة الزمنية.
  • يجب ألا تتم مواءمة النطاقات الزمنية لتعريف المجموعة النموذجية مع حدود الأسبوع والشهر في التقويم.
  • يجب أن يكون viewId رقم تعريف ملف شخصي للتطبيق

المجموعة النموذجية

لتعريف مجموعة نموذجية. تمثّل المجموعة النموذجية مجموعة من المستخدمين الذين تجمعهم سمة مميّزة مشتركة. على سبيل المثال، ينتمي جميع المستخدمين بتاريخ الاكتساب نفسه إلى المجموعة النموذجية نفسها.

تمثيل JSON 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
الحقول
name

string

اسم فريد للمجموعة النموذجية. وفي حال عدم تحديد اسم، سيتم إنشاؤه تلقائيًا باستخدام القيم group_[1234...].

type

enum(Type)

نوع المجموعة النموذجية. والنوع الوحيد المتاح حتى الآن هو FIRST_VISIT_DATE. وإذا لم يتم تحديد هذا الحقل، يتم التعامل مع المجموعة النموذجية على أنها مجموعة نموذجية من النوع FIRST_VISIT_DATE.

dateRange

object(DateRange)

وتُستخدَم هذه المجموعة النموذجية لمجموعة FIRST_VISIT_DATE، تختار المجموعة النموذجية المستخدمين الذين يقع تاريخ زيارتهم الأولى بين تاريخ البدء وتاريخ الانتهاء المحدّدَين في حقل التاريخ. يجب محاذاة النطاقات الزمنية لطلبات المجموعة النموذجية. إذا كان الطلب يحتوي على ga:cohortNthDay، يجب أن يكون طوله يومًا واحدًا بالضبط، إذا كان يجب أن يتوافق ga:cohortNthWeek مع حد الأسبوع (بدءًا من يوم الأحد وينتهي يوم السبت)، وبالنسبة إلى ga:cohortNthMonth يجب أن يكون النطاق الزمني متوافقًا مع الشهر (بدءًا من أول يوم وينتهي في آخر يوم من الشهر). بالنسبة إلى طلبات القيمة الدائمة، لا يتم فرض هذه القيود. لا تحتاج إلى توفير نطاق زمني للحقل reportsRequest.dateRanges.

النوع

نوع المجموعة النموذجية.

عمليات التعداد
UNSPECIFIED_COHORT_TYPE إذا لم يتم تحديدها، يتم التعامل معها على أنها FIRST_VISIT_DATE.
FIRST_VISIT_DATE المجموعات النموذجية التي يتم اختيارها استنادًا إلى تاريخ الزيارة الأولى

إبلاغ

استجابة البيانات المقابلة للطلب.

تمثيل JSON 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
الحقول
columnHeader

object(ColumnHeader)

رؤوس الأعمدة.

data

object(ReportData)

بيانات الاستجابة

nextPageToken

string

الرمز المميز للصفحة لاسترداد الصفحة التالية من النتائج في القائمة.

رأس العمود

رؤوس الأعمدة.

تمثيل JSON 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
الحقول
dimensions[]

string

أسماء الأبعاد في الاستجابة

metricHeader

object(MetricHeader)

عناوين المقاييس للمقاييس في الاستجابة.

عنوان المقياس

عناوين المقاييس.

تمثيل JSON 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
الحقول
metricHeaderEntries[]

object(MetricHeaderEntry)

عناوين للمقاييس في الاستجابة.

pivotHeaders[]

object(PivotHeader)

عناوين للمواضيع المحورية في الاستجابة.

إدخال عنوان المقياس

عنوان للمقاييس

تمثيل JSON 
{
  "name": string,
  "type": enum(MetricType)
}
الحقول
name

string

اسم العنوان.

type

enum(MetricType)

نوع المقياس، مثل INTEGER.

العنوان المحوري

عناوين كل قسم من الأقسام المحورية المحددة في الطلب.

تمثيل JSON 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
الحقول
pivotHeaderEntries[]

object(PivotHeaderEntry)

عنوان قسم محوري واحد.

totalPivotGroupsCount

number

إجمالي عدد المجموعات لهذا المحور.

إدخال رأسي

عناوين لكل عمود من أعمدة المقاييس المقابلة للمقاييس المطلوبة في القسم المحوري من الاستجابة.

تمثيل JSON 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
الحقول
dimensionNames[]

string

اسم الأبعاد في الاستجابة المحورية.

dimensionValues[]

string

قيم الأبعاد في المحور.

metric

object(MetricHeaderEntry)

عنوان المقياس للمقياس في المحور.

بيانات إعداد التقارير

جزء البيانات من التقرير.

تمثيل JSON 
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
الحقول
rows[]

object(ReportRow)

هناك تقرير واحد في التقرير لكل مجموعة فريدة من الأبعاد.

totals[]

object(DateRangeValues)

بالنسبة إلى كل نطاق زمني مطلوب، بالنسبة إلى مجموعة جميع الصفوف التي تطابق طلب البحث، يحصل كل تنسيق قيمة مطلوب على المجموع الإجمالي. يتم احتساب إجمالي تنسيق القيمة من خلال جمع المقاييس المُشار إليها في تنسيق القيمة أولاً، ثم تقييم تنسيق القيمة كتعبير رقمي. على سبيل المثال: The "totals" 3 / (ga:sessions + 2)، نحسب 3 / ((sum of all relevant ga:sessions) + 2). يتم احتساب الإجماليات قبل التقسيم على صفحات.

rowCount

number

إجمالي عدد الصفوف المطابقة لطلب البحث هذا.

minimums[]

object(DateRangeValues)

الحد الأدنى والحد الأقصى للقيم التي يمكن رؤيتها في جميع الصفوف المطابقة. يكون هذان الحقلان فارغين عندما يكون hideValueRanges في الطلب خطأً، أو عندما يكون صفوف CountCount صفرًا.

maximums[]

object(DateRangeValues)

الحد الأدنى والحد الأقصى للقيم التي يمكن رؤيتها في جميع الصفوف المطابقة. يكون هذان الحقلان فارغين عندما يكون hideValueRanges في الطلب خطأً، أو عندما يكون صفوف CountCount صفرًا.

samplesReadCounts[]

string (int64 format)

إذا كانت النتائج مأخوذة كعيّنة، تعرض هذا العدد الإجمالي للعينات التي تمت قراءتها، مع إدخال إدخال واحد لكل نطاق زمني. إذا لم تكن النتائج مستندة إلى عينات، لن يتم تحديد هذا الحقل. اطّلِع على دليل المطوِّر لمعرفة التفاصيل.

samplingSpaceSizes[]

string (int64 format)

إذا كانت النتائج تستند إلى عينات، يؤدي ذلك إلى عرض إجمالي عدد العيّنات المتوفّرة، وإدخال واحد لكل نطاق زمني. إذا لم تكن النتائج مستندة إلى عينات، لن يتم تحديد هذا الحقل. اطّلِع على دليل المطوِّر لمعرفة التفاصيل.

isDataGolden

boolean

يشير إلى ما إذا كان الرد على هذا الطلب ذهبيًا أم لا. وتكون البيانات باللون الذهبي عندما لا يؤدي الطلب نفسه تمامًا إلى أي نتائج جديدة إذا تم سؤاله في وقت لاحق.

dataLastRefreshed

string (Timestamp format)

تاريخ آخر تعديل للبيانات في التقرير. ويتم تضمين جميع النتائج التي تم تلقيها قبل هذا الطابع الزمني في حساب التقرير.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

صف التقارير

صف في التقرير.

تمثيل JSON 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
الحقول
dimensions[]

string

قائمة الأبعاد المطلوبة.

metrics[]

object(DateRangeValues)

قائمة المقاييس لكل نطاق زمني مطلوب.

قيم سلسلة الترتيب

يُستخدم لعرض قائمة المقاييس لتركيبة DateRange / بُعد واحدة.

تمثيل JSON 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
الحقول
values[]

string

تتوافق كل قيمة مع كل مقياس في الطلب.

pivotValueRegions[]

object(PivotValueRegion)

قيم كل منطقة محورية.

منطقة محورية

قيم المقياس في المنطقة المحورية.

تمثيل JSON 
{
  "values": [
    string
  ]
}
الحقول
values[]

string

قيم المقاييس في كل منطقة من المناطق المحورية.

حصص الموارد المتبقية

الرموز المميزة لحصة الموارد المتبقية للموقع بعد اكتمال الطلب.

تمثيل JSON 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
الحقول
dailyQuotaTokensRemaining

number

يتبقى الحصة اليومية من الموارد.

hourlyQuotaTokensRemaining

number

الرموز المميزة لحصة الموارد كل ساعة متبقية.

جرِّب هذه الميزة الآن.