این صفحه نحوه عیبیابی خطاها با API صفحات را شرح میدهد.
400 Bad Request
این خطا نشان میدهد که درخواست ناقص ارسال شده است. برای عیبیابی این درخواستها، به مستندات مرجع و صفحه پشتیبانی مراجعه کنید.
500 Internal Server Error
اگر هنگام استفاده از API Sheets با خطای ۵۰۰ مواجه میشوید، معمولاً نشان میدهد که مشکلی در خود API وجود دارد. یک گزارش اشکال (bug report) را در ردیاب مشکلات API Sheets به همراه درخواستی که باعث خطا شده است، ثبت کنید.
503 Service Unavailable
API مربوط به Sheets زمانی که سرویس در دسترس نباشد یا پیچیدگی درخواست یا صفحه گسترده زیاد باشد، خطای ۵۰۳ را برمیگرداند. در ادامه چند پیشنهاد برای محدود کردن میزان خطاهای ۵۰۳ با تغییر درخواستهای API و صفحه گسترده اصلی ارائه شده است.
درخواست
-
batchUpdateبرای ترکیب بهروزرسانیهای مرتبط در یک درخواست واحد استفاده کنید. هنگام دستهبندی بهروزرسانیهای بزرگ احتیاط کنید زیرا این کار ممکن است باعث ایجاد وقفه شود. - تعداد درخواستهای همزمان به API در هر صفحه گسترده را به ۱ درخواست در ثانیه محدود کنید.
- برای صفحات گسترده بزرگ، فقط مقادیر ضروری صفحه گسترده را با استفاده از نمادگذاری A1 بازیابی کنید و استفاده از
includeGridDataرا محدود کنید. - از ماسکهای فیلد برای محدود کردن میزان دادههای برگردانده شده توسط API استفاده کنید.
- هنگام تلاش مجدد برای درخواستها، از backoff نمایی استفاده کنید.
صفحه گسترده
- برای برگههایی که مرتباً بهروزرسانی میشوند، بهطور دورهای به یک صفحهگسترده جدید بروید تا از انباشت نسخهها جلوگیری شود.
- استفاده از
IMPORTRANGE،QUERYو سایر فرمولهای پیچیده را محدود کنید. - تقسیم صفحات گسترده بزرگ به چندین صفحه گسترده را در نظر بگیرید.
- استفاده از یک صفحه گسترده واحد را به عنوان منبع برای بسیاری از فرمولهای
IMPORTRANGEمحدود کنید. - دسترسی به صفحه گسترده را فقط به کسانی که به آن نیاز دارند محدود کنید.