Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
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 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間: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)."]]