Hạn mức

Hạn mức Display & Video 360 API giới hạn tốc độ mà một dự án có thể gửi yêu cầu đến API.

Hãy làm theo các phương pháp hay nhất này để sử dụng hạn mức API Display & Video 360 hiệu quả hơn.

Đưa ra yêu cầu cho nhiều nhà quảng cáo cùng một lúc

Hạn mức Display & Video 360 API được đặt theo từng dự án và từng nhà quảng cáo. Hạn mức dự án giới hạn số lượng yêu cầu mà một dự án đưa ra. Hạn mức nhà quảng cáo giới hạn số yêu cầu mà một dự án gửi đến một nhà quảng cáo.

Để sử dụng hết hạn mức dự án, hãy đưa ra yêu cầu cho nhiều nhà quảng cáo cùng một lúc.

Sử dụng tham số truy vấn list

Sử dụng các tham số truy vấn phương thức list để chỉ thêm những tài nguyên bạn muốn. Ít tài nguyên hơn thì cần ít yêu cầu liệt kê hơn.

Các phương thức list cung cấp 3 tham số chính:

  • pageSize đặt số lượng tài nguyên mà yêu cầu có thể trả về. Kích thước trang mặc định phụ thuộc vào phương thức. Đặt giá trị này thành giá trị cao nhất để liệt kê nhiều tài nguyên hơn cho mỗi yêu cầu.
  • filter giới hạn các tài nguyên được liệt kê theo tiêu chí được cung cấp. Đặt giá trị này thành danh sách chỉ một nhóm nhỏ tài nguyên. Hãy xem phần Lọc các yêu cầu về danh sách để biết thêm thông tin.
  • orderBy sắp xếp các tài nguyên được liệt kê theo thuộc tính đã cho. Đặt giá trị này để truy xuất trần hoặc sàn của danh sách tài nguyên với ít yêu cầu hơn.

Sử dụng các hàm trên diện rộng và hàng loạt

Các hàm trên diện rộng và theo tài nguyên thực hiện các tác vụ phức tạp. Một yêu cầu duy nhất đối với các phương thức này có thể thay thế nhiều yêu cầu đối với các phương thức khác.

Để biết thêm thông tin về các phương thức này, hãy xem phần Yêu cầu hàng loạt.

Mã nhận dạng bộ nhớ đệm

Nhiều thao tác Display & Video 360 API yêu cầu mã nhận dạng được truy xuất bằng API. Ví dụ: mã nhận dạng tiêu chí nhắm mục tiêumã nhận dạng đối tượng của Google. Lưu trữ mã nhận dạng cửa hàng cục bộ để bạn không cần phải liên tục truy xuất các mã này.

Việc sử dụng mã nhận dạng cho các tài nguyên không được dùng nữa hoặc đã bị xoá có thể trả về lỗi. Bạn nên truy xuất mã nhận dạng được lưu vào bộ nhớ đệm hằng tuần để xác nhận trạng thái của mã nhận dạng.

Sử dụng thuật toán thời gian đợi luỹ thừa

Thuật toán thời gian đợi luỹ thừa là một chiến lược xử lý lỗi. Thư viện này sẽ thử lại các yêu cầu trong khoảng thời gian tăng dần.

Trong khi thăm dò một tác vụ chạy trong thời gian dài, chẳng hạn như tác vụ tải SDF xuống, chiến lược thời gian đợi lũy thừa có thể giảm số lượng yêu cầu được gửi.

Các ví dụ về mã tải SDF xuống của chúng tôi sử dụng thuật toán thời gian đợi luỹ thừa với thư viện ứng dụng. Sau đây là ví dụ về quy trình thời gian đợi luỹ thừa:

  • Truy xuất đối tượng Operation bằng yêu cầu get.
    • Nếu done không phải là true, thì tác vụ vẫn đang chạy.
    • Đợi 5 giây + một số giây ngẫu nhiên, rồi thử lại yêu cầu.
  • Truy xuất thao tác.
    • Nếu done không phải là true, thì tác vụ vẫn đang chạy.
    • Đợi 10 giây + một số giây ngẫu nhiên, rồi thử lại yêu cầu.
  • Truy xuất thao tác.
    • Nếu done không phải là true, thì tác vụ vẫn đang chạy.
    • Đợi 20 giây + một số giây ngẫu nhiên, rồi thử lại yêu cầu.
  • Truy xuất thao tác.
    • Nếu done không phải là true, thì tác vụ vẫn đang chạy.
    • Đợi 40 giây + một số giây ngẫu nhiên, rồi thử lại yêu cầu.
  • Truy xuất thao tác.
    • Nếu done không phải là true, thì tác vụ vẫn đang chạy.
    • Đợi 80 giây + một số giây ngẫu nhiên, rồi thử lại yêu cầu.
  • Tiếp tục mẫu này cho đến khi done là true hoặc đạt đến thời gian tối đa đã trôi qua.