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)

系統推薦的商家檔案帳戶提供的地點。每個項目都代表一個出現在地圖上的 GoogleLocation。地點會依據與商家檔案帳戶的關聯性遞減排序。
totalSize

integer

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

string

在分頁過程中，如果下一頁還有更多可擷取的位置，這個欄位會填入符記，以便在後續呼叫中擷取下一個頁面的位置。如果沒有其他要擷取的位置，這個欄位就不會出現在回應中。

授權範圍

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

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

詳情請參閱 OAuth 2.0 總覽。