تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينشئ حسابًا بالاسم والنوع المحدّدين ضمن العنصر الرئيسي المحدّد.
- لا يمكن إنشاء حسابات شخصية أو مؤسسات.
- لا يمكن إنشاء مجموعات مستخدمين باستخدام حساب شخصي كمالك أساسي.
- لا يمكن إنشاء مجموعات المواقع الجغرافية مع مالك أساسي لحساب شخصي إذا كان هذا الحساب تابعًا لمؤسسة.
- لا يمكن لـ "مجموعات المواقع الجغرافية" امتلاك مجموعات المواقع الجغرافية.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/accounts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
| المَعلمات |
primaryOwner |
string
اسم مورد الحساب الذي سيكون المالك الأساسي للحساب الذي يتم إنشاؤه يجب أن يكون بالشكل accounts/{accountId}/.
|
نص الطلب
يحتوي نص الطلب على مثال Account.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Account تم إنشاؤه حديثًا.
نطاقات الأذونات
يتطلب استخدام أحد نطاقات 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 endpoint creates a new Google My Business account with a specified name, type, and primary owner, but Personal accounts and Organizations cannot be created directly.\u003c/p\u003e\n"],["\u003cp\u003eLocation Groups have ownership restrictions, preventing creation by Personal accounts under certain conditions or ownership of other Location Groups.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the primary owner's account ID and the account details in the request body, using the \u003ccode\u003ePOST\u003c/code\u003e method with the provided URL.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return the newly created account details, while authorization requires specific OAuth scopes for account management.\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint is deprecated and Google recommends using the Account Management API instead for creating accounts.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\n| Deprecated. Please use the [Account Management API](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts/create) instead.\nCreates an account with the specified name and type under the given parent.\n\n- Personal accounts and Organizations cannot be created.\n- User Groups cannot be created with a Personal account as primary owner.\n- Location Groups cannot be created with a primary owner of a Personal account if the Personal account is in an Organization.\n- Location Groups cannot own Location Groups.\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `primaryOwner` | `string` The resource name of the account which will be the primary owner of the account being created. It should be of the form `accounts/{accountId}/`. |\n\n### Request body\n\nThe request body contains an instance of [Account](/my-business/reference/rest/v4/accounts#Account).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Account](/my-business/reference/rest/v4/accounts#Account).\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)."]]
