Method: reports.batchGet

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

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

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

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

object(ReportRequest)

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

useResourceQuotas

boolean

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

نص الاستجابة

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

فئة الاستجابة الرئيسية التي تحتفظ بالتقارير من طلب batchGet من Reporting API.

تمثيل 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

ReportRequest

فئة الطلب الرئيسية التي تحدِّد طلب Reporting API.

تمثيل 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 أيام، endDate: التاريخ الحالي - يوم واحد). يجب أن تحتوي كل سمة 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. يجب أن تكون السمة pageToken هي القيمة التي يتم عرضها في المَعلمة nextPageToken عند الردّ على طلب report.batchGet.

pageSize

number

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

includeEmptyRows

boolean

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

hideTotals

boolean

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

hideValueRanges

boolean

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

أخذ العينات

قيم مستوى تحليل العيّنات

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

السمة

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

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

string

اسم السمة المطلوب استرجاعها، على سبيل المثال ga:browser.

histogramBuckets[]

string (int64 format)

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

  • الحزمة رقم 1: القيم < 0، قيمة السمة "<0"
  • الحزمة رقم 2: القيم في [0,1)، قيمة السمة "0"
  • الحزمة رقم 3: القيم في [1،3)، قيمة السمة "1-2"
  • الحزمة رقم 4: القيم في [3،4)، قيمة السمة "3"
  • الحزمة رقم 5: القيم في [4،7)، قيمة السمة "4-6"
  • الحزمة رقم 6: القيم >= 7، قيمة السمة "7+"

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

"<50", "1001+", "121-1000", "50-120"

في ما يلي ترتيب HISTOGRAM_BUCKET التصاعدي:

"<50", "50-120", "121-1000", "1001+"

على العميل أن يطلب بشكلٍ صريح "orderType": "HISTOGRAM_BUCKET" لبُعد تم تغيير مدرّج تكراري.

DimensionFilterClause

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

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

enum(FilterLogicalOperator)

عامل التشغيل لدمج فلاتر سمات متعددة. وفي حال عدم تحديده، يتم التعامل معه على أنّه OR.

filters[]

object(DimensionFilter)

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

FilterLogicalOperator

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

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

DimensionFilter

يحدِّد فلتر السمات خيارات الفلترة في سمة معيّنة.

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

string

السمة المطلوب الفلترة وفقًا لها. يجب أن تحتوي سمة AttributeFilter على سمة.

not

boolean

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

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"]

أي صف استجابة يحتوي على أبعاده بقيمة A أو B أو C، يتطابق مع AttributeFilter هذا.

المقياس

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

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

string

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

alias

string

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

formattingType

enum(MetricType)

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

MetricType

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

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

MetricFilterClause

تعرِض هذه السمة مجموعة من فلاتر المقاييس. قم بتعيين قيمة عامل التشغيل لتحديد كيفية دمج الفلاتر بشكل منطقي.

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

enum(FilterLogicalOperator)

عامل التشغيل للجمع بين فلاتر مقاييس متعددة. وفي حال عدم تحديده، يتم التعامل معه على أنّه OR.

filters[]

object(MetricFilter)

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

MetricFilter

يحدد MetricFilter الفلتر الذي يتعلق بمقياس معين.

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

string

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

not

boolean

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

operator

enum(Operator)

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

comparisonValue

string

القيمة المطلوب المقارنة بها.

مُشغِّل

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

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

OrderBy

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

تمثيل 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.

DynamicSegment

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

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

string

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

userSegment

object(SegmentDefinition)

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

sessionSegment

object(SegmentDefinition)

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

SegmentDefinition

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

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

object(SegmentFilter)

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

SegmentFilter

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

تمثيل 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)

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

SimpleSegment

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

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

object(OrFiltersForSegment)

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

OrFiltersForSegment

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

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

object(SegmentFilterClause)

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

SegmentFilterClause

يمكن استخدام عبارة الفلتر - التي تُستخدَم في تعريف الشريحة - مع مقياس أو فلتر مكوّن.

تمثيل 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)

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

SegmentDimensionFilter

يحدِّد فلتر السمات خيارات الفلترة في سمة معيّنة.

تمثيل 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"]

أي صف استجابة يحتوي على أبعاده بقيمة A أو B أو C، يتطابق مع AttributeFilter هذا.
NUMERIC_LESS_THAN

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

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

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

SegmentMetricFilter

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

تمثيل 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 للمقارنة.

SequenceSegment

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

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

object(SegmentSequenceStep)

تمثّل هذه السمة قائمة الخطوات في التسلسل.

firstStepShouldMatchFirstHit

boolean

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

SegmentSequenceStep

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

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

object(OrFiltersForSegment)

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

matchType

enum(MatchType)

لتحديد ما إذا كانت الخطوة يسبق الخطوة التالية أو يمكن أن تكون قبل الخطوة التالية مباشرةً.

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)

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

metrics[]

object(Metric)

المقاييس المحورية. المقاييس المحورية هي جزء من القيود المفروضة على إجمالي عدد المقاييس المسموح بها في الطلب.

startGroup

number

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

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

number

تحدد هذه السمة الحد الأقصى لعدد المجموعات المطلوب عرضها. القيمة التلقائية هي 10، والحد الأقصى للقيمة هو 1000.

CohortGroup

تحدّد هذه السمة مجموعة نموذجية. مثال:

"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

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

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

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

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

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

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

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

string

اسم فريد للمجموعة النموذجية وفي حال عدم تحديد اسم معيّن، سيتم إنشاؤه تلقائيًا باستخدام القيم مجموعة تجريبية_[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

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

ColumnHeader

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

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

string

أسماء السمات في الردّ

metricHeader

object(MetricHeader)

عناوين المقاييس للمقاييس في الردّ

MetricHeader

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

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

object(MetricHeaderEntry)

عناوين المقاييس في الردّ

pivotHeaders[]

object(PivotHeader)

عناوين للنقاط المحورية في الرد

MetricHeaderEntry

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

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

string

تمثّل هذه السمة اسم العنوان.

type

enum(MetricType)

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

PivotHeader

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

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

object(PivotHeaderEntry)

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

totalPivotGroupsCount

number

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

PivotHeaderEntry

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

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

string

اسم السمات في الردّ المحوري.

dimensionValues[]

string

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

metric

object(MetricHeaderEntry)

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

ReportData

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

تمثيل 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)

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

rowCount

number

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

minimums[]

object(DateRangeValues)

القيم الدنيا والقصوى المعروضة في جميع الصفوف المطابقة. وتكون هذه القيم فارغة عندما يكون hideValueRanges في الطلب false أو عندما تكون rowCount صفرًا.

maximums[]

object(DateRangeValues)

القيم الدنيا والقصوى المعروضة في جميع الصفوف المطابقة. وتكون هذه القيم فارغة عندما يكون hideValueRanges في الطلب false أو عندما تكون rowCount صفرًا.

samplesReadCounts[]

string (int64 format)

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

samplingSpaceSizes[]

string (int64 format)

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

isDataGolden

boolean

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

dataLastRefreshed

string (Timestamp format)

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

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

ReportRow

صف في التقرير

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

string

قائمة السمات المطلوبة.

metrics[]

object(DateRangeValues)

قائمة بالمقاييس لكل نطاق تاريخ مطلوب

DateRangeValues

يتم استخدامه لعرض قائمة مقاييس لمجموعة نطاق تاريخ / سمات واحدة

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

string

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

pivotValueRegions[]

object(PivotValueRegion)

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

PivotValueRegion

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

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

string

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

ResourceQuotasRemaining

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

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

number

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

hourlyQuotaTokensRemaining

number

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

تجربة