تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
MetricValue
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يشير ذلك المصطلح إلى قيمة لمقياس واحد منذ وقت البدء.
الحقول |
metric |
enum (Metric )
المقياس الذي تنطبق عليه القيمة.
|
totalValue |
object (DimensionalMetricValue )
إجمالي القيمة المجمّعة لهذا المقياس. اضبط القيمة على الخيار AGGREGATED_TOTAL.
|
dimensionalValues[] |
object (DimensionalMetricValue )
قيم الأبعاد لهذا المقياس
|
DimensionalMetricValue
يشير ذلك المصطلح إلى قيمة لمقياس واحد ببُعد زمني معيّن.
الحقول |
metricOption |
enum (MetricOption )
الخيار الذي طلب قيمة البُعد هذه.
|
timeDimension |
object (TimeDimension )
سمة القيمة.
|
value |
string (Int64Value format)
القيمة. في حال عدم ضبط أي قيمة، ستكون البيانات المطلوبة غير متوفّرة.
|
TimeDimension
البُعد الذي يتم تقسيم البيانات عليه.
الحقول |
dayOfWeek |
enum (DayOfWeek )
اليوم من الأسبوع ("الاثنين" إلى "الأحد") التي تتوافق مع هذه القيمة. تم الضبط على خيار BREAKDOWN_DAY_OF_WEEK.
|
timeOfDay |
object (TimeOfDay )
الساعة من اليوم (0 إلى 23) التي تتوافق معها هذه القيمة. تم الضبط على الخيار BREAKDOWN_AREA_OF_DAY.
|
timeRange |
object (TimeRange )
النطاق الزمني الذي تغطيه هذه القيمة. ضبط الخيارَين AGGREGATED_TOTAL وAGGREGATED_DAILY.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMetricValue represents a single metric's value starting from a specific time.\u003c/p\u003e\n"],["\u003cp\u003eIt includes the metric, total aggregated value, and dimensional values.\u003c/p\u003e\n"],["\u003cp\u003eDimensionalMetricValue provides a metric value for a given time dimension.\u003c/p\u003e\n"],["\u003cp\u003eTimeDimension specifies how data is divided, like by day of the week, hour, or a time range.\u003c/p\u003e\n"]]],[],null,["# MetricValue\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [DimensionalMetricValue](#DimensionalMetricValue)\n - [JSON representation](#DimensionalMetricValue.SCHEMA_REPRESENTATION)\n- [TimeDimension](#TimeDimension)\n - [JSON representation](#TimeDimension.SCHEMA_REPRESENTATION)\n\nA value for a single Metric from a starting time.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"metric\": enum (/my-business/reference/rest/v4/Metric), \"totalValue\": { object (/my-business/reference/rest/v4/MetricValue#DimensionalMetricValue) }, \"dimensionalValues\": [ { object (/my-business/reference/rest/v4/MetricValue#DimensionalMetricValue) } ] } ``` |\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `metric` | `enum (`[Metric](/my-business/reference/rest/v4/Metric)`)` The metric for which the value applies. |\n| `totalValue` | `object (`[DimensionalMetricValue](/my-business/reference/rest/v4/MetricValue#DimensionalMetricValue)`)` The total aggregated value for this metric. Set for the AGGREGATED_TOTAL option. |\n| `dimensionalValues[]` | `object (`[DimensionalMetricValue](/my-business/reference/rest/v4/MetricValue#DimensionalMetricValue)`)` Dimensional values for this metric. |\n\nDimensionalMetricValue\n----------------------\n\nA value for a single metric with a given time dimension.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"metricOption\": enum (/my-business/reference/rest/v4/MetricOption), \"timeDimension\": { object (/my-business/reference/rest/v4/MetricValue#TimeDimension) }, \"value\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `metricOption` | `enum (`[MetricOption](/my-business/reference/rest/v4/MetricOption)`)` The option that requested this dimensional value. |\n| `timeDimension` | `object (`[TimeDimension](/my-business/reference/rest/v4/MetricValue#TimeDimension)`)` The dimension for the value. |\n| `value` | `string (`[Int64Value](https://developers.google.com/discovery/v1/type-format)` format)` The value. If no value is set, then the requested data is missing. |\n\nTimeDimension\n-------------\n\nThe dimension for which data is divided over.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"dayOfWeek\": enum (/my-business/reference/rest/v4/accounts.locations#Location.DayOfWeek), \"timeOfDay\": { object (/my-business/reference/rest/v4/accounts.locations.localPosts#TimeOfDay) }, \"timeRange\": { object (/my-business/reference/rest/v4/TimeRange) } } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dayOfWeek` | `enum (`[DayOfWeek](/my-business/reference/rest/v4/accounts.locations#Location.DayOfWeek)`)` The day of the week (\"MONDAY\" to \"SUNDAY\") this value corresponds to. Set for BREAKDOWN_DAY_OF_WEEK option. |\n| `timeOfDay` | `object (`[TimeOfDay](/my-business/reference/rest/v4/accounts.locations.localPosts#TimeOfDay)`)` The hour of the day (0 to 23) this value corresponds to. Set for BREAKDOWN_HOUR_OF_DAY option. |\n| `timeRange` | `object (`[TimeRange](/my-business/reference/rest/v4/TimeRange)`)` The range of time this value covers. Set for AGGREGATED_TOTAL and AGGREGATED_DAILY options. |"]]