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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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)."]]
