Hạn mức sử dụng

Giới hạn sử dụng 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. Chúng đảm bảo rằng hành động của một nhà phát triển không được gây ả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, mà tất cả các yêu cầu liên quan đều được tính vào.
  • Ghi hạn mức, mà mọi yêu cầu liên quan được đưa ra để ghi phương thức sẽ đượ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. Hãy lưu ý rằng một số phương thức dùng nhiều hạn mức ghi hơn 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, việc điều tiết có thể xảy ra.

Giới hạn hạn mức trên toàn dự án

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

  • Tổng số yêu cầu mỗi phút trong mỗi dự án: 1500
  • Viết yêu cầu mỗi phút cho mỗi dự án: 700

Giới hạn 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 "mỗi nhà quảng cáo cho mỗi dự án" bổ sung.

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ư những yêu cầu đến các dịch vụ advertisers.lineItems, advertisers.creatives hoặc advertisers.channels) sẽ được tính vào các hạn mức sau:

  • Tổng số yêu cầu mỗi phút của mỗi nhà quảng cáo trong mỗi dự án: 300
  • Viết yêu cầu mỗi phút cho mỗi nhà quảng cáo theo dự án: 150

Phương thức dùng nhiều thao tác ghi

Các phương thức API sau đây thường dùng nhiều tài nguyên sản phẩm, tức là các phương thức này dùng một lượng tài nguyên sản phẩm đáng kể và do đó sẽ tốn 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 gửi đến các phương thức chuyên sâu được tính là 5 truy vấn ghi khi tính toán mức sử dụng hạn mức yêu cầu ghi. Ví dụ: 100 yêu cầu ghi thông thường và 21 yêu cầu nặng để ghi (không 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à cần nhiều thao tác ghi:

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

Trong trường hợp hiếm gặp mà 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, phần nội dung của phản hồi còn 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 thấy các lỗi có thể xảy ra và hành động được đề xuất cho các lỗi yêu cầu 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 của bạn từ Google API Console và sửa đổi quy trình công việc để tăng song song các yêu cầu được thực hiện với các nhà quảng cáo khác nhau hoặc thường làm chậm tốc độ mà bạn đang gửi yêu cầu.

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