- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- MonthlyRange (Phạm vi hàng tháng)
- SearchKeywordCount (Số từ khoá tìm kiếm)
- InsightsValue
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 |
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 |
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 |
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 |
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 ( |
Các trường | |
---|---|
searchKeywordsCounts[] |
Cụm từ tìm kiếm được dùng để tìm một doanh nghiệp. |
nextPageToken |
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 ( |
Các trường | |
---|---|
startMonth |
Bắt buộc. Bao gồm – Chỉ xem xét trường năm và tháng |
endMonth |
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 ( |
Các trường | |
---|---|
searchKeyword |
Chuỗi viết thường mà người dùng đã nhập. |
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 |
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 |
Đại diện cho giá trị thực tế. |
threshold |
Thể hiện ngưỡng dưới mức mà giá trị thực tế giảm. |