محدودیت های استفاده

محدودیت‌های استفاده، زیرساخت Google را در برابر فرآیندهای خودکاری که از Display & Video 360 API به روشی نامناسب استفاده می‌کنند محافظت می‌کند. آنها اطمینان می دهند که اقدامات یک توسعه دهنده نمی تواند تأثیر منفی بر جامعه بزرگتر بگذارد.

محدودیت سهمیه درخواست API

API Display & Video 360 از دو نوع محدودیت استفاده می کند:

• مجموع محدودیت‌های سهمیه ، که همه درخواست‌های مربوطه به حساب می‌آیند.
• محدودیت‌های سهمیه را بنویسید ، که تمام درخواست‌های مربوطه برای نوشتن روش‌ها به حساب می‌آیند. روش‌های نوشتن به عنوان روش‌هایی تعریف می‌شوند - مانند create ، patch ، delete ، یا bulkEdit - که منابع را تغییر می‌دهند. توجه داشته باشید که برخی از روش ها سهمیه نوشتن بیشتری را نسبت به بقیه مصرف می کنند.

اگر پروژه شما از هر یک از این محدودیت ها فراتر رود، ممکن است throttling رخ دهد .

محدودیت سهمیه پروژه

محدودیت‌های سهمیه پیش‌فرض زیر توسط همه منابع و روش‌های Display & Video 360 API مشترک است:

• مجموع درخواست ها در هر دقیقه در هر پروژه: 1500
• نوشتن درخواست در دقیقه در هر پروژه: 700

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

روش‌هایی که شناسه آگهی‌دهنده را در URL درخواست مشخص می‌کنند در مقابل محدودیت‌های اضافی سهمیه «به‌ازای هر تبلیغ‌کننده در هر پروژه» حساب می‌شوند.

همه درخواست‌های دارای شناسه تبلیغ‌کننده مشخص‌شده در مسیر URL آنها - مانند درخواست‌هایی که به advertisers.lineItems ، advertisers.creatives یا سرویس‌های advertisers.channels هستند - در محدودیت‌های سهمیه زیر محاسبه می‌شوند:

• کل درخواست ها در دقیقه به ازای هر تبلیغ کننده در هر پروژه: 300
• نوشتن درخواست در دقیقه به ازای هر تبلیغ کننده در هر پروژه: 150

روش های فشرده نوشتن

متدهای API زیر بسیار فشرده هستند، به این معنی که از مقدار قابل توجهی از منابع محصول استفاده می‌کنند و در نتیجه سهمیه درخواست نوشتن بیشتری را نسبت به سایر درخواست‌های نوشتن مصرف می‌کنند.

هنگام محاسبه مصرف سهمیه درخواست نوشتن، درخواست‌هایی که به روش‌های فشرده ارسال می‌شوند، به عنوان 5 پرس‌و‌جوی نوشتن شمارش می‌شوند. به عنوان مثال، 100 درخواست نوشتن استاندارد و 21 درخواست فشرده نوشتن (که هیچ کدام تبلیغ کننده را مشخص نمی کنند) به عنوان 205 درخواست نوشتن محاسبه می شوند ( 100 + (21 * 5) = 205 ) و از درخواست عمومی موجود فراتر می روند. محدودیت سهمیه 200 درخواست نوشتن در دقیقه.

روش های زیر فشرده نگاری در نظر گرفته می شوند:

• customBiddingAlgorithms.scripts.create
• customBiddingAlgorithms.uploadScript
• firstAndThirdPartyAudiences.create
• firstAndThirdPartyAudiences.editCustomerMatchMembers
• media.upload

فراتر از حد نصاب

در صورتی که درخواست شما به دلیل فراتر از حد درخواست API با شکست مواجه شود، API یک کد وضعیت HTTP و دلیل خطا را برمی‌گرداند. علاوه بر این، بدنه پاسخ حاوی شرح مفصلی از آنچه باعث خطا شده است.

لیست زیر خطاهای احتمالی و اقدامات توصیه شده برای شکست درخواست ناشی از بیش از حد درخواست API را نشان می دهد.

کد	RPC	پیام	عمل پیشنهاد شده
429	RESOURCE_EXHAUSTED	منبع تمام شده است (مثلاً سهمیه را بررسی کنید).	استفاده خود را از Google API Console بررسی کنید و گردش کار خود را برای موازی سازی بهتر درخواست های ارائه شده تحت تبلیغ دهندگان مختلف یا به طور کلی کاهش سرعت ارسال درخواست ها تغییر دهید.

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