傳回在搜尋或 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 |
必要欄位。應擷取時間序列的位置。格式:locations/{locationId},其中 locationId 是未經模糊處理的商家資訊 ID。 |
查詢參數
參數 | |
---|---|
monthlyRange |
必要欄位。計算搜尋關鍵字曝光次數的匯總範圍 (以月為單位)。 |
pageSize |
選用設定。要求的結果數量。預設頁面大小為 100。頁面大小的上限為 100。 |
pageToken |
選用設定。符記,表示要傳回的下一個分頁結果。 Base64 編碼的字串。 |
要求主體
要求主體必須為空白。
回應主體
代表 monthly.list 的回應。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"searchKeywordsCounts": [
{
object ( |
欄位 | |
---|---|
searchKeywordsCounts[] |
用來尋找商家的搜尋字詞。 |
nextPageToken |
權杖,指出傳回的最後分頁結果。成功要求取得下一個「網頁」關鍵字時,即可使用這個參數。只有在系統傳回更多結果時,才會顯示這個項目。 Base64 編碼的字串。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。
MonthlyRange
時間範圍,表示月份範圍 (含首尾)。
JSON 表示法 |
---|
{ "startMonth": { object ( |
欄位 | |
---|---|
startMonth |
必要欄位。包括:只會考慮年份和月份的欄位 |
endMonth |
必要欄位。包括:只會考慮年份和月份的欄位 |
SearchKeywordCount
代表單一搜尋關鍵字及其值。
JSON 表示法 |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
欄位 | |
---|---|
searchKeyword |
使用者輸入的小寫字串。 |
insightsValue |
以下任一項:1) 當月使用關鍵字的不重複使用者總數 (每月匯總)。2) 用來表示實際值低於這個門檻的門檻。 |
InsightsValue
代表深入分析的價值。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 InsightsValue 。代表必須只存在下列其中一個 proto 欄位。InsightsValue 只能是下列其中一項: |
|
value |
代表實際值。 |
threshold |
代表實際值低於這個門檻的門檻。 |