Tìm kiếm & SearchStream

API Báo cáo Search Ads 360 có tính năng báo cáo chỉ số và truy xuất thuộc tính hợp nhất cơ chế cho phép bạn tạo truy vấn bằng cách sử dụng Truy vấn Search Ads 360 Ngôn ngữ. Đ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ài khoản Search Ads 360 cá nhân.

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ác truy vấn giống nhau và trả về kết quả tương đương. Chiến lược phát hành đĩa đơn Phương thức Search trả về dữ liệu ở các kích thước trang có thể tùy chỉnh, cho phép bạn lặp lại trên tập hợp kết quả bằng cách sử dụng tính năng phân trang. Điều này có thể thuận lợi trong điều kiện băng thông thấp hoặc điều kiện mạng 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 mất kết nối. Chiến lược phát hành đĩa đơn Mặt khác, phương thức SearchStream truyền trực tuyến toàn bộ kết quả được đặt lại trong một phản hồi duy nhất, có thể mang lại hiệu quả cao hơn cho việc 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ử dụng 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 có nhiều hàng trong kết quả hơn pageSize, nextPageToken sẽ là được trả về trong phản hồi:

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

Lặp lại truy vấn tương tự có thêm pageToken với giá trị ở trên khi 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, phương thức này sẽ trả về tất cả kết quả trong một lần truyền trực tuyến thì bạn chỉ cần thay đổi phương thức dịch vụ trong URL thành searchStream (SearchStream không yêu cầu pageSize và pageToken):

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'"
}