Google Sheets API הוא שירות משותף, לכן אנחנו מחילים מכסות ומגבלות כדי לוודא שייעשה שימוש הוגן לכל המשתמשים וכדי להגן על כלל המשתמשים של מערכת Google Workspace.
מגבלות המכסה
ל-Sheets API אין מגבלות גודל קשיחות בבקשות API, אבל יכול להיות שהמשתמשים יחוו מגבלות לגבי רכיבי עיבוד שונים שלא נשלטים על ידי Sheets. כדי לזרז בקשות, Google ממליצה על מטען ייעודי (payload) מקסימלי של 2MB.
ב-Sheets API יש מכסות לדקה, והן מתמלאות מחדש מדי דקה. לדוגמה, מגבלת בקשות הקריאה היא 300 לדקה לכל פרויקט.
אם האפליקציה שולחת 350 בקשות בדקה אחת, 50 הבקשות הנוספות חורגות מהמכסה ויוצרות
תגובה אחת (429: Too many requests) לקוד מצב HTTP. במקרה כזה, עליך להשתמש
אלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff). אחרי דקה,
יוכל לשלוח שוב בקשות. משתמשים יכולים לשלוח כמה בקשות בו-זמנית, כל עוד הן לא מגיעות למכסה המקסימלית.
כל הבקשות מ-Sheets מוחלות באופן אטומי. כלומר, אם בקשה כלשהי לא תקפה, העדכון כולו ייכשל ולא יוחל אף אחד מהשינויים (שעשויים להיות תלויים).
בטבלה הבאה מפורטות המגבלות על הבקשות. בתנאי שאתם לא חורגים מהמכסות לדקה, אין להגביל את מספר הבקשות שאפשר לשלוח ביום.
| מכסות | |||||
|---|---|---|---|---|---|
| בקשות קריאה |
|
||||
| בקשות כתיבה |
|
||||
פרטים על מגבלות קבצים מופיעים במאמר קבצים שאפשר לאחסן ב-Google Drive.
פתרון שגיאות במכסות מבוססות-זמן
עבור כל השגיאות מבוססות הזמן (עד N בקשות ב-X דקות), מומלץ הקוד קולט את החריגה ומשתמש בהשהיה מעריכית קטועה לפני ניסיון חוזר (exponential backoff) כדי לוודא מכשירים לא יוצרים עומס יתר.
השהיה מעריכית לפני ניסיון חוזר (exponential backoff) היא אסטרטגיה סטנדרטית לטיפול בשגיאות באפליקציות רשת. האלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) מבצע ניסיון חוזר של בקשות באמצעות הגדלה אקספוננציאלית של זמני ההמתנה בין בקשות, עד למשך השהיה מקסימלית לפני ניסיון חוזר (backoff) אם הבקשות לא יצליחו, חשוב שהעיכוב בין הבקשות יתארך עם הזמן עד שהבקשה תושלם.
אלגוריתם לדוגמה
אלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) מבצע ניסיון חוזר של בקשות באופן אקספוננציאלי, וכך מאריך את זמן ההמתנה בין ניסיונות חוזרים עד לזמן השהיה מקסימלי לפני ניסיון חוזר (backoff) לדוגמה:
- שולחים בקשה ל-Google Sheets API.
- אם הבקשה נכשלת, צריך להמתין 1 +
random_number_millisecondsולנסות שוב לבקשה. - אם הבקשה נכשלת, צריך להמתין 2 +
random_number_millisecondsולנסות שוב לבקשה. - אם הבקשה נכשלת, צריך להמתין 4 +
random_number_millisecondsולנסות שוב לבקשה. - וכן הלאה, עד פעם אחת (
maximum_backoff). - יש להמשיך להמתין ולנסות שוב עד למספר המקסימלי של ניסיונות חוזרים, אך אין להאריך את ההמתנה בין הניסיונות החוזרים.
איפה:
- זמן ההמתנה הוא
min(((2^n)+random_number_milliseconds), maximum_backoff), כאשרnמוגדל ב-1 עבור כל איטרציה (בקשה). random_number_millisecondsהוא מספר אקראי של אלפיות שנייה שקטן מ- או שווה ל-1,000. כך ניתן למנוע מקרים שבהם הרבה לקוחות מסונכרנים מצב מסוים וכולם יבצעו ניסיון חוזר בו-זמנית, שליחת בקשות מסונכרנות גלים. הערך שלrandom_number_millisecondsמחושב מחדש לאחר כל יש לנסות שוב את הבקשה.maximum_backoffהוא בדרך כלל 32 או 64 שניות. הערך המתאים תלוי בתרחיש לדוגמה.
הלקוח יכול להמשיך לנסות שוב אחרי שיסתיים הזמן של maximum_backoff.
ניסיונות חוזרים לאחר השלב הזה לא צריכים להמשיך להגדיל את זמן ההשהיה לפני ניסיון חוזר. עבור
לדוגמה, אם לקוח משתמש בזמן maximum_backoff של 64 שניות, אז אחרי שהוא הגיע
הערך הזה, הלקוח יכול לנסות שוב כל 64 שניות. בשלב כלשהו,
יש למנוע מלקוחות ניסיון חוזר ללא הגבלת זמן.
זמן ההמתנה בין הניסיונות החוזרים לבין מספר הניסיונות החוזרים תלוי בתרחיש לדוגמה שלכם. ותנאי הרשת.
תמחור
כל שימוש ב-Google Sheets API זמין ללא עלות נוספת. חריגה מהמכסה לא תחויבו כחיובים נוספים והחשבון שלכם לא יחויב.
בקשה להגדלת מכסה
יכול להיות שתרצו לבקש מכסה, בהתאם לשימוש במשאבים בפרויקט שלכם עלייה. קריאות ל-API שמתבצעות על ידי חשבון שירות נחשבות כעושות שימוש חשבון אחד. הגשת בקשה להגדלת מכסה לא מבטיחה אישור. לארג' תהליך האישור של הגדלת מכסות עשוי להימשך זמן רב יותר.
המכסות לא זהות לכל הפרויקטים. ככל שהשימוש ב-Google Cloud הולך וגדל יכול להיות שתצטרכו להגדיל את המכסות. אם צפויה בקרוב בשימוש, ניתן לנקוט שליחת בקשה לשינויי מכסות מהדף Quotas במסוף Google Cloud.
מידע נוסף זמין במקורות המידע הבאים: