REST Resource: properties.customMetrics

المرجع: CustomMetric

تعريف لمقياس مخصّص

تمثيل JSON
{
  "name": string,
  "parameterName": string,
  "displayName": string,
  "description": string,
  "measurementUnit": enum (MeasurementUnit),
  "scope": enum (MetricScope),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ]
}
الحقول
name

string

النتائج فقط. اسم المورد لمورد CustomMetric هذا. التنسيق: properties/{property}/customMetrics/{customMetric}

parameterName

string

مطلوب. غير قابل للتغيير اسم وضع العلامات لهذا المقياس المخصّص.

إذا كان هذا مقياسًا على مستوى الحدث، هذا هو اسم مَعلمة الحدث.

يمكن أن تحتوي فقط على أحرف أبجدية رقمية وشرطات سفلية، بدءًا بحرف. الحدّ الأقصى لعدد الأحرف هو 40 حرفًا للمقاييس على مستوى الحدث.

displayName

string

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

description

string

اختيارية: وصف لهذه السمة المخصّصة. الحد الأقصى للطول هو 150 حرفًا.

measurementUnit

enum (MeasurementUnit)

مطلوب. نوع قيمة المقياس المخصّص.

scope

enum (MetricScope)

مطلوب. غير قابل للتغيير نطاق هذا المقياس المخصّص.

restrictedMetricType[]

enum (RestrictedMetricType)

اختيارية: أنواع البيانات المحظورة التي قد يحتوي عليها هذا المقياس مطلوب للمقاييس التي تستخدم وحدة القياس "عملة". يجب أن يكون فارغًا للمقاييس التي تستخدم وحدة قياس غير "العملة".

MeasurementUnit

الأنواع المحتمَلة لتمثيل قيمة المقياس المخصّص

قد يتغيّر تمثيل العملة في المستقبل، ما يتطلّب إجراء تغيير جذري في واجهة برمجة التطبيقات.

عمليات التعداد
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit غير محدّد أو غير متوفّر.
STANDARD يستخدم هذا المقياس الوحدات التلقائية.
CURRENCY يقيس هذا المقياس عملة.
FEET يقيس هذا المقياس الأقدام.
METERS يقيس هذا المقياس الأمتار.
KILOMETERS يقيس هذا المقياس الكيلومترات.
MILES يقيس هذا المقياس الأميال.
MILLISECONDS يقيس هذا المقياس المللي ثانية.
SECONDS يقيس هذا المقياس الثواني.
MINUTES يقيس هذا المقياس الدقائق.
HOURS يقيس هذا المقياس الساعات.

MetricScope

نطاق هذا المقياس.

عمليات التعداد
METRIC_SCOPE_UNSPECIFIED النطاق غير معروف أو لم يتم تحديده.
EVENT مقياس على مستوى حدث

RestrictedMetricType

التصنيفات التي تُصنِّف البيانات في هذا المقياس المخصّص على أنّها بيانات يجب أن تقتصر على مستخدمين محدّدين

عمليات التعداد
RESTRICTED_METRIC_TYPE_UNSPECIFIED النوع غير معروف أو غير محدّد.
COST_DATA يُستخدَم المقياس لتسجيل بيانات التكلفة.
REVENUE_DATA يُستخدَم المقياس لتسجيل بيانات الأرباح.

الطُرق

archive

أرشفة "مقياس مخصّص" على موقع

create

تنشئ CustomMetric.

get

ابحث عن مقياس مخصّص واحد.

list

يُدرج CustomMetrics في موقع.

patch

تعديل "مقياس مخصّص" على موقع