تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.batchGet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحصل على كل المواقع الجغرافية المحدّدة في الحساب المحدّد.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGet
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
اسم الحساب المطلوب جلب المواقع منه.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"locationNames": [
string
]
} |
| الحقول |
locationNames[] |
string
مجموعة من المواقع الجغرافية المطلوب جلبها، ويتم تحديدها حسب أسمائها.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ لـ Location.BatchGetLocations
| تمثيل JSON |
{
"locations": [
{
object (Location)
}
]
} |
| الحقول |
locations[] |
object (Location)
مجموعة من المواقع الجغرافية
|
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات 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-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document outlines the process for retrieving multiple locations within a specific account using the Google My Business API.\u003c/p\u003e\n"],["\u003cp\u003eIt involves sending a POST request with location names in the request body and receiving location details in the response.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization with specified OAuth scopes is required to access this functionality.\u003c/p\u003e\n"],["\u003cp\u003eCommunication is performed using gRPC Transcoding with a structured JSON format for both requests and responses.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.locations.batchGet\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.BatchGetLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nGets all of the specified locations in the given account.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------|\n| `name` | `string` The name of the account from which to fetch locations. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-----------------------------------------|---|\n| ``` { \"locationNames\": [ string ] } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------|\n| `locationNames[]` | `string` A collection of locations to fetch, specified by their names. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Locations.BatchGetLocations.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------|---|\n| ``` { \"locations\": [ { object (/my-business/reference/rest/v4/accounts.locations#Location) } ] } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------|\n| `locations[]` | `object (`[Location](/my-business/reference/rest/v4/accounts.locations#Location)`)` A collection of locations. |\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)."]]
