توضّح هذه الصفحة كيفية تحديد المشاكل وحلّها باستخدام Sheets API.
400 Bad Request
يشير هذا الخطأ إلى أنّ الطلب تمت صياغته بشكل غير صحيح. لتحديد مشاكل هذه الطلبات وحلّها، يمكنك الاطّلاع على المستندات المرجعية وصفحة الدعم.
500 Internal Server Error
إذا واجهت خطأ 500 عند استخدام Sheets API، هذا يعني عادةً أنّ هناك مشكلة في واجهة برمجة التطبيقات نفسها. يمكنك تقديم تقرير خطأ في أداة تتبُّع المشاكل في واجهة برمجة تطبيقات "جداول بيانات Google" مع تضمين الطلب الذي تسبب في حدوث الخطأ.
503 Service Unavailable
تعرض واجهة برمجة تطبيقات "جداول بيانات Google" رسالة الخطأ 503 عندما تكون الخدمة غير متاحة أو عندما يكون مستوى تعقيد الطلب أو جدول البيانات مرتفعًا. في ما يلي بعض الاقتراحات للحدّ من معدّل أخطاء 503 عن طريق تعديل طلبات البيانات من واجهة برمجة التطبيقات وجدول البيانات الأساسي.
الطلب
- استخدِم
batchUpdateلدمج التعديلات ذات الصلة في طلب واحد. كُن حذرًا عند إرسال التحديثات الكبيرة دُفعة واحدة، لأنّ ذلك قد يؤدي إلى انتهاء مهلة. - يمكنك تحديد عدد الطلبات المتزامنة لواجهة برمجة التطبيقات لكل جدول بيانات على طلب واحد في الثانية.
- بالنسبة إلى جداول البيانات الكبيرة، يمكنك استرداد قيم جداول البيانات الضرورية فقط باستخدام تدوين A1 والحدّ من استخدام
includeGridData. - استخدِم أقنعة الحقول للحد من كمية البيانات التي تعرضها واجهة برمجة التطبيقات.
- يمكنك استخدام ميزة "التراجع الأُسيّ" عند إعادة محاولة إرسال الطلبات.
جدول بيانات
- بالنسبة إلى الأوراق التي يتم تحديثها بشكل متكرر، يمكنك تدويرها إلى جدول بيانات جديد بشكل دوري لتقليل تراكم الإصدارات.
- الحدّ من استخدام
IMPORTRANGEوQUERYوغيرها من الصيغ المعقّدة - يمكنك تقسيم جداول البيانات الكبيرة إلى جداول بيانات متعددة.
- تجنَّب استخدام جدول بيانات واحد كمصدر للعديد من صيغ
IMPORTRANGE. - قصر الوصول إلى جدول البيانات على من يحتاجون إليه فقط.