سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: properties.calculatedMetrics.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک CalculatedMetric ایجاد می کند.
درخواست HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/calculatedMetrics
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
parent | string ضروری. قالب: خواص/{property_id} مثال: properties/1234 |
پارامترهای پرس و جو
| مولفه های |
|---|
calculatedMetricId | string ضروری. شناسه مورد استفاده برای متریک محاسبه شده که جزء نهایی نام منبع متریک محاسبه شده خواهد بود. این مقدار باید 1-80 کاراکتر باشد و کاراکترهای معتبر /[a-zA-Z0-9_]/ هستند، هیچ فاصله ای مجاز نیست. caldMetricId باید بین تمام معیارهای محاسبه شده تحت یک ویژگی منحصر به فرد باشد. CalcMetricId هنگام ارجاع به این معیار محاسبه شده از APIهای خارجی، به عنوان مثال، "calcMetric:{calculatedMetricId}" استفاده می شود. |
درخواست بدن
بدنه درخواست شامل یک نمونه از CalculatedMetric است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از CalculatedMetric است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.edit
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eCreates a new CalculatedMetric within a specified Google Analytics 4 property using an HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a unique \u003ccode\u003ecalculatedMetricId\u003c/code\u003e and the \u003ccode\u003eproperty_id\u003c/code\u003e as path and query parameters, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the CalculatedMetric definition, and a successful response will return the newly created CalculatedMetric instance.\u003c/p\u003e\n"],["\u003cp\u003eUsers need to have the \u003ccode\u003eanalytics.edit\u003c/code\u003e OAuth scope to authorize this operation.\u003c/p\u003e\n"]]],["This documentation details how to create a CalculatedMetric via a `POST` request to the specified URL, including required components such as path and query parameters, the request body and the response body. The path parameter `parent` defines the property ID. The query parameter `calculatedMetricId` is a unique identifier. The request and response bodies are `CalculatedMetric` instances. This action requires authorization scope: `https://www.googleapis.com/auth/analytics.edit`.\n"],null,["# Method: properties.calculatedMetrics.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a CalculatedMetric.\n\n### HTTP request\n\n`POST https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/calculatedMetrics`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------|\n| `parent` | `string` Required. Format: properties/{property_id} Example: properties/1234 |\n\n### Query parameters\n\n| Parameters ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `calculatedMetricId` | `string` Required. The ID to use for the calculated metric which will become the final component of the calculated metric's resource name. This value should be 1-80 characters and valid characters are /\\[a-zA-Z0-9_\\]/, no spaces allowed. calculatedMetricId must be unique between all calculated metrics under a property. The calculatedMetricId is used when referencing this calculated metric from external APIs, for example, \"calcMetric:{calculatedMetricId}\". |\n\n### Request body\n\nThe request body contains an instance of [CalculatedMetric](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#CalculatedMetric).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CalculatedMetric](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.calculatedMetrics#CalculatedMetric).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/analytics.edit`"]]
