API Báo cáo Search Ads 360 thực thi các giới hạn đối với các 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á
Mức giá tổng thể của Search Ads 360 đã bao gồm cả việc sử dụng Search Ads 360 Reporting API. Bạn không phải trả thêm phí khi sử dụng API.
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 Search hoặc SearchStream.
- 3.000 lượt truy vấn mỗi phút trên mỗi dự án cho 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 lượt truy vấn mỗi ngày trên mỗi dự án
Giới hạn số lượt 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 trên mỗi dự án Google Cloud.
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 truyền trực tuyến 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 ghi nhận:
| Yêu cầu API | Số thao tác được tính vào Hạn mức hằng ngày |
|---|---|
Toán tử: Search
Số lượng: 53 nhóm quảng cáo
Dịch vụ: |
1 |
Hoạt động: SearchStream
Số lượng: 45 chiến dịch
Dịch vụ: |
1 |
Các yêu cầu vi phạm các giới hạn này sẽ bị từ chối kèm theo 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ô.
Các hạn chế của gRPC
Tất cả thư viện ứng dụng của API Báo cáo Search Ads 360 đều sử dụng gRPC để tạo các 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.
Số lượng 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 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.
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 các thông báo và mã 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 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 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ẽ 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à 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 phần Phân trang qua kết quả.
Các yêu cầu trả về ngoại lệ API
Các yêu cầu bị từ chối bằng 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ư do lỗi ở cấp mạng, sẽ không 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ụ: lỗi kết nối mạng.
Các loại giới hạn 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 tương tự này cũng có thể là do các vấn đề khác.
Khi tạo truy vấn 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.