Method: properties.calculatedMetrics.create
طلب HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/calculatedMetrics
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. التنسيق: properties/{property_id}، مثال: properties/1234
|
مَعلمات طلب البحث
المعلمات |
calculatedMetricId |
string
مطلوب. رقم التعريف الذي سيتم استخدامه للمقياس المحسوب والذي سيصبح المكوّن النهائي لاسم مورد المقياس المحسوب. يجب أن تتألّف هذه القيمة من 1 إلى 80 حرفًا، ويجب أن تكون الأحرف الصالحة هي /[a-zA-Z0-9_]/، ولا يُسمح باستخدام أي مسافات. يجب أن يكون مَعلمة calculatedMetricId فريدًا بين جميع المقاييس المحسوبة ضمن موقع. يتم استخدام مَعلمة calculatedMetricId عند الإشارة إلى هذا المقياس المحسوب من واجهات برمجة تطبيقات خارجية، على سبيل المثال، "calcMetric:{calculatedMetricId}".
|
نص الطلب
يحتوي نص الطلب على مثال CalculatedMetric
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من CalculatedMetric
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Creates a new CalculatedMetric within a specified Google Analytics 4 property using an HTTP POST request."],["Requires providing a unique `calculatedMetricId` and the `property_id` as path and query parameters, respectively."],["The request body should contain the CalculatedMetric definition, and a successful response will return the newly created CalculatedMetric instance."],["Users need to have the `analytics.edit` OAuth scope to authorize this operation."]]],["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"]]