Essayez le serveur MCP pour Google Analytics. Installez-le depuis
GitHub et consultez l'
annonce pour en savoir plus.
REST Resource: properties.calculatedMetrics
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: CalculatedMetric
Définition d'une métrique calculée.
Représentation JSON |
{
"name": string,
"description": string,
"displayName": string,
"calculatedMetricId": string,
"metricUnit": enum (MetricUnit ),
"restrictedMetricType": [
enum (RestrictedMetricType )
],
"formula": string,
"invalidMetricReference": boolean
} |
Champs |
name |
string
Uniquement en sortie. Nom de ressource pour cette métrique CalculatedMetric. Format : "properties/{property_id}/ComputeMetrics/{calculMetricId}"
|
description |
string
Facultatif. Description de cette métrique calculée. Longueur maximale de 4 096 caractères.
|
displayName |
string
Obligatoire. Nom à afficher pour cette métrique calculée, comme indiqué dans l'interface utilisateur de Google Analytics Longueur maximale : 82 caractères.
|
calculatedMetricId |
string
Uniquement en sortie. ID à utiliser pour la métrique calculée. Dans l'interface utilisateur, il s'agit du "nom de l'API". Le paramètre "computeMetricId" est utilisé pour faire référence à cette métrique calculée à partir d'API externes. Par exemple, "calcMetric:{CalculMetricId}".
|
metricUnit |
enum (MetricUnit )
Obligatoire. Type de la valeur de la métrique calculée.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Uniquement en sortie. Types de données restreintes contenues dans cette métrique.
|
formula |
string
Obligatoire. Définition de la métrique calculée. Le nombre maximal de métriques personnalisées uniques référencées est de cinq. Les formules prennent en charge les opérations suivantes: + (addition), - (soustraction), - (négatif), * (multiplication), / (division), () (parenthèse). Tous les nombres réels valides sont acceptés dans un format long (entier 64 bits) ou double (nombre à virgule flottante de 64 bits). Exemple de formule : "( customEvent:parameterName + cartPurchaseQuantity ) / 2.0"
|
invalidMetricReference |
boolean
Uniquement en sortie. Si la valeur est "true", la référence à la métrique calculée n'est pas valide. Toute opération qui utilise une métrique calculée dont la valeur "invalidMetricReference" est définie sur "true" peut échouer, générer des avertissements ou produire des résultats inattendus.
|
MetricUnit
Types possibles de représentation de la valeur de la métrique calculée.
Enums |
METRIC_UNIT_UNSPECIFIED |
MetricUnit non spécifiée ou manquante. |
STANDARD |
Cette métrique utilise les unités par défaut. |
CURRENCY |
Cette métrique mesure une devise. |
FEET |
Cette métrique est exprimée en pieds. |
MILES |
Cette métrique mesure les miles. |
METERS |
Cette métrique mesure des mètres. |
KILOMETERS |
Cette métrique mesure les kilomètres. |
MILLISECONDS |
Cette métrique mesure la milliseconde. |
SECONDS |
Cette métrique mesure les secondes. |
MINUTES |
Cette métrique mesure les minutes. |
HOURS |
Cette métrique mesure les heures. |
RestrictedMetricType
Libellés qui marquent les données de la métrique calculée en association avec des rôles utilisateur limitant l'accès aux métriques sur les coûts et/ou les revenus.
Enums |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Type inconnu ou non spécifié. |
COST_DATA |
Les métriques enregistrent les données de coût. |
REVENUE_DATA |
La métrique fournit des données sur les revenus. |
Méthodes |
|
Crée une métrique CalculatedMetric. |
|
Supprime une métrique CalculatedMetric d'une propriété. |
|
Recherche d'une seule métrique CalculatedMetric. |
|
Répertorie les CalculatedMetrics sur une propriété. |
|
Met à jour une métrique CalculatedMetric sur une propriété. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (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. |"]]