Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.listRecommendGoogleLocations
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
همه GoogleLocation هایی را که به حساب نمایه کسب و کار مشخص شده توصیه شده اند فهرست کنید. توصیه‌ها فقط برای حساب‌های شخصی و گروه‌های مکان ارائه شده‌اند، درخواست‌ها برای همه انواع حساب‌های دیگر منجر به خطا می‌شوند. توصیه‌ها برای گروه‌های مکان براساس مکان‌های آن گروه است.
توصیه‌های مربوط به حساب‌های شخصی بر اساس همه مکان‌هایی است که کاربر در نمایه کسب‌وکار (که شامل مکان‌هایی است که می‌توانند از طریق گروه‌های مکان به آن‌ها دسترسی داشته باشند) دسترسی دارد، و مجموعه‌ای از همه توصیه‌های ایجاد شده برای کاربر است.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
name | string نام منبع حساب برای واکشی مکان‌های پیشنهادی Google برای. |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer چند مکان برای واکشی در هر صفحه. پیش فرض 25، حداقل 1 و حداکثر اندازه صفحه 100 است. |
pageToken | string در صورت مشخص شدن، صفحه بعدی مکان ها بازیابی می شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای GoogleLocations.ListRecommendedGoogleLocations.
همچنین حاوی مکان‌هایی است که سایر کاربران نمایه کسب‌وکار از آخرین باری که به این حساب نمایه کسب‌وکار توصیه شده‌اند، ادعا شده است.
| نمایندگی JSON |
|---|
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| فیلدها |
|---|
googleLocations[] | object ( GoogleLocation ) مکان‌هایی که به حساب نمایه کسب‌وکار توصیه می‌شوند. هر یک از اینها نشان دهنده یک GoogleLocation است که در Maps وجود دارد. مکان ها به ترتیب نزولی مربوط به حساب نمایه کسب و کار مرتب شده اند. |
totalSize | integer تعداد کل مکان‌های توصیه‌شده برای این حساب نمایه کسب‌وکار، صرف نظر از صفحه‌بندی. |
nextPageToken | string در حین صفحه‌بندی، اگر مکان‌های بیشتری برای واکشی در صفحه بعدی وجود داشته باشد، این فیلد با نشانه‌ای پر می‌شود تا صفحه بعدی مکان‌ها را در تماس بعدی واکشی کند. اگر مکان دیگری برای واکشی وجود نداشته باشد، این فیلد در پاسخ وجود ندارد. |
محدوده مجوز
به یکی از حوزه های 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-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists recommended Google Locations for a specified Business Profile account, suitable for personal accounts and location groups.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are based on locations the user has access to and are sorted by relevance.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes location details, total recommendations, and pagination token for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Business Profile management.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listRecommendGoogleLocations\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.ListRecommendedGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList all the [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)s that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group.\n\nThe recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------|\n| `name` | `string` Name of the account resource to fetch recommended Google locations for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of locations is retrieved. |\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 GoogleLocations.ListRecommendedGoogleLocations.\n\nIt also contains some locations that have been claimed by other Business Profile users since the last time they were recommended to this Business Profile account.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` The locations recommended to a Business Profile account. Each of these represents a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation) that is present on Maps. The locations are sorted in decreasing order of relevance to the Business Profile account. |\n| `totalSize` | `integer` The total number of recommended locations for this Business Profile account, irrespective of pagination. |\n| `nextPageToken` | `string` During pagination, if there are more locations available to be fetched in the next page, this field is populated with a token to fetch the next page of locations in a subsequent call. If there are no more locations to be fetched, this field is not present in the response. |\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)."]]
