בדף הזה מוסבר איך לפתור בעיות שקשורות לשגיאות ב-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. - כדאי להגביל את הגישה לגיליון האלקטרוני רק למי שזקוק לו.