تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.listRecommendGoogleLocations
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يُرجى إدراج جميع GoogleLocation التي تمت التوصية بها لحساب "الملف التجاري" المحدّد. يتم تقديم اقتراحات للحسابات الشخصية ومجموعات المواقع الجغرافية فقط، وستؤدي الطلبات إلى جميع أنواع الحسابات الأخرى إلى حدوث خطأ. تستند اقتراحات مجموعات المواقع الجغرافية إلى المواقع الجغرافية في تلك المجموعة.
تستند اقتراحات الحسابات الشخصية إلى جميع المواقع الجغرافية التي يمكن للمستخدم الوصول إليها في "الملف التجاري" (بما في ذلك المواقع الجغرافية التي يمكنه الوصول إليها من خلال مجموعات المواقع الجغرافية)، وهي مجموعة رئيسية من جميع الاقتراحات التي تم إنشاؤها للمستخدم.
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
اسم مورد الحساب المطلوب استرجاع مواقع Google الجغرافية المقترَحة له.
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
عدد المواقع الجغرافية المطلوب جلبها لكل صفحة القيمة التلقائية هي 25، والحد الأدنى هو 1، والحد الأقصى لحجم الصفحة هو 100.
|
pageToken |
string
وفي حال تحديده، يتم استرداد الصفحة التالية من المواقع الجغرافية.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ على GoogleLocations.ListRecommendedGoogleLocations.
ويحتوي التقرير أيضًا على بعض المواقع الجغرافية التي طالب بها مستخدمون آخرون في "الملف التجاري على Google" منذ آخر مرة تمّ اقتراحها فيها باستخدام هذا الحساب على "الملف التجاري على Google".
| تمثيل JSON |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| الحقول |
googleLocations[] |
object (GoogleLocation)
المواقع الجغرافية المقترَحة لحساب "الملف التجاري" يمثّل كلٌّ من هذه القيم GoogleLocation معروضة على "خرائط Google". يتم ترتيب المواقع الجغرافية بترتيب تنازلي حسب مدى صلتها بحساب "الملف التجاري على Google".
|
totalSize |
integer
إجمالي عدد المواقع الجغرافية المقترَحة لحساب "الملف التجاري" هذا، بغض النظر عن التقسيم على صفحات.
|
nextPageToken |
string
أثناء التقسيم على صفحات، إذا كان هناك المزيد من المواقع الجغرافية التي يمكن استرجاعها في الصفحة التالية، تتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من المواقع الجغرافية في استدعاء لاحق. إذا لم تكن هناك مواقع جغرافية أخرى لاسترجاعها، هذا يعني أنّ هذا الحقل غير متوفّر في الردّ.
|
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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)."]]
