Để truy xuất các thực thể và dữ liệu báo cáo của Google Ads API, hãy sử dụng một trong các 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ã sản xuất | 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 đối tượng GoogleAdsRow |
Các trang đối tượng GoogleAdsRow |
| Trường của phản hồi | Chỉ những trường được chỉ định trong truy vấn | Chỉ những trường đượ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 |
SearchStream so với Search
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 Google Ads API 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ộ đệm dữ liệu. Mã của bạn có thể bắt đầu đọc dữ liệu được lưu vào bộ đệ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 mạng trao đổi cần thiết để yêu cầu từng trang riêng lẻ
của 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 gồm 100,000 hàng. Bảng sau đây trình bày chi tiết các điểm khác biệt về kế toán giữa hai phương thức.
| SearchStream | Search | |
|---|---|---|
| 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 API | 1 luồng liên tục | 10 câu trả lời |
Các 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 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:
SearchStreamthường nhanh hơn vì tránh được nhiều lượt trao đổi và việc đọc hoặc ghi từ bộ nhớ đệm của ổ đĩa ít ảnh hưởng hơn.
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ủ các giới hạn và cấp truy cập tiêu chuẩn của mã của 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 phát trực tuyến.