تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.transfer
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نقل موقع من حساب يمتلكه المستخدم إلى حساب آخر يديره المستخدم نفسه. يجب أن يكون المستخدم مالكًا للحساب المرتبط به الموقع الجغرافي حاليًا، كما يجب أن يكون أيضًا مديرًا لحساب الوجهة على الأقل. تعرض الموقع باسم المورد الجديد.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:transfer
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
اسم الموقع الجغرافي الذي تريد نقله.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"toAccount": string
} |
| الحقول |
toAccount |
string
اسم مورد الحساب المطلوب نقل الموقع الجغرافي إليه (على سبيل المثال، "accounts/8675309").
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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 endpoint, now deprecated in favor of the Account Management API, enables transferring a location between accounts owned and administered by the same user.\u003c/p\u003e\n"],["\u003cp\u003eTo transfer, a POST request is made to the specified URL, including the location's name as a path parameter and the destination account name in the request body.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution results in a response containing the updated Location resource.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization necessitates the inclusion of specific OAuth scopes, such as \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"],["\u003cp\u003eUsers should transition to the designated Account Management API for location transfer functionality.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.locations.transfer\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- [Authorization Scopes](#body.aspect)\n\n| Deprecated. Please use the [Account Management API](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations/transfer) instead.\nMoves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account. Returns the Location with its new resource name.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:transfer`\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 location to transfer. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------|---|\n| ``` { \"toAccount\": string } ``` |\n\n| Fields ||\n|-------------|------------------------------------------------------------------------------------------------------|\n| `toAccount` | `string` Name of the account resource to transfer the location to (for example, \"accounts/8675309\"). |\n\n### Response body\n\nIf successful, the response body contains an 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)."]]
