جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
REST Resource: properties.customMetrics
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: مقياس مخصَّص
الحقول |
name |
string
النتائج فقط. اسم المورد لهذا المورد في CustomMetric التنسيق: الخصائص/{property}/customMetrics/{customMetric}
|
parameterName |
string
مطلوب. غير قابل للتغيير. اسم وضع العلامات لهذا المقياس المخصّص. إذا كان هذا مقياسًا على مستوى الحدث، يكون هذا هو اسم مَعلمة الحدث. لا يمكن أن يحتوي إلا على أحرف أبجدية رقمية وشرطات سفلية، بدءًا من حرف. يمكن استخدام 40 حرفًا كحدّ أقصى للمقاييس على مستوى الحدث.
|
displayName |
string
مطلوب. الاسم المعروض لهذا المقياس المخصّص كما هو موضّح في واجهة مستخدم "إحصاءات Google". الحد الأقصى للطول هو 82 حرفًا، أبجدية رقمية بالإضافة إلى مسافة وشرطة سفلية تبدأ بحرف. قد تحتوي الأسماء المعروضة القديمة التي ينشئها النظام على أقواس مربّعة، إلا أنّ تعديلات هذا الحقل لن تسمح مطلقًا باستخدام أقواس مربّعة.
|
description |
string
اختياريّ. وصف لهذه السمة المخصّصة. 150 حرفًا كحدّ أقصى
|
measurementUnit |
enum (MeasurementUnit )
مطلوب. نوع قيمة المقياس المخصّص.
|
scope |
enum (MetricScope )
مطلوب. غير قابل للتغيير. نطاق هذا المقياس المخصّص.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
اختياريّ. أنواع البيانات المحظورة التي قد يحتوي عليها هذا المقياس مطلوب للمقاييس التي تتضمّن وحدة قياس CURRENCY. يجب أن يكون هذا الحقل فارغًا للمقاييس التي لها وحدة قياس غير CURRENCY.
|
MeasurementUnit
الأنواع المحتملة لتمثيل قيمة المقياس المخصّص.
قد يتغير تمثيل العملة في المستقبل، ما يتطلب حدوث تغيير غير سليم في واجهة برمجة التطبيقات.
عمليات التعداد |
MEASUREMENT_UNIT_UNSPECIFIED |
وحدة القياس غير محدّدة أو غير متوفّرة. |
STANDARD |
يستخدِم هذا المقياس الوحدات التلقائية. |
CURRENCY |
يقيس هذا المقياس العملة. |
FEET |
يقيس هذا المقياس قدم. |
METERS |
يقيس هذا المقياس مترًا. |
KILOMETERS |
يقيس هذا المقياس الكيلومترات. |
MILES |
يقيس هذا المقياس الأميال. |
MILLISECONDS |
ويقيس هذا المقياس المللي ثانية. |
SECONDS |
يقيس هذا المقياس الثواني. |
MINUTES |
يقيس هذا المقياس الدقائق. |
HOURS |
يقيس هذا المقياس الساعات. |
MetricScope
عمليات التعداد |
METRIC_SCOPE_UNSPECIFIED |
النطاق غير معروف أو لم يتم تحديده. |
EVENT |
المقياس على مستوى حدث معيّن. |
RestrictedMetricType
التصنيفات التي تضع علامة على البيانات في هذا المقياس المخصّص كبيانات يجب أن تقتصر على مستخدمين محددين
عمليات التعداد |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
النوع غير معروف أو غير محدّد. |
COST_DATA |
بيانات تكلفة تقارير المقاييس. |
REVENUE_DATA |
وتعرض المقاييس بيانات الأرباح. |
الطُرق |
|
أرشفة مقياس مخصَّص في أحد المواقع |
|
ينشئ مقياسًا مخصّصًا. |
|
ابحث عن مقياس مخصّص واحد. |
|
يسرد المقاييس المخصَّصة على أحد المواقع. |
|
لتعديل مقياس مخصَّص على أحد المواقع |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eCustomMetric\u003c/code\u003e resource allows you to define custom metrics with specific parameters, display names, descriptions, measurement units, and scopes within Google Analytics.\u003c/p\u003e\n"],["\u003cp\u003eThese custom metrics can have various measurement units like \u003ccode\u003eSTANDARD\u003c/code\u003e, \u003ccode\u003eCURRENCY\u003c/code\u003e, \u003ccode\u003eFEET\u003c/code\u003e, \u003ccode\u003eMETERS\u003c/code\u003e, and more, alongside scopes such as \u003ccode\u003eEVENT\u003c/code\u003e to tailor data collection to specific events.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage your custom metrics with dedicated methods, including \u003ccode\u003earchive\u003c/code\u003e, \u003ccode\u003ecreate\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, and \u003ccode\u003epatch\u003c/code\u003e to control their lifecycle and properties directly through the API.\u003c/p\u003e\n"],["\u003cp\u003eRestricted data like cost and revenue can be tracked by labeling the metric with specific \u003ccode\u003eRestrictedMetricType\u003c/code\u003e values, ensuring appropriate access controls.\u003c/p\u003e\n"]]],["CustomMetrics are defined by `name`, `parameterName`, `displayName`, `description`, `measurementUnit`, `scope`, and `restrictedMetricType`. `MeasurementUnit` options include standard, currency, and various distance/time units. `MetricScope` can be event-based. `RestrictedMetricType` marks data like cost or revenue. Methods allow creating, retrieving, listing, updating, and archiving custom metrics. These metrics are structured with specific field requirements, such as length and character restrictions.\n"],null,["# REST Resource: properties.customMetrics\n\n- [Resource: CustomMetric](#CustomMetric)\n - [JSON representation](#CustomMetric.SCHEMA_REPRESENTATION)\n- [MeasurementUnit](#MeasurementUnit)\n- [MetricScope](#MetricScope)\n- [RestrictedMetricType](#RestrictedMetricType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomMetric\n----------------------\n\nA definition for a custom metric.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"parameterName\": string, \"displayName\": string, \"description\": string, \"measurementUnit\": enum (/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#MeasurementUnit), \"scope\": enum (/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#MetricScope), \"restrictedMetricType\": [ enum (/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#RestrictedMetricType) ] } ``` |\n\n| Fields ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name for this CustomMetric resource. Format: properties/{property}/customMetrics/{customMetric} |\n| `parameterName` | `string` Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name. May only contain alphanumeric and underscore charactes, starting with a letter. Max length of 40 characters for event-scoped metrics. |\n| `displayName` | `string` Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter. Legacy system-generated display names may contain square brackets, but updates to this field will never permit square brackets. |\n| `description` | `string` Optional. Description for this custom dimension. Max length of 150 characters. |\n| `measurementUnit` | `enum (`[MeasurementUnit](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#MeasurementUnit)`)` Required. The type for the custom metric's value. |\n| `scope` | `enum (`[MetricScope](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#MetricScope)`)` Required. Immutable. The scope of this custom metric. |\n| `restrictedMetricType[]` | `enum (`[RestrictedMetricType](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics#RestrictedMetricType)`)` Optional. Types of restricted data that this metric may contain. Required for metrics with CURRENCY measurement unit. Must be empty for metrics with a non-CURRENCY measurement unit. |\n\nMeasurementUnit\n---------------\n\nPossible types of representing the custom metric's value.\n\nCurrency representation may change in the future, requiring a breaking API change.\n\n| Enums ||\n|--------------------------------|-----------------------------------------|\n| `MEASUREMENT_UNIT_UNSPECIFIED` | MeasurementUnit unspecified or missing. |\n| `STANDARD` | This metric uses default units. |\n| `CURRENCY` | This metric measures a currency. |\n| `FEET` | This metric measures feet. |\n| `METERS` | This metric measures meters. |\n| `KILOMETERS` | This metric measures kilometers. |\n| `MILES` | This metric measures miles. |\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\nMetricScope\n-----------\n\nThe scope of this metric.\n\n| Enums ||\n|----------------------------|---------------------------------|\n| `METRIC_SCOPE_UNSPECIFIED` | Scope unknown or not specified. |\n| `EVENT` | Metric scoped to an event. |\n\nRestrictedMetricType\n--------------------\n\nLabels that mark the data in this custom metric as data that should be restricted to specific users.\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| ### [archive](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics/archive) | Archives a CustomMetric on a property. |\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics/create) | Creates a CustomMetric. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics/get) | Lookup for a single CustomMetric. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics/list) | Lists CustomMetrics on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customMetrics/patch) | Updates a CustomMetric on a property. |"]]