جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
REST Resource: properties.calculatedMetrics
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: CalculatedMetric
| تمثيل JSON |
{
"name": string,
"description": string,
"displayName": string,
"calculatedMetricId": string,
"metricUnit": enum (MetricUnit),
"restrictedMetricType": [
enum (RestrictedMetricType)
],
"formula": string,
"invalidMetricReference": boolean
} |
| الحقول |
name |
string
النتائج فقط. اسم المورد لمقياس CalculatedMetric هذا. التنسيق: 'Properties/{property_id}/calculatedMetrics/{calculatedMetricId}'
|
description |
string
اختياريّ. وصف لهذا المقياس المحسوب. الحد الأقصى للطول هو 4096 حرفًا.
|
displayName |
string
مطلوب. الاسم المعروض لهذا المقياس المحسوب كما هو موضّح في واجهة مستخدم "إحصاءات Google". الحد الأقصى للطول 82 حرفًا.
|
calculatedMetricId |
string
النتائج فقط. رقم التعريف المطلوب استخدامه للمقياس المحسوب. يُشار إلى ذلك في واجهة المستخدم باسم "اسم واجهة برمجة التطبيقات". يتم استخدام ComputeMetricId عند الإشارة إلى هذا المقياس المحسوب من واجهات برمجة التطبيقات الخارجية. على سبيل المثال، "calcMetric:{calculatedMetricId}".
|
metricUnit |
enum (MetricUnit)
مطلوب. نوع قيمة المقياس المحسوب.
|
restrictedMetricType[] |
enum (RestrictedMetricType)
النتائج فقط. أنواع البيانات المحظورة التي يحتوي عليها هذا المقياس.
|
formula |
string
مطلوب. تعريف المقياس المحسوب الحد الأقصى لعدد المقاييس المخصّصة المرجعية الفريدة هو 5. تتيح المعادلات العمليات التالية: + (الجمع)، - (الطرح)، - (سالب)، * (الضرب)، / (القسمة)، () (الأقواس). يتم قبول أي أرقام حقيقية صالحة تتناسب مع رقم طويل طويل (عدد صحيح 64 بت) أو رقم نقطة عائمة مزدوجة 64 بت. مثال على الصيغة: "( customEvent:parameterName + CartPurchaseQuantity ) / 2.0"
|
invalidMetricReference |
boolean
النتائج فقط. إذا كانت القيمة هي صحيحة، هذا يعني أنّ هذا المقياس المحسوب يتضمّن مرجع مقياس غير صالح. إنّ أيّ عنصر يستخدم مقياسًا محسوبًا تم فيه ضبط validMetricReference على "صحيح" قد يتعذّر تنفيذه أو يعرض تحذيرات أو يؤدي إلى نتائج غير متوقعة.
|
MetricUnit
الأنواع المحتملة لتمثيل قيمة المقياس المحسوب.
| عمليات التعداد |
METRIC_UNIT_UNSPECIFIED |
الوحدة المترية غير محدّدة أو غير متوفّرة. |
STANDARD |
يستخدِم هذا المقياس الوحدات التلقائية. |
CURRENCY |
يقيس هذا المقياس العملة. |
FEET |
يقيس هذا المقياس قدم. |
MILES |
يقيس هذا المقياس الأميال. |
METERS |
يقيس هذا المقياس مترًا. |
KILOMETERS |
يقيس هذا المقياس الكيلومترات. |
MILLISECONDS |
ويقيس هذا المقياس المللي ثانية. |
SECONDS |
يقيس هذا المقياس الثواني. |
MINUTES |
يقيس هذا المقياس الدقائق. |
HOURS |
يقيس هذا المقياس الساعات. |
RestrictedMetricType
التصنيفات التي تضع علامة على البيانات في المقياس المحسوب الذي يتم استخدامه جنبًا إلى جنب مع أدوار المستخدمين التي تحظر الوصول إلى مقاييس التكلفة و/أو الأرباح.
| عمليات التعداد |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
النوع غير معروف أو غير محدّد. |
COST_DATA |
بيانات تكلفة تقارير المقاييس. |
REVENUE_DATA |
وتعرض المقاييس بيانات الأرباح. |
الطُرق |
|
|
تنشئ CalculatedMetric. |
|
|
لحذف سمة CalculatedMetric في أحد المواقع. |
|
|
ابحث عن مقياس CalculatedMetric واحد. |
|
|
يسرد CalculatedMetrics على أحد المواقع. |
|
|
لتعديل سمة CalculatedMetric على أحد المواقع. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eCalculatedMetric\u003c/code\u003e allows you to create custom metrics using formulas based on existing metrics and parameters, with options for units like currency, time, or distance.\u003c/p\u003e\n"],["\u003cp\u003eYou can define the display name, description, and formula for your custom metric, along with specifying its unit of measurement.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Analytics provides a dedicated resource and API for managing calculated metrics, allowing you to create, update, delete, and list them within your properties.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCalculatedMetric\u003c/code\u003e resources have fields indicating if they contain cost or revenue data or have invalid metric references.\u003c/p\u003e\n"]]],["Calculated metrics are defined with a name, description, display name, and a unique ID. They also specify a `metricUnit` (e.g., standard, currency, feet) and can contain `restrictedMetricTypes` (cost or revenue data). The `formula` field defines the metric's calculation, supporting basic arithmetic. Methods include creating, deleting, retrieving, listing, and updating calculated metrics. Metrics can reference up to five custom metrics. `invalidMetricReference` flag indicates issues.\n"],null,["# REST Resource: properties.calculatedMetrics\n\n- [Resource: CalculatedMetric](#CalculatedMetric)\n - [JSON representation](#CalculatedMetric.SCHEMA_REPRESENTATION)\n- [MetricUnit](#MetricUnit)\n- [RestrictedMetricType](#RestrictedMetricType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CalculatedMetric\n--------------------------\n\nA definition for a calculated metric.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"description\": string, \"displayName\": string, \"calculatedMetricId\": string, \"metricUnit\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#MetricUnit), \"restrictedMetricType\": [ enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#RestrictedMetricType) ], \"formula\": string, \"invalidMetricReference\": boolean } ``` |\n\n| Fields ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name for this CalculatedMetric. Format: 'properties/{property_id}/calculatedMetrics/{calculatedMetricId}' |\n| `description` | `string` Optional. Description for this calculated metric. Max length of 4096 characters. |\n| `displayName` | `string` Required. Display name for this calculated metric as shown in the Google Analytics UI. Max length 82 characters. |\n| `calculatedMetricId` | `string` Output only. The ID to use for the calculated metric. In the UI, this is referred to as the \"API name.\" The calculatedMetricId is used when referencing this calculated metric from external APIs. For example, \"calcMetric:{calculatedMetricId}\". |\n| `metricUnit` | `enum (`[MetricUnit](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#MetricUnit)`)` Required. The type for the calculated metric's value. |\n| `restrictedMetricType[]` | `enum (`[RestrictedMetricType](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#RestrictedMetricType)`)` Output only. Types of restricted data that this metric contains. |\n| `formula` | `string` Required. The calculated metric's definition. Maximum number of unique referenced custom metrics is 5. Formulas supports the following operations: + (addition), - (subtraction), - (negative), \\* (multiplication), / (division), () (parenthesis). Any valid real numbers are acceptable that fit in a Long (64bit integer) or a Double (64 bit floating point number). Example formula: \"( customEvent:parameterName + cartPurchaseQuantity ) / 2.0\" |\n| `invalidMetricReference` | `boolean` Output only. If true, this calculated metric has a invalid metric reference. Anything using a calculated metric with invalidMetricReference set to true may fail, produce warnings, or produce unexpected results. |\n\nMetricUnit\n----------\n\nPossible types of representing the calculated metric's value.\n\n| Enums ||\n|---------------------------|------------------------------------|\n| `METRIC_UNIT_UNSPECIFIED` | MetricUnit unspecified or missing. |\n| `STANDARD` | This metric uses default units. |\n| `CURRENCY` | This metric measures a currency. |\n| `FEET` | This metric measures feet. |\n| `MILES` | This metric measures miles. |\n| `METERS` | This metric measures meters. |\n| `KILOMETERS` | This metric measures kilometers. |\n| `MILLISECONDS` | This metric measures milliseconds. |\n| `SECONDS` | This metric measures seconds. |\n| `MINUTES` | This metric measures minutes. |\n| `HOURS` | This metric measures hours. |\n\nRestrictedMetricType\n--------------------\n\nLabels that mark the data in calculated metric used in conjunction with user roles that restrict access to cost and/or revenue metrics.\n\n| Enums ||\n|--------------------------------------|------------------------------|\n| `RESTRICTED_METRIC_TYPE_UNSPECIFIED` | Type unknown or unspecified. |\n| `COST_DATA` | Metric reports cost data. |\n| `REVENUE_DATA` | Metric reports revenue data. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------------------------------|-------------------------------------------|\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics/create) | Creates a CalculatedMetric. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics/delete) | Deletes a CalculatedMetric on a property. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics/get) | Lookup for a single CalculatedMetric. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics/list) | Lists CalculatedMetrics on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics/patch) | Updates a CalculatedMetric on a property. |"]]
