Tìm kiếm & SearchStream

Video: Báo cáo

API Google Ads 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 Google Ads 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 Google Ads 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 trong các trang có kích thước cố định gồm 10.000 hàng, cho phép bạn để lặp lại 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 băng thông hoặc điều kiện mạng không đáng tin cậy, ví dụ: để phân đoạn một kết quả được đặt thành các phản hồi nhỏ hơn có thể được tìm nạp lại nếu kết nối thua. Mặt khác, phương thức SearchStream truyền trực tuyến toàn bộ kết quả đặt lại trong một phản hồi duy nhất. Điều này có thể hiệu quả hơn đối với dữ liệu hàng loạt truy xuất.

Cả SearchSearchStream đều sử dụng cùng một URL cơ sở:

    https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}

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

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

Lặp lại cùng một truy vấn với pageToken được thêm vào cùng với các giá trị từ yêu cầu trước đó tìm nạp trang kết quả tiếp theo:

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'",
"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 hãy thay đổi phương thức dịch vụ trong URL thành searchStream (SearchStream không yêu cầu pageSizepageToken):

POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}