API Báo cáo Search Ads 360 thực thi các giới hạn về hoạt động của API để đảm bảo hiệu suất hệ thống tối ưu cho tất cả người dùng.
Giá
Việc sử dụng API Báo cáo Search Ads 360 được tính vào giá tổng thể của Search Ads 360. Bạn không phải trả thêm phí khi sử dụng API này.
Giới hạn truy vấn
Các giới hạn sau áp dụng cho các hoạt động truy vấn được thực hiện thông qua phương thức Search hoặc SearchStream.
- 3.000 truy vấn mỗi phút trên mỗi dự án/người dùng
- 3.000 truy vấn mỗi phút cho mỗi dự án
- 150.000 truy vấn mỗi ngày cho mỗi dự án
Giới hạn hoạt động hằng ngày của API
Hạn mức sử dụng API hằng ngày dựa trên số lượng thao tác API được thực hiện trong mỗi dự án Google Cloud.
Mỗi truy vấn hoặc báo cáo được tính là một thao tác, bất kể kết quả đang được truyền trực tuyến thông qua SearchAds360Service.SearchStream hay được phân trang từ lệnh gọi SearchAds360Service.Search.
Tìm hiểu thêm.
Bảng sau đây cung cấp một số ví dụ về cách tính:
| Yêu cầu API | Hoạt động được tính vào Giới hạn hàng ngày |
|---|---|
Thao tác: Search
Số lượng: 53 nhóm quảng cáo
Dịch vụ: |
1 |
Thao tác: SearchStream
Số lượng: 45 chiến dịch
Dịch vụ: |
1 |
Hệ thống sẽ từ chối những yêu cầu vi phạm các giới hạn này với lỗi:
RESOURCE_EXHAUSTED.
Tìm kiếm yêu cầu
Yêu cầu Search hoặc SearchStream được tính là một thao tác so với hạn mức hoạt động hằng ngày của người dùng. Một yêu cầu SearchStream sẽ được tính là một thao tác API, bất kể số lượng lô.
Các giới hạn của gRPC
Tất cả thư viện ứng dụng của API Báo cáo Search Ads 360 đều dùng gRPC để tạo yêu cầu và phản hồi. Theo mặc định, gRPC có kích thước thông báo là 4 MB.
Câu trả lời không được vượt quá giới hạn này. Ví dụ: một yêu cầu tìm kiếm có nhiều trường có thể tạo ra một phản hồi có kích thước vượt quá 4 MB. Để tránh giới hạn này, bạn có thể giảm số lượng trường được chọn, giảm kích thước trang hoặc sử dụng tính năng phát trực tuyến.
Các yêu cầu vi phạm giới hạn này sẽ không tạo ra SearchAds360Error, nhưng sẽ tạo ra lỗi gRPC 429 Resource Exhausted. Tham khảo danh sách mã lỗi và thông báo gRPC.
Yêu cầu được phân trang
Các yêu cầu được phân trang (ví dụ: các yêu cầu chứa next_page_token hợp lệ) không được tính vào hạn mức hoạt động hằng ngày của người dùng.
Tuy nhiên, các yêu cầu phân trang có chứa mã thông báo trang đã hết hạn hoặc không hợp lệ sẽ tạo ra một trường hợp ngoại lệ và sẽ được tính vào hạn mức hoạt động hằng ngày.
Các yêu cầu được phân trang (chẳng hạn như yêu cầu tìm kiếm) cũng phải tuân theo giới hạn Page size cannot exceed 10,000 rows và sẽ bị từ chối nếu vi phạm giới hạn này với lỗi: INVALID_PAGE_SIZE.
Để biết thêm thông tin chi tiết về tính năng phân trang, hãy tham khảo bài viết Phân trang thông qua kết quả.
Yêu cầu trả về ngoại lệ API
Các yêu cầu bị từ chối có SearchAds360Failure vẫn được tính vào hạn mức hoạt động hằng ngày của người dùng.
Các yêu cầu không thành công nhưng không trả về SearchAds360Failure, chẳng hạn như từ lỗi ở cấp mạng, sẽ không được tính vào hạn mức hoạt động hằng ngày của người dùng vì các yêu cầu đó sẽ không bao giờ đạt đến dịch vụ. Ví dụ như lỗi kết nối mạng.
Các loại giới hạn khác
Trường lặp lại, chẳng hạn như danh sách thao tác, có quá nhiều mục trong một yêu cầu có thể gây ra lỗi: REQUEST_SIZE_LIMIT_EXCEEDED.
Thông báo lỗi tương tự này cũng có thể do các vấn đề khác.
Khi thực hiện một truy vấn bằng Ngôn ngữ truy vấn Search Ads 360, số lượng mục tối đa trong mệnh đề IN là 20.000. Nếu bạn vượt quá giới hạn đó, hệ thống sẽ trả về lỗi FILTER_HAS_TOO_MANY_VALUES.