Google Business Performance API 的新 API 方法可通过单个 API 请求提取多个 `DailyMetrics`。 请查看弃用时间表和相关说明,并从 v4 reportInsights API 方法迁移至 Google Business Profile Performance API。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eReturns insights data for a set of local posts associated with a single listing, limited to 100 posts per API call.\u003c/p\u003e\n"],["\u003cp\u003eThe request body specifies the local post names and includes an optional request for basic metric insights.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides metrics for each requested post, along with the location's time zone.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines how to retrieve insights for local posts associated with a specific listing. Key actions include sending a `POST` HTTP request to a designated URL with a location's name in the path. The request body must contain a list of `localPostNames` (up to 100) and optionally a `basicRequest` object to define the metrics. The response includes the location's name, time zone, and an array of `localPostMetrics`, each detailing requested metric values for a specific post. OAuth scopes are required.\n"],null,["# Method: accounts.locations.localPosts.reportInsights\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ReportLocalPostInsightsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [LocalPostMetrics](#LocalPostMetrics)\n - [JSON representation](#LocalPostMetrics.SCHEMA_REPRESENTATION)\n\nReturns insights for a set of local posts associated with a single listing. Which metrics and how they are reported are options specified in the request proto.\n| **Note:** Insight reports are limited to 100 `localPostNames` per call.\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}/localPosts:reportInsights`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the location for which to fetch insights. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"localPostNames\": [ string ], \"basicRequest\": { object (/my-business/reference/rest/v4/BasicMetricsRequest) } } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `localPostNames[]` | `string` Required. The list of posts for which to fetch insights data. All posts have to belong to the location whose name is specified in the `name` field. |\n| `basicRequest` | `object (`[BasicMetricsRequest](/my-business/reference/rest/v4/BasicMetricsRequest)`)` A request to include basic metric insights in the report. This request applies to all posts requested. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Insights.ReportLocalPostInsights\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"localPostMetrics\": [ { object (/my-business/reference/rest/v4/accounts.locations.localPosts/reportInsights#LocalPostMetrics) } ], \"timeZone\": string } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` |\n| `localPostMetrics[]` | `object (`[LocalPostMetrics](/my-business/reference/rest/v4/accounts.locations.localPosts/reportInsights#LocalPostMetrics)`)` One entry per requested post corresponding to this location. |\n| `timeZone` | `string` Time zone (IANA timezone IDs, eg, 'Europe/London') of the location. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nLocalPostMetrics\n----------------\n\nAll the metrics requested for a Local Post.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"localPostName\": string, \"metricValues\": [ { object (/my-business/reference/rest/v4/MetricValue) } ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------|\n| `localPostName` | `string` |\n| `metricValues[]` | `object (`[MetricValue](/my-business/reference/rest/v4/MetricValue)`)` A list of values for the requested metrics. |"]]