Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
REST Resource: properties.calculatedMetrics
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: CalcolatoMetrica
Definizione di una metrica calcolata.
Rappresentazione JSON |
{
"name": string,
"description": string,
"displayName": string,
"calculatedMetricId": string,
"metricUnit": enum (MetricUnit ),
"restrictedMetricType": [
enum (RestrictedMetricType )
],
"formula": string,
"invalidMetricReference": boolean
} |
Campi |
name |
string
Solo output. Nome della risorsa per questa metrica calcolata. Formato: "properties/{property_id}/calculatedMetrics/{calculatedMetricId}"
|
description |
string
(Facoltativo) Descrizione di questa metrica calcolata. La lunghezza massima di 4096 caratteri.
|
displayName |
string
Obbligatorio. Il nome visualizzato per questa metrica calcolata, come mostrato nell'interfaccia utente di Google Analytics. Lunghezza massima: 82 caratteri.
|
calculatedMetricId |
string
Solo output. L'ID da utilizzare per la metrica calcolata. Nell'interfaccia utente, è indicato come "Nome API". Il valore computeMetricId viene utilizzato quando si fa riferimento a questa metrica calcolata utilizzando le API esterne. Ad esempio, "calcMetric:{calculatedMetricId}".
|
metricUnit |
enum (MetricUnit )
Obbligatorio. Il tipo di valore della metrica calcolata.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Solo output. Tipi di dati soggetti a limitazioni contenuti in questa metrica.
|
formula |
string
Obbligatorio. La definizione della metrica calcolata. Il numero massimo di metriche personalizzate univoche a cui viene fatto riferimento è 5. Le formule supportano le seguenti operazioni: + (addizione), - (sottrazione), - (negativa), * (moltiplicazione), / (divisione), () (parentesi tonde). Sono ammessi tutti i numeri reali validi che rientrano in un numero intero lungo (64 bit) o doppio (numero in virgola mobile a 64 bit). Esempio di formula: "( customEvent:parameterName + cartPurchaseQuantity ) / 2.0"
|
invalidMetricReference |
boolean
Solo output. Se impostato su true, la metrica calcolata ha un riferimento non valido. Qualsiasi operazione che utilizzi una metrica calcolata con invalidMetricReference impostato su true potrebbe non riuscire, generare avvisi o produrre risultati imprevisti.
|
MetricUnit
Possibili tipi di rappresentazione del valore della metrica calcolata.
Enum |
METRIC_UNIT_UNSPECIFIED |
MetricUnit non specificata o mancante. |
STANDARD |
Questa metrica utilizza le unità predefinite. |
CURRENCY |
Questa metrica misura una valuta. |
FEET |
Questa metrica misura i piedi. |
MILES |
Questa metrica misura le miglia. |
METERS |
Questa metrica misura i metri. |
KILOMETERS |
Questa metrica misura i chilometri. |
MILLISECONDS |
Questa metrica misura i millisecondi. |
SECONDS |
Questa metrica misura i secondi. |
MINUTES |
Questa metrica misura i minuti. |
HOURS |
Questa metrica misura le ore. |
RestrictedMetricType
Etichette che contrassegnano i dati nella metrica calcolata utilizzata insieme ai ruoli utente che limitano l'accesso alle metriche dei costi e/o delle entrate.
Enum |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Tipo sconosciuto o non specificato. |
COST_DATA |
Dati di costo nei report sulle metriche. |
REVENUE_DATA |
La metrica riporta i dati sulle entrate. |
Metodi |
|
Crea una metrica calcolata. |
|
Elimina una metrica calcolata in una proprietà. |
|
Ricerca di una singola metrica Calcolata. |
|
Elenca le metriche calcolate in una proprietà. |
|
Aggiorna una metrica calcolata su una proprietà. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]