Tìm kiếm & SearchStream

API Báo cáo Search Ads 360 có một cơ chế truy xuất thuộc tính và báo cáo chỉ số thống nhất cho phép bạn tạo truy vấn bằng Ngôn ngữ truy vấn Search Ads 360. Điều này cho phép các truy vấn phức tạp có thể trả về một lượng lớn dữ liệu về từng tài khoản Search Ads 360.

Bạn có thể tạo truy vấn bằng một trong hai phương thức Search hoặc SearchStream. Cả hai phương thức đều hỗ trợ cùng một truy vấn và trả về kết quả tương đương. Phương thức Search trả về dữ liệu ở kích thước trang có thể tuỳ chỉnh, cho phép bạn lặp lại tập hợp kết quả bằng cách phân trang. Điều này có thể có lợi trong các điều kiện mạng có băng thông thấp hoặc không đáng tin cậy, ví dụ: để phân đoạn một tập hợp kết quả lớn thành các phản hồi nhỏ hơn có thể được tìm nạp lại nếu bị mất kết nối. Mặt khác, phương thức SearchStream sẽ truyền trực tuyến toàn bộ tập hợp kết quả trở lại trong một phản hồi duy nhất. Điều này có thể hiệu quả hơn khi truy xuất dữ liệu hàng loạt.

Cả Search và SearchStream đều sử dụng cùng một URL cơ sở:

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

Phương thức tìm kiếm dựa trên trang sẽ lấy một tham số pageSize không bắt buộc để giới hạn số lượng kết quả được trả về trong một phản hồi API.

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

Nếu kết quả có nhiều hàng hơn pageSize, thì nextPageToken sẽ được trả về trong phản hồi:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

Việc lặp lại cùng một truy vấn với pageToken được thêm vào giá trị ở trên sẽ tìm nạp trang kết quả tiếp theo:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

Để sử dụng phương thức SearchStream (trả về tất cả kết quả trong một phản hồi truyền trực tuyến), bạn chỉ cần thay đổi phương thức dịch vụ trong URL thành searchStream (pageSize và pageToken không bắt buộc đối với SearchStream):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}