توضّح هذه الصفحة كيفية تحديد وحلّ الأخطاء في واجهة برمجة التطبيقات Sheets API.
400 Bad Request
يشير هذا الخطأ إلى أنّ الطلب تمت صياغته بشكلٍ غير صحيح. لتحديد وحلّ المشاكل المتعلّقة بهذه
الطلبات، يُرجى الاطّلاع على المستندات المرجعية وصفحة الدعم.
500 Internal Server Error
إذا كنت تواجه أخطاء 500 عند استخدام Sheets API، يشير ذلك عادةً إلى أنّ هناك مشكلة في واجهة برمجة التطبيقات نفسها. أرسِل بلاغًا عن خطأ
في أداة تتبُّع المشاكل الخاصة بواجهة برمجة التطبيقات Sheets API مع تضمين الطلب الذي أدّى
إلى ظهور الخطأ.
503 Service Unavailable
تعرِض واجهة برمجة التطبيقات Sheets API خطأ 503 عندما تكون الخدمة غير متاحة أو
عندما تكون درجة تعقيد الطلب أو جدول البيانات عالية. في ما يلي
بعض الاقتراحات للحد من معدّل الأخطاء 503 من خلال تعديل طلبات البيانات من واجهة برمجة التطبيقات
وجدول البيانات الأساسي.
الطلب
استخدِم batchUpdate لدمج التعديلات ذات الصلة في طلب واحد.
يُرجى توخي الحذر عند تجميع التعديلات الكبيرة لأنّ ذلك قد يؤدي إلى
انتهاء مهلة.
يجب الحد من عدد الطلبات المتزامنة إلى واجهة برمجة التطبيقات لكل جدول بيانات إلى طلب واحد في الثانية.
بالنسبة إلى جداول البيانات الكبيرة، استردّ قيم جداول البيانات الضرورية فقط باستخدام
ترميز A1 وحصر استخدام includeGridData.
استخدِم أقنعة الحقول لتقييد مقدار البيانات التي تعرضها واجهة برمجة التطبيقات.
استخدِم خوارزمية الرقود الأسي الثنائي عند إعادة محاولة إرسال الطلبات.
جدول بيانات
بالنسبة إلى جداول البيانات التي يتم تعديلها بشكل متكرّر، يمكنك التبديل إلى جدول بيانات جديد بشكل دوري لمحاولة
تقليل تراكم الإصدارات.
تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This page provides troubleshooting steps for common errors (`400`, `500`, `503`) when using the Google Sheets API."],["The Google Status Dashboard offers real-time updates on the Sheets API's status and can help identify potential service disruptions."],["For `503` errors, strategies include batching updates, limiting concurrent requests, optimizing data retrieval, and simplifying spreadsheet structure."],["When encountering a `400` error, refer to the API documentation and support page to ensure your request is properly formatted."],["`500` errors typically indicate an issue with the Sheets API itself and should be reported through the Issue Tracker with the request details."]]],["The Sheets API's Status Dashboard is the first place to check for errors. `400 Bad Request` errors indicate a malformed request; consult the reference and support documentation. `500 Internal Server Error` signifies an API issue; file a bug report. `503 Service Unavailable` errors can be mitigated by using `batchUpdate`, limiting concurrent requests, retrieving only necessary data, employing field masks, and using exponential backoff. For spreadsheets, reducing formula complexity and limiting access can help.\n"]]
