Method: accounts.locations.associate
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将营业地点与地点 ID 相关联。之前的所有关联都会被覆盖。仅当营业地点未经验证时,此操作才有效。关联必须有效,即显示在 locations.findMatches
列表中。
HTTP 请求
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:associate
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
要关联的营业地点的资源名称。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"placeId": string
} |
字段 |
placeId |
string
要建立的关联。如果未设置,则表示不匹配。
|
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/plus.business.manage
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\u003eThis operation associates a location to a place ID, overwriting any previous association, but is only valid for unverified locations and must be a valid match.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a POST method and gRPC Transcoding syntax, requiring the location's resource name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body uses JSON to specify the desired place ID for association or indicates no match if not set.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful association, the response body is empty, signaling completion.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes, either \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"]]],[],null,["# Method: accounts.locations.associate\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\nAssociates a location to a place ID. Any previous association is overwritten. This operation is only valid if the location is unverified. The association must be valid, that is, it appears in the list of `locations.findMatches`.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:associate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------|\n| `name` | `string` The resource name of the location to associate. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------|---|\n| ``` { \"placeId\": string } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------|\n| `placeId` | `string` The association to establish. If not set, it indicates no match. |\n\n### Response body\n\nIf successful, the response body is empty.\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)."]]