Method: locations.searchkeywords.impressions.monthly.list

傳回在搜尋或地圖中用來尋找商家的搜尋關鍵字。每個搜尋關鍵字旁邊會顯示每月匯總的曝光次數。

要求範例：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)

代表實際值低於門檻。