Hạn mức sử dụng

Giới hạn sử dụng giúp bảo vệ cơ sở hạ tầng của Google khỏi các quy trình tự động sử dụng API Display & Video 360 theo cách không phù hợp. Các quy tắc này đảm bảo rằng hành động của một nhà phát triển không thể ảnh hưởng tiêu cực đến cộng đồng lớn hơn.

Giới hạn hạn mức yêu cầu API

API Display & Video 360 sử dụng hai loại giới hạn:

  • Tổng hạn mức hạn mức, trong đó tất cả các yêu cầu có liên quan đều được tính vào.
  • Giới hạn hạn mức ghi, trong đó tất cả các yêu cầu liên quan được thực hiện để ghi phương thức đều được tính vào. Phương thức ghi được xác định là các phương thức (chẳng hạn như create, patch, delete hoặc bulkEdit) sửa đổi tài nguyên. Xin lưu ý rằng một số phương thức tiêu thụ nhiều hạn mức ghi hơn so với các phương thức khác.

Nếu dự án của bạn vượt quá bất kỳ giới hạn nào trong số này, quá trình điều tiết có thể xảy ra.

Hạn mức hạn mức trên toàn dự án

Tất cả tài nguyên và phương thức API Display & Video 360 đều dùng chung các hạn mức hạn mức mặc định sau:

  • Tổng số yêu cầu mỗi phút trên mỗi dự án: 1500
  • Số yêu cầu ghi mỗi phút trên mỗi dự án: 700

Hạn mức hạn mức yêu cầu dành riêng cho nhà quảng cáo

Các phương thức chỉ định mã nhận dạng nhà quảng cáo trong URL yêu cầu sẽ được tính vào giới hạn hạn mức "trên mỗi nhà quảng cáo trên mỗi dự án".

Tất cả các yêu cầu có mã nhận dạng nhà quảng cáo được chỉ định trong đường dẫn URL (chẳng hạn như các yêu cầu đến dịch vụ advertisers.lineItems, advertisers.creatives hoặc advertisers.channels) sẽ được tính vào hạn mức hạn mức sau:

  • Tổng số yêu cầu mỗi phút trên mỗi nhà quảng cáo trên mỗi dự án: 300
  • Số yêu cầu ghi mỗi phút trên mỗi nhà quảng cáo trên mỗi dự án: 150

Các phương thức ghi dữ liệu nhiều

Các phương thức API sau đây có cường độ ghi cao, nghĩa là các phương thức này sử dụng một lượng lớn tài nguyên sản phẩm và do đó, tiêu thụ nhiều hạn mức yêu cầu ghi hơn so với các yêu cầu ghi khác.

Các yêu cầu được thực hiện cho các phương thức ghi dữ liệu nhiều sẽ được tính là 5 truy vấn ghi khi tính mức sử dụng hạn mức yêu cầu ghi. Ví dụ: 100 yêu cầu ghi tiêu chuẩn và 21 yêu cầu ghi chuyên sâu (không có yêu cầu nào chỉ định nhà quảng cáo) được thực hiện trong một phút sẽ được tính là 205 truy vấn ghi (100 + (21 * 5) = 205) và sẽ vượt quá hạn mức yêu cầu chung hiện tại là 200 truy vấn ghi mỗi phút.

Các phương thức sau đây được coi là phương thức ghi nhiều:

Vượt quá hạn mức

Trong trường hợp hiếm gặp yêu cầu của bạn không thành công do vượt quá giới hạn yêu cầu API, API sẽ trả về mã trạng thái HTTP và lý do gây ra lỗi. Ngoài ra, nội dung của phản hồi chứa nội dung mô tả chi tiết về nguyên nhân gây ra lỗi.

Danh sách sau đây cho biết các lỗi có thể xảy ra và hành động được đề xuất đối với các yêu cầu không thành công do vượt quá giới hạn yêu cầu API.

Mã RPC Thông điệp Việc nên làm
429 RESOURCE_EXHAUSTED Tài nguyên đã hết (ví dụ: kiểm tra hạn mức). Kiểm tra mức sử dụng từ Google API Console và sửa đổi quy trình làm việc để chạy song song các yêu cầu được thực hiện theo nhiều nhà quảng cáo một cách hiệu quả hơn hoặc nói chung là làm chậm tốc độ gửi yêu cầu.

Bạn không thể yêu cầu tăng hạn mức hạn mức API Display & Video 360.