Method: accounts.listRecommendGoogleLocations

列出對指定商家檔案帳戶建議的所有GoogleLocation。系統只會針對個人帳戶和地區群組提供最佳化建議，所有其他帳戶類型的要求會產生錯誤。地區群組的最佳化建議是依據該群組中的地點。

個人帳戶的最佳化建議是依據使用者在商家檔案中可存取的所有地點 (包括可透過營業地點群組存取的地點) 產生，並是系統為使用者產生的所有最佳化建議的超集。

HTTP 要求

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

要擷取建議的 Google 位置的帳戶資源名稱。

查詢參數

參數
pageSize

integer

每頁要擷取的位置數量。預設值為 25，下限為 1，頁面大小上限為 100。
pageToken

string

如果指定，系統會擷取下一頁的位置。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

GoogleLocations.ListRecommendedGoogleLocations 的回應訊息。

也包含自上次系統向這個商家檔案帳戶建議後，其他商家檔案使用者聲明擁有權的地點。

JSON 表示法 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
欄位
googleLocations[]

object (GoogleLocation)

建議商家檔案帳戶的地點。每個項目都代表 Google 地圖上顯示的 GoogleLocation。地點會按照與商家檔案帳戶的關聯性遞減排序。
totalSize

integer

這個商家檔案帳戶的建議地點總數 (不受分頁影響)。
nextPageToken

string

在分頁期間，如果下一頁中還有更多可擷取的位置，系統會在此欄位填入一個符記，以便在後續呼叫中擷取下一頁的位置。如果沒有其他可擷取的地點，回應中就不會出現這個欄位。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

詳情請參閱 OAuth 2.0 總覽。