בדף הזה מוסבר איך לפתור בעיות שקשורות לשגיאות ב-Sheets API.
400 Bad Request
השגיאה הזו מציינת שהבקשה הייתה בעלת מבנה פגום. לפתרון בעיות שקשורות לבקשות האלה, אפשר לעיין במאמרי העזרה ובדף התמיכה.
500 Internal Server Error
אם אתם נתקלים בשגיאות מסוג 500 כשאתם משתמשים ב-Sheets API, בדרך כלל זה סימן שיש בעיה ב-API עצמו. שולחים דיווח על באג בכלי למעקב אחר בעיות של Sheets API, עם הבקשה שגרמה לשגיאה.
503 Service Unavailable
כשהשירות לא זמין או כשהבקשה או הגיליון האלקטרוני מורכבים מאוד, ה-API של Sheets מחזיר את השגיאה 503. ריכזנו כאן כמה הצעות להגבלת שיעור השגיאות מסוג 503 על ידי שינוי בקשות ה-API והגיליון האלקטרוני הבסיסי.
בקשה
משתמשים ב-batchUpdate כדי לשלב עדכונים קשורים בבקשה אחת.
חשוב להיזהר כשמקבצים עדכונים גדולים, כי הפעולה הזו עלולה להפעיל זמן קצוב לתפוגה.
להגביל את מספר הבקשות בו-זמנית ל-API לכל גיליון אלקטרוני ל-1 בקשה לשנייה.
בגיליון אלקטרוני גדול, אפשר לאחזר רק את הערכים הנחוצים בגיליון באמצעות סימון A1 ולהגביל את השימוש ב-includeGridData.
משתמשים במסכות שדות כדי להגביל את כמות הנתונים שמוחזרים על ידי ה-API.
שימוש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) כשמנסים לשלוח שוב בקשות.
גיליון אלקטרוני
לגבי גיליונות שמתעדכנים לעיתים קרובות, כדאי להחליף אותם מדי פעם בגיליון אלקטרוני חדש כדי לצמצם את הצטברות הגרסאות.
להגביל את השימוש ב-IMPORTRANGE, ב-QUERY ובנוסחאות מורכבות אחרות.
מומלץ לפצל גיליונות אלקטרוניים גדולים למספר גיליונות אלקטרוניים.
כדאי להגביל את השימוש בגיליון אלקטרוני אחד כמקור לנוסחאות רבות של IMPORTRANGE.
כדאי להגביל את הגישה לגיליון האלקטרוני רק למי שזקוק לו.
[null,null,["עדכון אחרון: 2024-12-21 (שעון UTC)."],[[["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"]]