Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
Method: accounts.locations.transfer
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將營業地點從使用者擁有的帳戶移至同一使用者管理的另一個帳戶。使用者必須是該營業地點目前所關聯帳戶的擁有者,且至少需是目標帳戶管理員。傳回位置及其新資源名稱。
HTTP 要求
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:transfer
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"toAccount": string
} |
欄位 |
toAccount |
string
要接收位置的帳戶資源名稱 (例如「accounts/8675309」)。
|
回應主體
如果成功,回應主體會包含 Location
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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)."]]