Search Ads 360 Reporting API áp dụng các giới hạn đối với hoạt động 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 Search Ads 360 Reporting API nằm trong mức 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 đây áp dụng cho các thao tác truy vấn được thực hiện thông qua phương thức Tìm kiếm hoặc SearchStream.
- 3.000 lượt truy vấn mỗi phút trên mỗi dự án trên mỗi người dùng
- 3.000 lượt truy vấn mỗi phút trên mỗi dự án
- 150.000 truy vấn mỗi ngày cho mỗi dự án
Hạn mức thao tác API hằng ngày
Giới hạn sử dụng API hằng ngày dựa trên số lượng thao tác API được thực hiện cho mỗi dự án Google Cloud.
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 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 đưa ra một số ví dụ về việc hạch toán:
| Yêu cầu API | Các thao tác đượ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ụ: SearchAds360Service
|
1 |
Thao tác: SearchStream
Số lượng: 45 chiến dịch Dịch vụ: SearchAds360Service
|
1 |
Những yêu cầu vi phạm các giới hạn này sẽ bị từ chối và báo lỗi: RESOURCE_EXHAUSTED.
Yêu cầu tìm kiếm
Yêu cầu Search hoặc SearchStream được tính là một thao tác trong hạn mức thao tác hằng ngày của người dùng. Một yêu cầu SearchStream được tính là một thao tác API, bất kể số lượng lô.
Giới hạn của gRPC
Tất cả thư viện ứng dụng Search Ads 360 Reporting API đều sử 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ác 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 bao gồm 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 đã chọn, giảm kích thước trang hoặc sử dụng tính năng truyền trực tuyến.
Những yêu cầu vi phạm giới hạn này sẽ không tạo ra SearchAds360Error mà sẽ tạo ra lỗi 429 Resource Exhausted gRPC. Tham khảo danh sách mã và thông báo lỗi gRPC.
Yêu cầu phân trang
Các yêu cầu được phân trang (ví dụ: các yêu cầu chứa một next_page_token hợp lệ) không được tính vào hạn mức thao tác hằng ngày của người dùng.
Tuy nhiên, các yêu cầu phân trang 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 ngoại lệ và sẽ được tính vào hạn mức thao tác hằng ngày.
Những 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, kèm theo lỗi: INVALID_PAGE_SIZE.
Để biết thêm thông tin về việc phân trang, hãy tham khảo phần Phân trang qua kết quả.
Các yêu cầu trả về ngoại lệ API
Những yêu cầu bị từ chối bằng SearchAds360Failure vẫn được tính vào hạn mức thao tác hằng ngày của người dùng.
Những yêu cầu không thành công nhưng không trả về SearchAds360Failure, chẳng hạn như do 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ờ đến được dịch vụ. Ví dụ về trường hợp này là lỗi kết nối mạng.
Các loại hạn mức khác
Một trường lặp lại (chẳng hạn như danh sách các 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 này cũng có thể do các vấn đề khác gây ra.
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ột mệnh đề IN là 20.000. Nếu vượt quá giới hạn đó, một lỗi FILTER_HAS_TOO_MANY_VALUES sẽ được trả về.