Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
REST Resource: properties.calculatedMetrics
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: AccountdMetric
Hesaplanmış metriğin tanımı.
JSON gösterimi |
{
"name": string,
"description": string,
"displayName": string,
"calculatedMetricId": string,
"metricUnit": enum (MetricUnit ),
"restrictedMetricType": [
enum (RestrictedMetricType )
],
"formula": string,
"invalidMetricReference": boolean
} |
Alanlar |
name |
string
Yalnızca çıkış. Bu AccountdMetric'in kaynak adı. Biçim: "properties/{property_id}/calculatedMetrics/{calculatedMetricId}"
|
description |
string
İsteğe bağlı. Bu hesaplanmış metriğin açıklaması. En fazla 4.096 karakter.
|
displayName |
string
Zorunlu. Bu hesaplanmış metriğin, Google Analytics kullanıcı arayüzünde gösterilen görünen adı. Maks. uzunluk 82 karakter.
|
calculatedMetricId |
string
Yalnızca çıkış. Hesaplanmış metrik için kullanılacak kimlik. Kullanıcı arayüzünde buna "API adı" denir. accountMetricId, harici API'lerden bu hesaplanmış metriğe referansta bulunurken kullanılır. Örneğin, "calcMetric:{calculatedMetricId}".
|
metricUnit |
enum (MetricUnit )
Zorunlu. Hesaplanmış metrik değerinin türü.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Yalnızca çıkış. Bu metriğin içerdiği kısıtlanmış veri türleri.
|
formula |
string
Zorunlu. Hesaplanmış metriğin tanımı. Maksimum referans verilen benzersiz özel metrik sayısı 5'tir. Formüller şu işlemleri destekler: + (toplama), - (çıkarma), - (negatif), * (çarpma), / (bölme), () (parantez). Uzun (64 bit tam sayı) veya Çift (64 bit kayan nokta sayı) değerine uyan tüm geçerli gerçek sayılar kabul edilebilir. Örnek formül: "( customEvent:parameterName + cartPurchaseQuantity ) / 2.0"
|
invalidMetricReference |
boolean
Yalnızca çıkış. Doğru ise bu hesaplanan metrikte geçersiz metrik referansı var. InvalidMetricReference'ın (doğru) değerine ayarlanmasıyla hesaplanmış bir metrik kullanan bir şey başarısız olabilir, uyarı verebilir veya beklenmedik sonuçlar üretebilir.
|
MetricUnit
Hesaplanmış metriğin değerini göstermenin olası türleri.
Sıralamalar |
METRIC_UNIT_UNSPECIFIED |
MetricUnit belirtilmedi veya eksik. |
STANDARD |
Bu metrikte varsayılan birimler kullanılır. |
CURRENCY |
Bu metrik bir para birimi ölçer. |
FEET |
Bu metrik fit ölçer. |
MILES |
Bu metrik mil ölçer. |
METERS |
Bu metrik metre ölçer. |
KILOMETERS |
Bu metrik kilometreyi ölçer. |
MILLISECONDS |
Bu metrik, milisaniye ölçer. |
SECONDS |
Bu metrik saniyeyi ölçer. |
MINUTES |
Bu metrik dakikayı ölçer. |
HOURS |
Bu metrik, saati ölçer. |
RestrictedMetricType
Verileri hesaplanmış metrikte işaretleyen etiketler, maliyet ve/veya gelir metriklerine erişimi kısıtlayan kullanıcı rolleriyle birlikte kullanılır.
Sıralamalar |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Bilinmeyen veya belirtilmedi. |
COST_DATA |
Metrik raporları maliyet verileri. |
REVENUE_DATA |
Metrik, gelir verilerini raporlar. |
Yöntemler |
|
Bir AccountdMetric oluşturur. |
|
Bir mülkteki AccountdMetric'i siler. |
|
Tek bir AccountdMetric arayın. |
|
Bir mülkteki AccountdMetrics'i listeler. |
|
Bir mülkteki AccountdMetric'i günceller. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]