Coba server MCP untuk Google Analytics. Instal dari
GitHub, dan lihat
pengumuman untuk mengetahui detail selengkapnya.
REST Resource: properties.calculatedMetrics
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: CalculatedMetric
Definisi untuk metrik yang dihitung.
Representasi JSON |
{
"name": string,
"description": string,
"displayName": string,
"calculatedMetricId": string,
"metricUnit": enum (MetricUnit ),
"restrictedMetricType": [
enum (RestrictedMetricType )
],
"formula": string,
"invalidMetricReference": boolean
} |
Kolom |
name |
string
Hanya output. Nama resource untuk CalculatedMetric ini. Format: 'properties/{property_id}/calculatedMetrics/{calculatedMetricId}'
|
description |
string
Opsional. Deskripsi untuk metrik yang dihitung ini. Panjang maksimal 4.096 karakter.
|
displayName |
string
Wajib. Nama tampilan untuk metrik yang dihitung ini seperti yang ditampilkan di UI Google Analytics. Panjang maksimal 82 karakter.
|
calculatedMetricId |
string
Hanya output. ID yang akan digunakan untuk metrik yang dihitung. Pada UI, ini disebut sebagai "nama API". CalculateMetricId digunakan saat mereferensikan metrik yang dihitung ini dari API eksternal. Misalnya, "calcMetric:{calculatedMetricId}".
|
metricUnit |
enum (MetricUnit )
Wajib. Jenis untuk nilai metrik yang dihitung.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Hanya output. Jenis data yang dibatasi dalam metrik ini.
|
formula |
string
Wajib. Definisi metrik yang dihitung. Jumlah maksimum metrik kustom unik yang direferensikan adalah 5. Formula mendukung operasi berikut: + (penambahan), - (pengurangan), - (negatif), * (perkalian), / (pembagian), () (tanda kurung). Bilangan riil yang valid dapat diterima yang sesuai dengan Long (bilangan bulat 64bit) atau Ganda (angka floating point 64 bit). Contoh formula: "( customEvent:parameterName + cartPurchaseQuantity ) / 2.0"
|
invalidMetricReference |
boolean
Hanya output. Jika true (benar), metrik yang dihitung ini memiliki referensi metrik yang tidak valid. Apa pun yang menggunakan metrik yang dihitung dengan invalidMetricReference yang ditetapkan ke true bisa gagal, menampilkan peringatan, atau memberikan hasil yang tidak diharapkan.
|
MetricUnit
Kemungkinan jenis representasi nilai metrik yang dihitung.
Enum |
METRIC_UNIT_UNSPECIFIED |
MetricUnit tidak ditentukan atau tidak ada. |
STANDARD |
Metrik ini menggunakan satuan default. |
CURRENCY |
Metrik ini mengukur mata uang. |
FEET |
Metrik ini mengukur kaki. |
MILES |
Metrik ini mengukur mil. |
METERS |
Metrik ini mengukur meter. |
KILOMETERS |
Metrik ini mengukur kilometer. |
MILLISECONDS |
Metrik ini mengukur milidetik. |
SECONDS |
Metrik ini mengukur detik. |
MINUTES |
Metrik ini mengukur menit. |
HOURS |
Metrik ini mengukur jam. |
RestrictedMetricType
Label yang menandai data dalam metrik yang dihitung yang digunakan bersama dengan peran pengguna yang membatasi akses ke metrik biaya dan/atau pendapatan.
Enum |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Jenis tidak diketahui atau tidak ditentukan. |
COST_DATA |
Metrik melaporkan data biaya. |
REVENUE_DATA |
Metrik melaporkan data pendapatan. |
Metode |
|
Membuat CalculatedMetric. |
|
Menghapus CalculatedMetric pada properti. |
|
Mencari satu CalculatedMetric. |
|
Mencantumkan CalculatedMetrics pada properti. |
|
Memperbarui CalculatedMetric pada properti. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]