تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ location جديدة يملكها الحساب المحدّد، وتعرضها.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
parent |
string
اسم الحساب الذي سيتم إنشاء هذا الموقع الجغرافي فيه.
|
معلمات طلب البحث
| المَعلمات |
validateOnly |
boolean
إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب بدون إنشاء الموقع الجغرافي.
|
requestId |
string
رقم تعريف طلب فريد للخادم لاكتشاف الطلبات المكررة. ننصحك باستخدام المعرّفات الفريدة العالمية (UUID). الحد الأقصى للطول هو 50 حرفًا.
|
نص الطلب
يحتوي نص الطلب على مثال Location.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل 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\u003eCreates a new location owned by a specified account and returns the location data upon successful creation.\u003c/p\u003e\n"],["\u003cp\u003eThe endpoint utilizes a POST request to \u003ccode\u003ehttps://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations\u003c/code\u003e with path and query parameters for customization.\u003c/p\u003e\n"],["\u003cp\u003eRequires a request body containing a \u003ccode\u003eLocation\u003c/code\u003e object and responds with the newly created \u003ccode\u003eLocation\u003c/code\u003e object if successful.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using OAuth scopes like \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"]]],[],null,["# Method: accounts.locations.create\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- [Authorization Scopes](#body.aspect)\n\nCreates a new [location](/my-business/reference/rest/v4/accounts.locations#Location) owned by the specified account, and returns it.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations`\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 account in which to create this location. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `validateOnly` | `boolean` If true, the request is validated without actually creating the location. |\n| `requestId` | `string` A unique request ID for the server to detect duplicated requests. We recommend using UUIDs. Max length is 50 characters. |\n\n### Request body\n\nThe request body contains an instance of [Location](/my-business/reference/rest/v4/accounts.locations#Location).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Location](/my-business/reference/rest/v4/accounts.locations#Location).\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)."]]
