Để truy xuất các thực thể API Google Ads và dữ liệu báo cáo, bạn có thể sử dụng một trong các phương thức sau:
Dưới đây là những điểm khác biệt cấp cao cho hai phương pháp:
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 của các đố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 từ khoá được chỉ định trong truy vấn | Chỉ những từ khoá đượ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ác cấp truy cập | Giới hạn hằng ngày dựa trên các cấp truy cập |
SearchStream so với Tìm kiếm
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 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 bắt đầu tải xuống ngay lập tức, toàn bộ kết quả được lưu vào bộ nhớ đệm trong 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 vùng đệm mà không phải đợi toàn bộ luồng kết thúc.
Bằng cách loại bỏ thời gian mạng khứ hồi cần thiết để yêu cầu từng trang của phản hồi Search
, tuỳ thuộc vào ứng dụng, SearchStream
có thể cải thiện hiệu suất so với việc phân trang, đặc biệt là đối với các báo cáo lớn hơn.
Ví dụ:
Ví dụ: hãy tạo một báo cáo có chứa 100,000
hàng. Bảng sau đây phân tích sự khác biệt về cách tính toán giữa hai phương pháp.
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 liên tục | 10 câu trả lời |
Các yếu tố về 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 2 phương pháp.
Đối với nhiều báo cáo trang:
SearchStream
thường nhanh hơn vì nhiều lần khứ hồi sẽ bị tránh và việc đọc hoặc ghi từ bộ nhớ đệm trên ổ đĩa ít phụ thuộc vào việc đọc hoặc ghi.
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 này đều tuân thủ giới hạn tiêu chuẩn và cấp truy cập trong mã của nhà phát triển. Một truy vấn hoặc báo cáo đượ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.