מכסות ומגבלות שימוש

מגבלות ומכסות מגינות על התשתית של Google מפני תהליך אוטומטי שעושה שימוש ב-API של המפיץ באופן בלתי הולם. בקשות מוגזמות מ-API עלולות לנבוע משגיאת הקלדה לא מזיקה, או למערכת שמעוצבת באופן לא יעיל שמבצעת קריאות ל-API מיותרות. לא משנה מה הסיבה, חסימת תנועה ממקור ספציפי כשהיא מגיעה לרמה מסוימת היא הכרחית לתקינות הכוללת של מערכת Google Workspace. כך אפשר להבטיח שהפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה הרחבה יותר.

בקשות API שנכשלו

במקרה הלא סביר שבו בקשת ה-API נכשלת, האפליקציה מקבלת תגובת קוד סטטוס HTTP. קוד הסטטוס 403 כולל פרטי שגיאה על קלט שגוי, וקוד סטטוס HTTP של 503 כולל פרטי שגיאה שמציין את המכסות של ה-API חריגה. התגובות האלה מאפשרות לאפליקציה המותאמת אישית לזהות את השגיאות האלה ולנקוט פעולה מתאימה.

שגיאות מבוססות-זמן

בכל השגיאות שמבוססות על זמן (עד N שניות ל-N שניות לכל שרשור), במיוחד שגיאות בקוד הסטטוס 503, מומלץ שהקוד יזוהה במקרה החריג. לצורך כך, באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff), כדאי להמתין לעיכוב קטן לפני שמנסים שוב את הקריאה שנכשלה. דוגמה ל-Seller API ל-thread אחד היא להמתין 5 שניות ולנסות שוב את הקריאה שנכשלה. אם הבקשה תתבצע בהצלחה, תוכלו לחזור על הדפוס הזה בשרשורים האחרים. אם הבקשה השנייה לא מצליחה, האפליקציה צריכה להקטין את תדירות הבקשה עד שהשיחה תסתיים. לדוגמה, אפשר להאריך את ההשהיה הראשונית של 5 שניות ל-10 שניות ולנסות שוב לבצע את השיחה שנכשלה. בנוסף, קבעו מגבלה על מספר הניסיונות החוזרים. לדוגמה, אפשר לנסות לבצע ניסיון חוזר של בקשה 5 עד 7 פעמים, עם זמני השהיה שונים, לפני שהאפליקציה תחזיר שגיאה למשתמש.

מגבלות

קטגוריות של מגבלות API מגבלות
מינוי purchaseOrderId אפשר להזין במאפיין הזה עד 80 תווים של טקסט פשוט.
מינוי maxResults מחרוזת השאילתה maxResults יכולה להכיל 1 עד 100 תוצאות. ברירת המחדל היא 20 תוצאות.
אסימון העברה (customerAuthToken) אסימון העברה של לקוח תקף למשך 30 יום לאחר שנוצר.
מספר משתמשים מקסימלי ללקוח בהתאם לחוזה שלך, מספר המשתמשים המקסימלי יכול להיות 50,000 או המספר המקסימלי שמוגדר בחוזה המפיץ שלך.
בקשות לא מורשות Google לא מתירה שליחת בקשות לא מורשות ל-מפיץ API. בקשה נחשבת כלא מורשית אם לא סופק אסימון הרשאה. מידע נוסף זמין במאמר מידע על אימות והרשאה.

סוגים נוספים של מגבלות

סוגים נוספים של מגבלות מגבלות והנחיות
פורמט נתונים פורמט הנתונים הוא ב-JavaScript Object Notation JSON.

JSON הוא פורמט נפוץ באינטרנט שמספק שיטה לייצוג מבני נתונים שרירותיים. JSON הוא פורמט טקסט שאינו תלוי לגמרי בשפה, אבל משתמש למוסכמות שמוכרות למתכנתים של משפחת C של השפות, כולל C, C++, C#, Java, JavaScript, Perl ו-Python.
פורמט שעה כל מועדי התאריכים מופיעים בממיר Epoch באלפיות שנייה. הפורמט הזה רלוונטי לערכים של שעת יצירת המינוי, זמני ההתחלה והסיום של התוכנית בתוכנית ושעת הסיום של תקופת הניסיון בחינם ל-30 יום.