Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.localPosts.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرستی از پست‌های محلی مرتبط با یک مکان را برمی‌گرداند.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/localPosts
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string نام مکانی که پست های محلی آن لیست می شود. |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer تعداد پست های محلی برای بازگشت در هر صفحه. پیش فرض 20. حداقل 1 و حداکثر اندازه صفحه 100 است. |
pageToken | string در صورت مشخص شدن، صفحه بعدی پست های محلی را برمی گرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای localPosts.list
| نمایندگی JSON |
|---|
{
"localPosts": [
{
object (LocalPost)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
localPosts[] | object ( LocalPost ) لیست برگشتی از پست های محلی. |
nextPageToken | string اگر تعداد پست‌های محلی بیشتر از اندازه صفحه درخواستی باشد، این فیلد با نشانه‌ای پر می‌شود تا صفحه بعدی پست‌های محلی در تماس بعدی با localPosts.list واکشی شود. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/plus.business.manage -
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis endpoint retrieves a list of local posts associated with a specific location using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eIt supports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters, allowing control over the number of posts returned and retrieval of subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eLocalPost\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing further results if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with specific OAuth scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes how to retrieve local posts associated with a specific location. A `GET` request is sent to the specified URL, including the location in the `parent` path parameter. Optional `pageSize` and `pageToken` query parameters allow for pagination. The request body must be empty. The successful response includes an array of `localPosts` objects, and a `nextPageToken` string for retrieving further results if more are available. Access requires specific authorization scopes.\n"],null,["# Method: accounts.locations.localPosts.list\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.ListLocalPostsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of local posts associated with a location.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/localPosts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------|\n| `parent` | `string` The name of the location whose local posts will be listed. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many local posts to return per page. Default of 20. The minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, returns the next page of local posts. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for localPosts.list\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"localPosts\": [ { object (/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `localPosts[]` | `object (`[LocalPost](/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost)`)` The returned list of local posts. |\n| `nextPageToken` | `string` If there are more local posts than the requested page size, then this field is populated with a token to fetch the next page of local posts on a subsequent call to `localPosts.list`. |\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)."]]
