Попробуйте сервер MCP для Google Analytics. Установите его с
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. Формат: 'свойства/{property_id}/calculatedMetrics/{calculatedMetricId}' |
description | string Необязательный. Описание вычисляемого показателя. Максимальная длина 4096 символов. |
displayName | string Необходимый. Отображаемое имя для этого вычисляемого показателя, как показано в пользовательском интерфейсе Google Analytics. Максимальная длина 82 символа. |
calculatedMetricId | string Только вывод. Идентификатор, который будет использоваться для вычисляемой метрики. В пользовательском интерфейсе это называется «именем API». CalculatedMetricId используется при ссылке на эту вычисляемую метрику из внешних API. Например, «calcMetric:{calculatedMetricId}». |
metricUnit | enum ( MetricUnit ) Необходимый. Тип значения вычисляемого показателя. |
restrictedMetricType[] | enum ( RestrictedMetricType ) Только вывод. Типы ограниченных данных, которые содержит эта метрика. |
formula | string Необходимый. Определение вычисляемой метрики. Максимальное количество уникальных пользовательских метрик, на которые ссылаются, — 5. Формулы поддерживают следующие операции: + (сложение), — (вычитание), — (отрицательное число), * (умножение), / (деление), () (круглые скобки). Допускаются любые действительные действительные числа, которые соответствуют длинному (64-битному целому числу) или двойному числу (64-битному числу с плавающей запятой). Пример формулы: "( customEvent:parameterName + carsPurchaseQuantity ) / 2.0" |
invalidMetricReference | boolean Только вывод. Если это правда, эта вычисляемая метрика имеет недопустимую ссылку на метрику. Все, что использует вычисляемую метрику со значением validMetricReference, установленным в true, может привести к сбою, появлению предупреждений или неожиданных результатов. |
Метрическая единица
Возможные типы представления значения вычисляемой метрики.
Перечисления |
---|
METRIC_UNIT_UNSPECIFIED | MetricUnit не указан или отсутствует. |
STANDARD | В этой метрике используются единицы по умолчанию. |
CURRENCY | Этот показатель измеряет валюту. |
FEET | Эта метрика измеряет футы. |
MILES | Эта метрика измеряет мили. |
METERS | Эта метрика измеряется в метрах. |
KILOMETERS | Эта метрика измеряет километры. |
MILLISECONDS | Эта метрика измеряет миллисекунды. |
SECONDS | Этот показатель измеряет секунды. |
MINUTES | Этот показатель измеряет минуты. |
HOURS | Этот показатель измеряет часы. |
Ограниченныйметриктипе
Метки, которые отмечают данные в вычисляемой метрике, используются вместе с ролями пользователей, которые ограничивают доступ к метрикам затрат и/или доходов.
Перечисления |
---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED | Тип неизвестен или не указан. |
COST_DATA | Метрика сообщает данные о затратах. |
REVENUE_DATA | Метрика сообщает данные о доходах. |
Методы |
---|
| Создает CalculatedMetric. |
| Удаляет CalculatedMetric для свойства. |
| Поиск одного CalculatedMetric. |
| Перечисляет CalculatedMetrics для свойства. |
| Обновляет CalculatedMetric для свойства. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\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. |"]]