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