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

توضّح هذه الصفحة كيفية تحديد وحلّ المشاكل في واجهة برمجة التطبيقات 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
  • قصر الوصول إلى جدول البيانات على المستخدمين الذين يحتاجون إليه فقط