כל הבקשות שנשלחות אל ממשקי Google Photos API נספרות במכסה. הגבלות האלה נועדו להגן על המערכת ועל המשתמשים שלה.
כדי לגשת ל-API צריך פרטי כניסה של לקוח OAuth מפרויקט של מפתחי Google. בפרויקט הזה צריך להפעיל את ממשקי Photos API, כמו שמתואר במאמר הגדרת האפליקציה.
מידע נוסף על שימוש הולם ב-API הזה זמין במאמר בנושא מדיניות למפתחים בנושא נתוני משתמש ב-Photos API.
מגבלות מכסה ל-API
לכל API יש מכסות משלו כדי להגן על האמינות והתקינות של המערכות שלנו. אם קיבלתם שגיאה 429, סביר להניח שהגעתם לאחת מהמכסות האלה. אם תוצג לך אחת מהשגיאות האלה, תצטרך להקטין את מספר הבקשות שאתה שולח בפרק זמן מסוים. מידע נוסף זמין במאמרים בנושא ניסיון חוזר של בקשות שנכשלו והשהיה מעריכית לפני ניסיון חוזר (exponential backoff).
מגבלות המכסה של Picker API
מגבלת המכסה לבקשות ל-Photos Picker API היא 100,000 בקשות לדקה לכל פרויקט.
מגבלת המכסה לבקשות גישה לבייטים של מדיה (על ידי טעינת תמונה או סרטון מכתובת URL בסיסית) היא מיליון בקשות לדקה לכל פרויקט.
מגבלות המכסה של Library API
מגבלת המכסה של בקשות ל-Library API היא 10,000 בקשות לכל פרויקט ביום. הפעולות האלה כוללות את כל בקשות ה-API, כמו העלאה, הצגת רשימה של מדיה והחלת מסננים, אבל לא גישה לבייטים של מדיה מכתובת URL בסיסית.
מגבלת המכסה לבקשות גישה לבייטים של מדיה (על ידי טעינת תמונה או סרטון מכתובת URL בסיסית) היא 75,000 בקשות לכל פרויקט ביום.
בדיקת ניצול המכסה
כדי לראות כמה מהמכסה הזמינה שלכם כבר נוצלה, וכדי לראות או לשנות את מגבלות השימוש בפרויקט, אתם יכולים להיכנס לדף המכסות ב-Google API Console ולבחור באפשרות Photos Picker API או Photos Library API.
חריגה ממגבלות המכסה
אם חורגים מהמכסה של בקשות ל-Photos APIs, ה-API מחזיר קוד שגיאה 429 והודעה שלפיה הפרויקט חרג מהמכסה. מידע נוסף זמין בתנאים ובהגבלות.
שליחת בקשה להגדלת המכסה
תוכנית השותפים של Google Photos מיועדת לאפליקציות צרכניות גדולות שנדרשות להן מכסות גדולות יותר. אם לדעתכם הבקשה שלכם שייכת לקטגוריה הזו, אתם יכולים להביע עניין בתוכנית השותפים.
אחסון ואיכות של תמונות
כל פריטי המדיה שמועלים ל-Google Photos באמצעות ה-API מאוחסנים ברזולוציה מלאה באיכות המקורית. הן נספרות בנפח האחסון של המשתמש.