Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم میکند.
زمانبندی منسوخ شدن و دستورالعملهای انتقال از روش API reportInsights v4 به API عملکرد نمایه کسبوکار Google را مرور کنید.
Method: locations.fetchMultiDailyMetricsTimeSeries
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eFetches daily metrics time series data for a specified location within a given date range.\u003c/p\u003e\n"],["\u003cp\u003eAllows retrieval of specific daily metrics, such as website clicks and call clicks.\u003c/p\u003e\n"],["\u003cp\u003eReturns data organized by daily metric and optionally broken down by sub-entity types.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eData is presented as a list of time series, each containing date-value pairs for the corresponding metric.\u003c/p\u003e\n"]]],[],null,["# Method: locations.fetchMultiDailyMetricsTimeSeries\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FetchMultiDailyMetricsTimeSeriesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [MultiDailyMetricTimeSeries](#MultiDailyMetricTimeSeries)\n - [JSON representation](#MultiDailyMetricTimeSeries.SCHEMA_REPRESENTATION)\n- [DailyMetricTimeSeries](#DailyMetricTimeSeries)\n - [JSON representation](#DailyMetricTimeSeries.SCHEMA_REPRESENTATION)\n\nReturns the values for each date from a given time range and optionally the sub entity type, where applicable, that are associated with the specific daily metrics.\n\nExample request: `GET\nhttps://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&dailyRange.start_date.year=2022&dailyRange.start_date.month=1&dailyRange.start_date.day=1&dailyRange.end_date.year=2022&dailyRange.end_date.month=3&dailyRange.end_date.day=31`\n\n### HTTP request\n\n`GET https://businessprofileperformance.googleapis.com/v1/{location=locations/*}:fetchMultiDailyMetricsTimeSeries`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `string` Required. The location for which the time series should be fetched. Format: locations/{locationId} where locationId is an unobfuscated listing id. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dailyMetrics[]` | `enum (`[DailyMetric](/my-business/reference/performance/rest/v1/DailyMetric)`)` Required. The metrics to retrieve time series for. |\n| `dailyRange` | `object (`[DailyRange](/my-business/reference/performance/rest/v1/DailyRange)`)` Required. The timerange for which the time series will be fetched. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nRepresents the response for locations.fetchMultiDailyMetricsTimeSeries.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"multiDailyMetricTimeSeries\": [ { object (/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries#MultiDailyMetricTimeSeries) } ] } ``` |\n\n| Fields ||\n|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `multiDailyMetricTimeSeries[]` | `object (`[MultiDailyMetricTimeSeries](/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries#MultiDailyMetricTimeSeries)`)` DailyMetrics and their corresponding time series. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\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\nMultiDailyMetricTimeSeries\n--------------------------\n\nRepresents a list of tuples of DailyMetric-DailySubEntityType-TimeSeries.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"dailyMetricTimeSeries\": [ { object (/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries#DailyMetricTimeSeries) } ] } ``` |\n\n| Fields ||\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dailyMetricTimeSeries[]` | `object (`[DailyMetricTimeSeries](/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries#DailyMetricTimeSeries)`)` List of DailyMetric-TimeSeries pairs. |\n\nDailyMetricTimeSeries\n---------------------\n\nRepresents a single datapoint, where each datapoint is a DailyMetric-DailySubEntityType-TimeSeries tuple.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"dailyMetric\": enum (/my-business/reference/performance/rest/v1/DailyMetric), \"dailySubEntityType\": { object (/my-business/reference/performance/rest/v1/DailySubEntityType) }, \"timeSeries\": { object (/my-business/reference/performance/rest/v1/TimeSeries) } } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dailyMetric` | `enum (`[DailyMetric](/my-business/reference/performance/rest/v1/DailyMetric)`)` The DailyMetric that the TimeSeries represents. |\n| `dailySubEntityType` | `object (`[DailySubEntityType](/my-business/reference/performance/rest/v1/DailySubEntityType)`)` The DailySubEntityType that the TimeSeries represents. Will not be present when breakdown does not exist. |\n| `timeSeries` | `object (`[TimeSeries](/my-business/reference/performance/rest/v1/TimeSeries)`)` List of datapoints where each datapoint is a date-value pair. |"]]