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

כל הבקשות שנשלחות לממשקי ה-API של Google Photos נספרות במכסה. אנחנו מציבים את המגבלות האלה כדי להגן על המערכת והמשתמשים שלה.

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

למידע נוסף על השימוש הראוי ב-API הזה, ראו מדיניות השימוש המקובל.

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

המכסה של בקשות ל-Photos API היא 10,000 בקשות לפרויקט ביום. הרשאה זו כוללת את כל בקשות ה-API, כמו העלאה, הצגת מדיה והחלת מסננים, אבל לא גישה לבאיטים של מדיה מכתובת URL בסיסית.

מגבלת המכסה לבקשות גישה לבאיטים של מדיה (על ידי טעינה של תמונה או סרטון מכתובת URL בסיסית) היא 75,000 בקשות לכל פרויקט ביום.

בנוסף למגבלות האלה, קיימות מכסות נוספות כדי להגן על האמינות והתקינות של המערכות שלנו. אם מופיעה הודעת השגיאה 429, סביר להניח שחורגתם מאחד מהמכסות האלה. אם מופיעה אחת מהשגיאות האלה, צריך להקטין את מספר הבקשות שמבצעים בפרק זמן נתון. למידע נוסף, ראו ניסיון חוזר של בקשות שנכשלו והשהיה מעריכית לפני ניסיון חוזר (exponential backoff).

בדיקת ניצול המכסה

כדי לראות כמה מהמכסה הזמינה כבר נוצלה, ולראות או לשנות את מגבלות השימוש בפרויקט, נכנסים לדף המכסות במסוף Google API ובוחרים ב-Photos Picker API או ב-Photos Library API.

חריגה ממגבלות המכסות

אם תחרגו מהמכסה של הבקשות לממשקי ה-API של Photos, ה-API יחזיר את קוד השגיאה 429 והודעה על כך שהפרויקט חרג מהמכסה. למידע נוסף, ראו התנאים וההגבלות.

שליחת בקשה למכסה נוספת

תוכנית השותפים של Google Photos מיועדת לאפליקציות גדולות לצרכן שדורשות הגדלת מכסות. אם לדעתכם האפליקציה שלכם שייכת לקטגוריה הזו, עליכם להביע עניין בתוכנית השותפים.

נפח האחסון של התמונות והאיכות שלהן

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