API Báo cáo Search Ads 360 dựa trên một nền tảng hiện đại và giới thiệu một số khái niệm mới. Những vấn đề này được mô tả trong các phần sau.
Tài nguyên
Đối tượng tài nguyên thay thế các loại báo cáo. Thay vì yêu cầu các loại báo cáo xác định trước, giờ đây, bạn có thể truy vấn tất cả tài nguyên bằng ngôn ngữ truy vấn mới giống như SQL. Hãy xem cấu trúc API Báo cáo Search Ads 360 để tìm hiểu thêm.
Báo cáo tìm kiếm
Google Tìm kiếm có dịch vụ riêng trong API mới. Dịch vụ Tìm kiếm thay thế dịch vụ Báo cáo cũ. Mọi truy vấn đều sẽ trải qua SearchAds360Service. Phương thức này cung cấp 2 phương thức (SearchStream và Search) để tìm kiếm cũng như truy xuất dữ liệu và chỉ số báo cáo. Cả hai phương thức tìm kiếm đều trả về tất cả đối tượng SearchAds360Row khớp với cụm từ tìm kiếm của bạn. Xem bài viết Tạo báo cáo tìm kiếm để biết thêm thông tin.
Siêu dữ liệu về tài nguyên
SearchAds360FieldService cho phép bạn tự động yêu cầu danh mục tài nguyên, trường tài nguyên, khoá phân đoạn và chỉ số có trong phương thức tìm kiếm SearchAds360Service. Xem phần Truy xuất siêu dữ liệu tài nguyên để tìm hiểu thêm.
Tên trường
API giới thiệu các tên trường lồng nhau được phân tách bằng ký hiệu dấu chấm. Ví dụ: campaign.id và ad_group.id. Bạn cũng có thể lồng thêm, ví dụ: ad_group.campaign.id. Hãy xem cấu trúc API Báo cáo Search Ads 360 để tìm hiểu thêm.
Báo cáo trong API Search Ads 360 cũ dựa trên các trường riêng biệt trên từng thực thể cho các khái niệm tương tự. Ví dụ: cả báo cáo campaign và adgroup đều có một trường campaignId riêng biệt.
Ngôn ngữ truy vấn
API này ra mắt Ngôn ngữ truy vấn Search Ads 360. Đây là một ngôn ngữ linh hoạt, giống như SQL, cho phép bạn xác định các truy vấn để truy xuất dữ liệu báo cáo cụ thể phù hợp nhất với hoạt động kinh doanh của mình. Hãy xem bài viết Ngôn ngữ truy vấn Search Ads 360 để tìm hiểu thêm.
Nhận yêu cầu
Trong API mới, tính năng tìm kiếm có dịch vụ riêng (SearchAds360Service), nhưng các yêu cầu GET vẫn tồn tại trên dịch vụ cụ thể của từng thực thể. Ví dụ: bạn có thể lấy thông tin về cột tuỳ chỉnh từ CustomColumnService. Hãy xem bài viết
Các thay đổi về định dạng trong API Báo cáo Search Ads 360 để tìm hiểu thêm.
Cột tùy chỉnh
Trong Search Ads 360 mới, cột công thức và lượt chuyển đổi tuỳ chỉnh được gọi là
cột tuỳ chỉnh. Tìm hiểu thêm về cột tuỳ chỉnh. CustomColumnService mới bật các cột tuỳ chỉnh. Miễn là có các quyền cần thiết, bạn có thể yêu cầu các tài nguyên CustomColumn thuộc sở hữu của bất kỳ tài khoản nào trong cây tài khoản.
Quản lý tài khoản
Search Ads 360 mới sắp xếp các tài khoản vào một hệ thống phân cấp gồm tài khoản người quản lý, tài khoản người quản lý phụ và tài khoản khách hàng. Tài khoản người quản lý là tài khoản đại lý, còn tài khoản người quản lý phụ là tài khoản nhà quảng cáo trong Search Ads 360 cũ. Hãy xem bài viết Giới thiệu về tài khoản người quản lý Search Ads 360 để tìm hiểu thêm.
Bạn có thể truy vấn cây tài khoản rồi gửi yêu cầu cho từng tài khoản mà bạn muốn gửi dữ liệu báo cáo.
Do thay đổi trong hệ thống phân cấp tài khoản, các trường liên quan đến khái niệm nhà quảng cáo/đại lý đã được thay thế bằng các lựa chọn thay thế thích hợp để cung cấp chức năng tương đương về mặt chức năng khi có thể. Vui lòng xem phần Liên kết trường để biết danh sách các trường bị ảnh hưởng và trường thay thế.
Tiêu đề mã khách hàng đăng nhập
login-customer-id là một tiêu đề mới bắt buộc phải có khi sử dụng tài khoản người quản lý để truy cập vào tài khoản khách hàng hoặc người quản lý phụ. Xem Tiêu đề Mã khách hàng đăng nhập để biết thêm thông tin.
Lập phiên bản
API Báo cáo Search Ads 360 sử dụng cách tạo phiên bản ngữ nghĩa.
Có các phiên bản lớn và nhỏ, có định dạng là vMAJOR_MINOR. Xem phần Tạo phiên bản để tìm hiểu thêm.