سهمیه، سهم

سهمیه API نمایش و ویدیو ۳۶۰، میزان درخواست‌های یک پروژه به API را محدود می‌کند.

برای استفاده بهتر از سهمیه API Display & Video 360 خود، این بهترین شیوه‌ها را دنبال کنید.

درخواست‌ها را همزمان برای تبلیغ‌کنندگان ارسال کنید

سهمیه API نمایش و ویدیو ۳۶۰ برای هر پروژه و برای هر تبلیغ‌کننده تعیین می‌شود. سهمیه پروژه، درخواست‌های ارسالی توسط یک پروژه را محدود می‌کند. سهمیه تبلیغ‌کننده، درخواست‌های ارسالی توسط یک پروژه را به یک تبلیغ‌کننده محدود می‌کند.

برای استفاده از تمام سهمیه پروژه خود، درخواست‌ها را همزمان به تبلیغ‌کنندگان ارسال کنید.

استفاده از پارامترهای پرس و جوی list

از پارامترهای کوئری متد list برای درج منابع مورد نیاز استفاده کنید. منابع کمتر، به درخواست‌های کمتری برای فهرست شدن نیاز دارند.

متدهای list سه پارامتر کلیدی ارائه می‌دهند:

  • pageSize تعداد منابعی را که می‌توانند توسط درخواست برگردانده شوند، تعیین می‌کند. اندازه پیش‌فرض صفحه به روش بستگی دارد. برای فهرست کردن منابع بیشتر در هر درخواست، این مقدار را روی بالاترین مقدار تنظیم کنید.
  • filter منابع فهرست‌شده را بر اساس معیارهای ارائه‌شده محدود می‌کند. این گزینه را طوری تنظیم کنید که فقط زیرمجموعه‌ای از منابع را فهرست کند. برای اطلاعات بیشتر به درخواست‌های فیلتر فهرست مراجعه کنید.
  • orderBy منابع فهرست‌شده را بر اساس ویژگی داده‌شده مرتب می‌کند. این را برای بازیابی سقف یا کف فهرست منابع با درخواست‌های کمتر تنظیم کنید.

استفاده از توابع حجیم و گسترده در منابع

توابع bulk و resource-wide وظایف پیچیده‌ای را انجام می‌دهند. یک درخواست واحد به این متدها می‌تواند جایگزین چندین درخواست به متدهای دیگر شود.

برای اطلاعات بیشتر در مورد این روش‌ها، به بخش درخواست‌های انبوه مراجعه کنید.

شناسه‌های حافظه پنهان

بسیاری از اقدامات Display & Video 360 API نیاز به شناسه‌هایی دارند که با استفاده از API بازیابی می‌شوند. نمونه‌هایی از آن شامل شناسه‌های گزینه‌های هدف‌گیری و شناسه‌های مخاطبان گوگل است. شناسه‌ها را به صورت محلی ذخیره کنید تا نیازی به بازیابی مداوم آنها نداشته باشید.

استفاده از شناسه‌ها برای منابعی که منسوخ یا حذف شده‌اند می‌تواند منجر به خطا شود. شما باید شناسه‌های ذخیره‌شده در حافظه پنهان را به‌صورت هفتگی بازیابی کنید تا وضعیت آنها تأیید شود.

از پس‌روی نمایی استفاده کنید

بازگشت نمایی یک استراتژی مدیریت خطا است. این روش درخواست‌ها را در مدت زمان فزاینده‌ای دوباره امتحان می‌کند.

هنگام نمونه‌برداری از یک وظیفه طولانی‌مدت، مانند یک وظیفه دانلود SDF ، یک استراتژی backoff نمایی می‌تواند تعداد درخواست‌های ارسالی را کاهش دهد.

مثال‌های کد دانلود SDF ما از جریان برگشتی نمایی با کتابخانه‌های کلاینت ما استفاده می‌کنند. در زیر مثالی از جریان برگشتی نمایی آمده است:

  • شیء Operation را با درخواست get بازیابی کنید.
    • اگر done برابر با true نباشد، وظیفه هنوز در حال اجرا است.
    • ۵ ثانیه + یک عدد تصادفی بر حسب ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید.
  • عملیات را پس بگیرید.
    • اگر done برابر با true نباشد، وظیفه هنوز در حال اجرا است.
    • ۱۰ ثانیه + یک عدد تصادفی بر حسب ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید.
  • عملیات را پس بگیرید.
    • اگر done برابر با true نباشد، وظیفه هنوز در حال اجرا است.
    • ۲۰ ثانیه + یک عدد تصادفی بر حسب ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید.
  • عملیات را پس بگیرید.
    • اگر done برابر با true نباشد، وظیفه هنوز در حال اجرا است.
    • ۴۰ ثانیه + یک عدد تصادفی بر حسب ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید.
  • عملیات را پس بگیرید.
    • اگر done برابر با true نباشد، وظیفه هنوز در حال اجرا است.
    • ۸۰ ثانیه + یک عدد تصادفی بر حسب ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید.
  • این الگو را تا زمانی که done با true شود یا حداکثر زمان سپری شده فرا برسد، ادامه دهید.