Các thay đổi về định dạng trong API Báo cáo của Search Ads 360

Định dạng yêu cầu

Trong API Báo cáo Search Ads 360 mới, định dạng yêu cầu phụ thuộc vào loại yêu cầu mà bạn đưa ra. Trong API trước, bạn có thể yêu cầu một loại báo cáo được xác định trước bằng cách sử dụng yêu cầu đồng bộ hoặc không đồng bộ.

Trong API mới, bạn có thể tuỳ chỉnh kết quả tìm kiếm bằng cách xác định cụm từ tìm kiếm phù hợp với nhu cầu của mình. Ngôn ngữ truy vấn Search Ads 360 cho phép bạn tìm kiếm tất cả tài nguyên để tìm danh sách các thực thể khớp với một bộ tiêu chí cụ thể. Tất cả các yêu cầu, bất kể loại thực thể, đều được thực hiện đối với SearchAds360Service. Hãy xem bài viết Tạo báo cáo tìm kiếmNgôn ngữ truy vấn Search Ads 360 để tìm hiểu thêm.

Định dạng phản hồi

Trong API mới, các trường được điền trong phản hồi phụ thuộc vào dịch vụ bạn sử dụng:

SearchAds360Service
Phản hồi bao gồm một đối tượng SearchAds360Row cho mỗi thực thể khớp với các thông số tìm kiếm của bạn. Mỗi hàng chứa một đối tượng, chẳng hạn như một chiến dịch và chỉ bao gồm các trường mà bạn yêu cầu trong truy vấn.
Dịch vụ cụ thể
Mỗi lần, bạn chỉ có thể yêu cầu một thực thể theo tên tài nguyên. Phản hồi bao gồm tất cả trường cho thực thể đó.

Định dạng mã khách hàng

Trong API mới, bạn phải chỉ định Mã khách hàng là một số gồm 10 chữ số (XXXXXXXXXX) không có dấu gạch ngang.