عیب یابی خطاهای API

در این صفحه نحوه عیب یابی خطاها با 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 محدود کنید.
  • دسترسی به صفحه گسترده را فقط برای کسانی که به آن نیاز دارند محدود کنید.
،

در این صفحه نحوه عیب یابی خطاها با 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 محدود کنید.
  • دسترسی به صفحه گسترده را فقط برای کسانی که به آن نیاز دارند محدود کنید.