API Báo cáo Search Ads 360 thực thi các giới hạn đối với 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ũng được bao gồm trong giá chung của Search Ads 360. 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 á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 truy vấn mỗi phút trên mỗi dự án trên mỗi người dùng
- 3.000 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 hoạt động API hằng ngày
Hạn mức sử dụng API hằng ngày được xác định dựa trên số lượng thao tác API được thực hiện trong 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ả đ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ề việc kế toán:
| Yêu cầu API | Số hoạt động được tính vào Giới hạn hằng ngày |
|---|---|
Hoạt động: 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 |
Những 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 vào hạn mức thao tác 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 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 yêu cầu và phản hồi. Theo mặc định, gRPC có kích thước thư 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 mà sẽ gây 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 được phân trang
Những yêu cầu được phân trang (ví dụ: những 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 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 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 của 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 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ệ đối với 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.
Những yêu cầu không thành công nhưng không trả về SearchAds360Failure, chẳng hạn như từ mộ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ờ đến được dịch vụ. Ví dụ: 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 tương tự này cũng có thể là do các vấn đề khác.
Khi thực hiện 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.