בדף הזה מוסבר איך לפתור שגיאות ב-Sheets API.
400 Bad Request
השגיאה הזו מציינת שהבקשה הייתה פגומה. כדי לפתור את הבעיות בבקשות האלה, תוכלו לעיין במסמכי העזר ובדף התמיכה.
500 Internal Server Error
אם נתקלת ב-500 שגיאות בזמן השימוש ב-Sheets API, המשמעות היא בדרך כלל שיש בעיה ב-API עצמו. שולחים דוח על באג במעקב אחר בעיות ב-Sheets API, עם הבקשה שגרמה לשגיאה.
503 Service Unavailable
ה-Sheets API מחזיר שגיאת 503 כשהשירות לא זמין או כשהמורכבות של הבקשה או של הגיליון האלקטרוני גבוהה. בהמשך מפורטות כמה הצעות להגבלת הקצב של שגיאות 503 על ידי שינוי בקשות ה-API והגיליון האלקטרוני הבסיסי.
בקשה
- באמצעות
batchUpdate
, ניתן לשלב עדכונים קשורים לבקשה אחת. חשוב להפעיל שיקול דעת כשמקבצים עדכונים גדולים, כי זה עלול לגרום להפסקה. - כדאי להגביל את מספר הבקשות הבו-זמניות ל-API בכל גיליון אלקטרוני לבקשה אחת בשנייה.
- בגיליונות אלקטרוניים גדולים, אפשר לאחזר רק את הערכים הנחוצים בגיליון האלקטרוני באמצעות סימון A1 ולהגביל את השימוש ב-
includeGridData
. - אפשר להשתמש במסכות שדות כדי להגביל את כמות הנתונים שה-API מחזיר.
- יש להשתמש בהשהייה מעריכית לפני ניסיון חוזר לבקשות.
גיליון אלקטרוני
- בגיליונות שמתעדכנים בתדירות גבוהה, כדאי לסובב מדי פעם לגיליון אלקטרוני חדש כדי לצמצם הצטברות של גרסאות.
- מגבילים את השימוש ב-
IMPORTRANGE
, ב-QUERY
ובנוסחאות מורכבות אחרות. - מומלץ לפצל גיליונות אלקטרוניים גדולים למספר גיליונות אלקטרוניים.
- להגביל את השימוש בגיליון אלקטרוני יחיד כמקור לנוסחאות רבות של
IMPORTRANGE
. - הגבילו את הגישה לגיליון האלקטרוני רק לאנשים שזקוקים לו.