Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
MetricValue
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
TimeDimension
欄位 |
dayOfWeek |
enum (DayOfWeek )
這個值對應的星期幾 (「MONDAY」到「SUNDAY」)。已設定 BREAKDOWN_DAY_OF_WEEK 的選項。
|
timeOfDay |
object (TimeOfDay )
此值對應的時段 (0 到 23)。已設定 BREAKDOWN_HOUR_OF_DAY 選項。
|
timeRange |
object (TimeRange )
這個值涵蓋的時間範圍。為 AGGREGATED_TOTAL 和 AGGREGATED_DAILY 選項設定。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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. |"]]