تحديد مشاكل واجهة برمجة التطبيقات وحلّها

توضّح هذه الصفحة كيفية تحديد المشاكل وحلّها في Sheets API.

400 Bad Request

يشير هذا الخطأ إلى أنّ الطلب غير صالح. لتحديد المشاكل وحلّها في هذه الطلبات، يُرجى الاطّلاع على المستندات المرجعية و صفحة الدعم.

500 Internal Server Error

إذا ظهرت لك أخطاء 500 عند استخدام Sheets API، يشير ذلك عادةً إلى حدوث مشكلة في واجهة برمجة التطبيقات نفسها. يُرجى الإبلاغ عن خطأ في أداة تتبُّع المشاكل في Sheets API مع تضمين الطلب الذي تسبّب في حدوث الخطأ.

503 Service Unavailable

تعرض Sheets API الخطأ 503 عندما تكون الخدمة غير متاحة أو عندما يكون الطلب أو جدول البيانات معقّدًا. في ما يلي بعض الاقتراحات للحدّ من معدّل أخطاء 503 من خلال تعديل طلبات البيانات من واجهة برمجة التطبيقات وجدول البيانات الأساسي.

طلب

  • استخدِم batchUpdate لدمج التعديلات ذات الصلة في طلب واحد. يُرجى توخي الحذر عند تجميع التعديلات الكبيرة في دفعة واحدة لأنّ ذلك قد يؤدي إلى انتهاء المهلة.
  • حدِّد عدد الطلبات المتزامنة إلى واجهة برمجة التطبيقات لكل جدول بيانات بطلب واحد في الثانية.
  • بالنسبة إلى جداول البيانات الكبيرة، استرجِع قيم جدول البيانات الضرورية فقط باستخدام تدوين A1، وقلِّل من استخدام includeGridData.
  • استخدِم أقنعة الحقول للحدّ من مقدار البيانات التي تعرضها واجهة برمجة التطبيقات.
  • استخدِم خوارزمية الرقود الأسي الثنائي عند إعادة محاولة الطلبات.

جدول بيانات

  • بالنسبة إلى الأوراق التي يتم تعديلها بشكل متكرر، انتقِل إلى جدول بيانات جديد بشكل دوري للحدّ من تراكم الإصدارات.
  • قلِّل من استخدام IMPORTRANGE وQUERY والصيغ المعقّدة الأخرى.
  • يمكنك تقسيم جداول البيانات الكبيرة إلى جداول بيانات متعددة.
  • قلِّل من استخدام جدول بيانات واحد كمصدر للعديد من IMPORTRANGE صيغ.
  • قصر الوصول إلى جدول البيانات على المستخدمين الذين يحتاجون إليه فقط.