Method: accounts.locations.transfer
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Di chuyển vị trí từ tài khoản mà người dùng sở hữu sang một tài khoản khác mà người dùng đó quản lý. Người dùng phải là chủ sở hữu của tài khoản mà vị trí đó hiện đang được liên kết và ít nhất cũng phải là người quản lý của tài khoản đích. Trả về Vị trí cùng với tên tài nguyên mới.
Yêu cầu HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:transfer
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
name |
string
Tên của vị trí cần chuyển.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"toAccount": string
} |
| Trường |
toAccount |
string
Tên của tài nguyên tài khoản để chuyển vị trí sang (ví dụ: "accounts/8675309").
|
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Location.
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
