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 sẽ phụ thuộc vào loại yêu cầu 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 cho 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ả các tài nguyên để biết danh sách các thực thể khớp với một bộ tiêu chí cụ thể. Tất cả yêu cầu, bất kể loại thực thể, đều được đưa ra dựa trên 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 sẵn trong phản hồi sẽ 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 tham số tìm kiếm của bạn. Mỗi hàng chứa một đối tượng (ví dụ: một chiến dịch) và chỉ bao gồm các trường bạn yêu cầu trong truy vấn của mình.
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ả cá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à số gồm 10 chữ số (XXXXXXXXXX) không có dấu gạch ngang.