Method: locations.searchkeywords.impressions.monthly.list

Trả về các từ khoá tìm kiếm dùng để tìm doanh nghiệp trong kết quả tìm kiếm hoặc bản đồ. Mỗi từ khoá tìm kiếm đi kèm với số lượt hiển thị được tổng hợp hằng tháng.

Yêu cầu mẫu: 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

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Vị trí mà chuỗi thời gian cần được tìm nạp. Định dạng: vị trí/{locationId}, trong đó locationId là mã nhận dạng trang thông tin không bị làm rối mã nguồn.

Tham số truy vấn

Tham số
monthlyRange

object (MonthlyRange)

Bắt buộc. Phạm vi tính theo tháng để tổng hợp số lượt hiển thị của từ khoá tìm kiếm.
pageSize

integer

Không bắt buộc. Số lượng kết quả đã yêu cầu. Kích thước trang mặc định là 100. Bạn có thể đặt kích thước trang tối đa là 100.
pageToken

string (bytes format)

Không bắt buộc. Mã thông báo cho biết kết quả được phân trang tiếp theo sẽ được trả về.

Chuỗi được mã hoá base64.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Đại diện cho nội dung phản hồi cho Monthly.list.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Trường
searchKeywordsCounts[]

object (SearchKeywordCount)

Các cụm từ tìm kiếm được dùng để tìm một doanh nghiệp.
nextPageToken

string (bytes format)

Mã thông báo cho biết kết quả được phân trang gần đây nhất được trả về. Các yêu cầu kế tiếp để chuyển đến "trang" tiếp theo có thể sử dụng URL này từ khoá. Mã này sẽ chỉ xuất hiện khi hệ thống trả về các kết quả khác.

Chuỗi được mã hoá base64.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

MonthlyRange

Phạm vi thời gian cho biết phạm vi một tháng (bao gồm cả hai).

Biểu diễn dưới dạng JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Trường
startMonth

object (Date)

Bắt buộc. Không phân biệt đối xử – Chỉ xem xét trường năm và tháng
endMonth

object (Date)

Bắt buộc. Không phân biệt đối xử – Chỉ xem xét trường năm và tháng

SearchKeywordCount

Đại diện cho một từ khoá tìm kiếm và giá trị của từ khoá đó.

Biểu diễn dưới dạng JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Trường
searchKeyword

string

Chuỗi viết thường mà người dùng đã nhập.
insightsValue

object (InsightsValue)

Một trong hai trường hợp sau: 1) Tổng số người dùng duy nhất đã sử dụng từ khoá trong một tháng, được tổng hợp cho mỗi tháng được yêu cầu. 2) Ngưỡng cho biết rằng giá trị thực tế thấp hơn ngưỡng này.

InsightsValue

Biểu thị một giá trị thông tin chi tiết.

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp InsightsValue. Biểu thị việc chỉ được có một trong các trường proto sau đây. InsightsValue chỉ có thể là một trong những trạng thái sau đây:
value

string (int64 format)

Biểu thị giá trị thực tế.
threshold

string (int64 format)

Thể hiện ngưỡng chứa giá trị thực tế.