Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به 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) ارزش. اگر مقداری تنظیم نشده باشد، داده های درخواستی از دست رفته است. |
بعد زمانی
ابعادی که داده ها برای آن تقسیم می شوند.
| فیلدها |
|---|
dayOfWeek | enum ( DayOfWeek ) روز هفته («دوشنبه» تا «یکشنبه») این مقدار مطابق است. برای گزینه BREAKDOWN_DAY_OF_WEEK تنظیم کنید. |
timeOfDay | object ( TimeOfDay ) ساعت روز (0 تا 23) این مقدار مطابق است. برای گزینه BREAKDOWN_HOUR_OF_DAY تنظیم کنید. |
timeRange | object ( TimeRange ) محدوده زمانی که این مقدار پوشش می دهد. برای گزینه های AGGREGATED_TOTAL و AGGREGATED_DAILY تنظیم کنید. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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. |"]]
