Method: locations.transfer
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将营业地点从用户拥有的账号中转移到同一用户管理的另一个账号。用户必须是营业地点当前关联的账号的所有者,并且必须至少是目标账号的管理员。
HTTP 请求
POST https://mybusinessaccountmanagement.googleapis.com/v1/{name=locations/*}:transfer
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
必需。要转移的营业地点的名称。locations/{locationId} 。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"destinationAccount": string
} |
字段 |
destinationAccount |
string
必需。要将营业地点转移到的账号资源的名称(例如“accounts/{account}”)。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/business.manage
如需了解详情,请参阅 OAuth 2.0 概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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)."]]