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