Method: locations.searchkeywords.impressions.monthly.list

傳回在搜尋或 Google 地圖中尋找商家時使用的搜尋關鍵字。每個搜尋關鍵字都會與曝光次數 (每月匯總一次)。

要求範例：GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3

HTTP 要求

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

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

路徑參數

參數
parent

string

必要欄位。應擷取時間序列的位置。格式：locations/{locationId}，其中 locationId 是未經模糊處理的商家資訊 ID。

查詢參數

參數
monthlyRange

object (MonthlyRange)

必要欄位。計算搜尋關鍵字曝光次數的匯總範圍 (以月為單位)。
pageSize

integer

選用設定。要求的結果數量。預設頁面大小為 100。頁面大小的上限為 100。
pageToken

string (bytes format)

選用設定。符記，表示要傳回的下一個分頁結果。

Base64 編碼的字串。

要求主體

要求主體必須為空白。

回應主體

代表 monthly.list 的回應。

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

JSON 表示法 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
欄位
searchKeywordsCounts[]

object (SearchKeywordCount)

用來尋找商家的搜尋字詞。
nextPageToken

string (bytes format)

權杖，指出傳回的最後分頁結果。成功要求取得下一個「網頁」關鍵字時，即可使用這個參數。只有在系統傳回更多結果時，才會顯示這個項目。

Base64 編碼的字串。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

MonthlyRange

時間範圍，表示月份範圍 (含首尾)。

JSON 表示法 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
欄位
startMonth

object (Date)

必要欄位。包括：只會考慮年份和月份的欄位
endMonth

object (Date)

必要欄位。包括：只會考慮年份和月份的欄位

SearchKeywordCount

代表單一搜尋關鍵字及其值。

JSON 表示法 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
欄位
searchKeyword

string

使用者輸入的小寫字串。
insightsValue

object (InsightsValue)

以下任一項：1) 當月使用關鍵字的不重複使用者總數 (每月匯總)。2) 用來表示實際值低於這個門檻的門檻。

InsightsValue

代表深入分析的價值。

JSON 表示法 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
欄位
聯集欄位 InsightsValue。代表必須只存在下列其中一個 proto 欄位。InsightsValue 只能是下列其中一項：
value

string (int64 format)

代表實際值。
threshold

string (int64 format)

代表實際值低於這個門檻的門檻。