בדף הזה מוסבר איך לפתור בעיות שגיאה ב-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, משתמשים בfield masks.
- כשמנסים לשלוח בקשות שוב, כדאי להשתמש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff).
גיליון אלקטרוני
- בגיליונות שמתעדכנים לעיתים קרובות, כדאי לעבור לגיליון אלקטרוני חדש מדי פעם כדי לצמצם את הצטברות הגרסאות.
- הגבלת השימוש ב-
IMPORTRANGE,QUERYובנוסחאות מורכבות אחרות. - כדאי לפצל גיליונות אלקטרוניים גדולים לכמה גיליונות אלקטרוניים.
- מומלץ להגביל את השימוש בגיליון אלקטרוני יחיד כמקור להרבה נוסחאות של
IMPORTRANGE. - כדאי להגביל את הגישה לגיליון האלקטרוני רק למי שצריך אותה.