تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.transfer
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نقل موقع من حساب يمتلكه المستخدم إلى حساب آخر يديره المستخدم نفسه. يجب أن يكون المستخدم مالكًا للحساب المرتبط به الموقع الجغرافي حاليًا، كما يجب أن يكون أيضًا مديرًا لحساب الوجهة على الأقل.
طلب HTTP
POST https://mybusinessaccountmanagement.googleapis.com/v1/{name=locations/*}:transfer
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم الموقع الجغرافي الذي تريد نقله. locations/{locationId}.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"destinationAccount": string
} |
| الحقول |
destinationAccount |
string
مطلوب. اسم مورد الحساب المطلوب نقل الموقع الجغرافي إليه (على سبيل المثال، "accounts/{account}").
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://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\u003eTransfers a location between two accounts owned/managed by the same user, requiring ownership of the origin account and at least manager status on the destination account.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes an HTTP POST request to \u003ccode\u003ehttps://mybusinessaccountmanagement.googleapis.com/v1/{name=locations/*}:transfer\u003c/code\u003e, specifying the location with \u003ccode\u003e{locationId}\u003c/code\u003e in the path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain the \u003ccode\u003edestinationAccount\u003c/code\u003e field, indicating the target account's name in the format \u003ccode\u003e"accounts/{account}"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful transfer, the response body will be empty, confirming the location's move.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: 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\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.\n\n### HTTP request\n\n`POST https://mybusinessaccountmanagement.googleapis.com/v1/{name=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` Required. The name of the location to transfer. `locations/{locationId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------|\n| ``` { \"destinationAccount\": string } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------|\n| `destinationAccount` | `string` Required. Name of the account resource to transfer the location to (for example, \"accounts/{account}\"). |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\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)."]]
