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