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