Google Ads Service mang đến nhiều công cụ mạnh mẽ để khai thác dữ liệu báo cáo và các thực thể quan trọng từ API Google Ads. Trong đó, hai phương thức phổ biến là GoogleAdsService.SearchStream và GoogleAdsService.Search. Tuy cả hai đều hỗ trợ việc truy xuất dữ liệu, nhưng mỗi phương thức lại có ưu và nhược điểm riêng. Bài viết này sẽ giúp bạn hiểu rõ sự khác biệt giữa hai phương thức, từ đó tối ưu hiệu suất khi làm việc với các báo cáo lớn hoặc yêu cầu thời gian thực.
Để truy xuất các thực thể và dữ liệu báo cáo từ Google Ads API, bạn có thể sử dụng một trong hai phương thức dưới đây:
- GoogleAdsService.SearchStream
- GoogleAdsService.Search
Dưới đây là so sánh chi tiết giữa hai phương thức này:
| Tiêu chí | GoogleAdsService.SearchStream | GoogleAdsService.Search |
|---|---|---|
| Phù hợp với mã sản xuất | Có | Có |
| Dịch vụ sử dụng | GoogleAdsService | GoogleAdsService |
| Ứng dụng chính | Truy vấn và truy xuất các đối tượng, báo cáo | Truy vấn và truy xuất các đối tượng, báo cáo |
| Phản hồi | Dạng luồng chứa các đối tượng GoogleAdsRow | Các trang chứa các đối tượng GoogleAdsRow |
| Trường dữ liệu phản hồi | Chỉ bao gồm các trường được chỉ định trong truy vấn | Chỉ bao gồm các trường được chỉ định trong truy vấn |
| Giới hạn hàng ngày | Dựa trên cấp độ truy cập của tài khoản | Dựa trên cấp độ truy cập của tài khoản |
So sánh giữa SearchStream và Search trong Google Ads API
Mặc dù phương thức Search có thể thực hiện nhiều yêu cầu được phân trang để tải toàn bộ dữ liệu báo cáo xuống, SearchStream lại tối ưu hơn bằng cách gửi một yêu cầu duy nhất và thiết lập 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 lớn đến đâu.
Với SearchStream, dữ liệu sẽ được truyền tải ngay lập tức dưới dạng các gói và được lưu trữ tạm thời trong bộ đệm dữ liệu. Điều này cho phép mã của bạn bắt đầu xử lý dữ liệu ngay khi có kết quả đầu tiên, mà không cần chờ toàn bộ quá trình tải về hoàn tất như ở Search.
Việc loại bỏ các vòng lặp yêu cầu qua mạng giúp SearchStream nâng cao hiệu suất xử lý, đặc biệt đối với các báo cáo có quy mô lớn. Phương thức này phù hợp với các ứng dụng cần truy xuất dữ liệu nhanh chóng và liên tục, giảm thiểu độ trễ so với việc phân trang dữ liệu truyền thống của Search.
Ví dụ
Hãy xem xét trường hợp tạo một báo cáo với 100.000 hàng dữ liệu. Phân tích dưới đây cho thấy sự khác biệt về cách xử lý giữa hai phương thức:
| Phương thức | SearchStream | Search |
|---|---|---|
| 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ố phản hồi API | 1 luồng liên tục | 10 phản hồi |
Yếu tố hiệu suất
- Báo cáo có quy mô nhỏ (dưới 10.000 hàng): Hiệu suất của
SearchStreamvàSearchgần như tương đương, do quy mô dữ liệu không tạo ra khác biệt đáng kể. - Báo cáo có quy mô lớn (nhiều trang):
SearchStreamthường vượt trội nhờ giảm thiểu số lượng yêu cầu qua mạng và tối ưu hóa quy trình đọc/ghi dữ liệu từ bộ nhớ đệm.
Giới hạn yêu cầu
Cả SearchStream và Search đều tuân thủ giới hạn hằng ngày dựa trên cấp độ truy cập của mã thông báo nhà phát triển. Mỗi truy vấn hoặc báo cáo, bất kể kích thước, sẽ được tính là một thao tác API duy nhất, không phụ thuộc vào cách kết quả được truyền tải (phân trang hay luồng trực tuyến).
Hiểu rõ cách hoạt động và ưu điểm của GoogleAdsService.SearchStream và Search là yếu tố quan trọng để bạn tối ưu hóa quy trình làm việc với Google Ads API. Tùy vào nhu cầu cụ thể như kích thước báo cáo, tốc độ xử lý hay hiệu quả tổng thể, việc lựa chọn đúng phương thức có thể cải thiện đáng kể hiệu suất và tiết kiệm thời gian. Hy vọng bài viết này đã cung cấp thông tin hữu ích giúp bạn làm chủ công cụ mạnh mẽ này trong hành trình quảng cáo trực tuyến.
