Báo cáo việc phát trực tuyến bằng GoogleAdsService

Để truy xuất các thực thể và dữ liệu báo cáo của API Google Ads, bạn có thể sử dụng một trong các phương thức sau:

Sau đây là điểm khác biệt lớn của hai phương pháp:

GoogleAdsService.SearchStream GoogleAdsService.Search
Phù hợp với mã sản xuất Có Có
Dịch vụ GoogleAdsService GoogleAdsService
Trường hợp Đang tìm nạp các đối tượng và báo cáo Đang tìm nạp các đối tượng và báo cáo
Phản hồi Luồng đối tượng GoogleAdsRow Các trang của đối tượng GoogleAdsRow
Các trường của phản hồi Chỉ những người được chỉ định trong truy vấn Chỉ những người được chỉ định trong truy vấn
Giới hạn hằng ngày Giới hạn hằng ngày dựa trên cấp truy cập Giới hạn hằng ngày dựa trên cấp truy cập

Mặc dù Search có thể gửi nhiều yêu cầu được phân trang để tải toàn bộ báo cáo xuống, nhưng SearchStream sẽ gửi một yêu cầu duy nhất và bắt đầu kết nối liên tục với API Google Ads bất kể kích thước báo cáo.

Đối với SearchStream, các gói dữ liệu sẽ bắt đầu tải xuống ngay lập tức với toàn bộ kết quả được lưu vào bộ nhớ đệm trong bộ đệm dữ liệu. Mã của bạn có thể bắt đầu đọc dữ liệu lưu vào vùng đệm mà không cần phải đợi toàn bộ luồng kết thúc.

Bằng cách loại bỏ thời gian mạng trọn vòng cần thiết để yêu cầu từng trang riêng lẻ của một phản hồi Search, tuỳ thuộc vào ứng dụng, SearchStream có thể mang lại hiệu suất tốt hơn so với tính năng phân trang, đặc biệt đối với các báo cáo có kích thước lớn hơn.

Ví dụ:

Ví dụ: hãy tạo một báo cáo bao gồm 100,000 hàng. Bảng sau đây phân tích sự khác biệt về cách tính giữa 2 phương thức.

SearchStream Tìm kiếm
Kích thước trang Không áp dụng 10.000 hàng mỗi trang
Số yêu cầu API 1 yêu cầu 10 yêu cầu
Số lượng phản hồi của API 1 lượt phát liên tục 10 phản hồi

Yếu tố hiệu suất

Đối với hầu hết các trường hợp sử dụng, bạn nên sử dụng SearchStream thay vì Search vì những lý do sau:

  • Đối với các báo cáo trang đơn (dưới 10.000 hàng): Không có sự khác biệt đáng kể về hiệu suất giữa 2 phương thức.

  • Đối với báo cáo nhiều trang: SearchStream thường nhanh hơn vì tránh được nhiều lượt trọn vòng, đồng thời việc đọc hoặc ghi từ bộ nhớ đệm của ổ đĩa không phải là yếu tố quan trọng.

Giới hạn số lượng yêu cầu

Giới hạn hằng ngày cho cả hai phương thức đều tuân thủ giới hạn tiêu chuẩn và cấp truy cập của mã thông báo của nhà phát triển. Một truy vấn hoặc báo cáo duy nhất sẽ được tính là một thao tác, bất kể kết quả được phân trang hay truyền trực tuyến.