محدودیت ها

این صفحه سهمیه‌ها و محدودیت‌های مختلف مخصوص API مدیریت AdSense را فهرست می‌کند. اینها علاوه بر محدودیت‌های خاص محصول (مانند تعداد کانال‌ها در هر حساب) که به طور کلی برای AdSense اعمال می‌شود، اعمال می‌شوند.

سهمیه های سطح API

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

با استفاده از صفحه سهمیه ها در Google API Console می توانید میزان استفاده فعلی خود را برای هر یک از این سهمیه ها مشاهده کنید. همچنین می توانید هشدار استفاده یا نظارت اضافی را تنظیم کنید. برای اطلاعات بیشتر به اسناد کلی Google Cloud Quotas مراجعه کنید.

فراتر از این سهمیه ها باعث رد شدن درخواست با خطای HTTP 429 Too Many Requests می شود. پیام خطا شامل جزئیات بیشتر از سهمیه است.

شرح	ارزش	یادداشت
پرس و جو در دقیقه برای یک کاربر و پروژه	100	n/a
پرس و جو در دقیقه برای همه کاربرانی که از یک پروژه استفاده می کنند	500	n/a
پرس و جو در روز	10000	سهمیه های روزانه حدود نیمه شب به وقت اقیانوس آرام بازنشانی می شوند.

محدودیت اندازه را گزارش کنید

گزارش‌های تولید شده توسط AdSense Management API دارای حداکثر اندازه هستند که به فرمت خروجی بستگی دارد:

• گزارش های JSON (مثلاً همانطور که توسط روش accounts.reports.generate ایجاد می شود) حداکثر به 100000 ردیف محدود می شود. گزارش‌های بزرگ‌تر از این کوتاه می‌شوند، اما پاسخ شامل یک فیلد totalMatchedRows است که اندازه گزارش کامل را شامل می‌شود، که می‌تواند برای تشخیص اینکه آیا کوتاهی رخ داده است یا خیر.
• گزارش‌های CSV (مثلاً همانطور که توسط روش accounts.reports.generateCsv ایجاد می‌شود) حداکثر به 1,000,000 ردیف محدود می‌شود. گزارش‌های بزرگ‌تر از این کوتاه می‌شوند.

گزارش سهمیه ردیف

API مدیریت AdSense همچنین محدودیت‌هایی را برای مقدار کل داده‌های گزارشی اعمال می‌کند که ممکن است در دوره‌های روزانه و کوتاه‌تر بازیابی شوند تا از استفاده نادرست جلوگیری شود. فراتر رفتن از این محدودیت ها باعث می شود که درخواست با یک خطای HTTP 429 Too Many Requests با پیام مرتبط "گزارش از سهمیه ردیف بیش از حد" رد شود.

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

پارامترهای مختلف درخواست کنترل می کنند که چه مقدار داده باید برای یک درخواست بازگردانده شود (به عنوان مثال، page_size برای درخواست هایی که اجازه صفحه بندی را می دهد، یا پارامتر limit برای درخواست های تولید گزارش). اگر این پارامترها مشخص نشده باشند، مقدار پیش فرض همیشه حداکثر مقدار مجاز است. تعیین مقدار بالاتر باعث رد درخواست با خطای HTTP 400 Bad Request می شود.