Search Analytics

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Không có dữ liệu cố định nào liên kết với tài nguyên này.

Phương thức

cụm từ tìm kiếm

Truy vấn dữ liệu lưu lượng truy cập tìm kiếm bằng bộ lọc và thông số mà bạn xác định. Phương thức này trả về 0 hoặc nhiều hàng được nhóm theo các khoá hàng (phương diện) mà bạn xác định. Bạn phải xác định phạm vi ngày gồm một hoặc nhiều ngày.

Khi ngày là một trong các phương diện, thì bất kỳ ngày nào không có dữ liệu sẽ bị loại khỏi danh sách kết quả. Để tìm hiểu ngày nào có dữ liệu, hãy đưa ra truy vấn mà không dùng bộ lọc được nhóm theo ngày, cho phạm vi ngày mà bạn quan tâm.

Kết quả được sắp xếp theo số lượt nhấp giảm dần. Nếu 2 hàng có cùng số lượt nhấp, chúng sẽ được sắp xếp theo cách tuỳ ý.

Hãy xem mẫu python để gọi phương thức này.

API này bị hạn chế bởi các giới hạn nội bộ của Search Console và không đảm bảo sẽ trả về tất cả hàng dữ liệu mà là hàng hàng đầu.

Xem giới hạn về lượng dữ liệu có sẵn.

Ví dụ về POST cho JSON:

POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}