Method: locations.searchkeywords.impressions.monthly.list

Trả về các từ khoá tìm kiếm được dùng để tìm một doanh nghiệp trong kết quả tìm kiếm hoặc bản đồ. Mỗi từ khóa tìm kiếm đi kèm với số lần 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

Các tham số
parent

string

Bắt buộc. Vị trí mà chuỗi thời gian sẽ được tìm nạp. Định dạng: locations/{locationId}, trong đó locationId là mã trang thông tin không bị xáo trộn.

Tham số truy vấn

Các tham số
monthlyRange

object (MonthlyRange)

Bắt buộc. Phạm vi tháng để tổng hợp số lượt hiển thị từ khoá cho quảng cáo trên mạng tìm kiếm.
pageSize

integer

Không bắt buộc. Số lượng kết quả được yêu cầu. Kích thước trang mặc định là 100. Bạn có thể đặt kích thước trang thành 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 phản hồi chomonthly.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
}
Các trường
searchKeywordsCounts[]

object (SearchKeywordCount)

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ó thể sử dụng tính năng này bằng cách thực hiện các yêu cầu tiếp theo để hiển thị "trang" từ khoá tiếp theo. Thông số này sẽ chỉ xuất hiện khi có nhiều kết quả cần trả về hơn.

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 Tổng quan về OAuth 2.0.

MonthlyRange

Phạm vi thời gian cho biết phạm vi tháng (bao gồm cả hai giá trị này).

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

object (Date)

Bắt buộc. Bao gồm – Chỉ xem xét trường năm và tháng
endMonth

object (Date)

Bắt buộc. Bao gồm – 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)
  }
}
Các trường
searchKeyword

string

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

object (InsightsValue)

Một trong hai cách sau: 1) Tổng số người dùng riêng biệ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 giá trị thực tế thấp hơn ngưỡng này.

InsightsValue

Đại diện cho 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.
}
Các trường
Trường nhóm InsightsValue. Biểu thị rằng chỉ 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)

Đại diện cho giá trị thực tế.
threshold

string (int64 format)

Thể hiện ngưỡng dưới mức mà giá trị thực tế giảm.