Báo cáo nội dung phát trực tuyến bằng GoogleAdsService

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

Sau đây là những điểm khác biệt chung của hai phương thức này:

GoogleAdsService.SearchStream GoogleAdsService.Search
Phù hợp với mã phát hành công khai Có Có
Dịch vụ GoogleAdsService GoogleAdsService
Trường hợp Tìm nạp đối tượng và báo cáo Tìm nạp đối tượng và báo cáo
Phản hồi Luồng gồm GoogleAdsRow đối tượng Các trang gồm GoogleAdsRow đối tượng
Các trường của phản hồi Chỉ những tài khoản được chỉ định trong truy vấn Chỉ những tài khoản đượ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 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 một 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à toàn bộ kết quả sẽ được lưu vào bộ nhớ đệm trong một vùng đệm dữ liệu. Mã của bạn có thể bắt đầu đọc dữ liệu được lưu vào bộ nhớ đệm mà không cần phải đợi toàn bộ luồng hoàn tất.

Bằng cách loại bỏ thời gian khứ hồi 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 của bạn, SearchStream có thể mang lại hiệu suất cao hơn so với phân trang, đặc biệt là đối với các báo cáo lớn hơn.

Ví dụ:

Ví dụ này xem xét một báo cáo có 100,000 hàng. Bảng sau đây trình bày chi tiết sự khác biệt về kế toán giữa hai phương pháp này.

SearchStream Tìm kiếm
Kích thước trang Không áp dụng 10.000 hàng mỗi trang
Số lượng 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 luồng phát liên tục 10 câu trả lời

Các yếu tố ảnh hưởng đến hiệu suất

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

  • Đối với báo cáo một trang (dưới 10.000 hàng): Không có sự khác biệt đáng kể về hiệu suất giữa hai 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 chuyến khứ hồi và việc đọc hoặc ghi từ bộ nhớ đệm trên ổ đĩa ít ảnh hưởng hơn.

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

Hạn mức hằng ngày cho cả hai phương thức đều tuân theo hạn mức tiêu chuẩn và cấp truy cập của mã thông báo nhà phát triển. Một truy vấn hoặc báo cáo duy nhất đượ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.