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

במסמך הזה מתוארות המגבלות והמכסות של בקשות לממשקי API לניהול ול-Reporting API.

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

בסרטון הזה מפורטות השיטות המומלצות לניהול מכסות של בקשות API של Google Analytics.

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

המכסות הבאות חלות על Management API, Core Reporting API v3, MCF Reporting API, Metadata API ו-User Deletion API ו-Real Time Reporting API:

  • 50,000 בקשות לכל פרויקט ביום, אפשר להגדיל.
  • 10 שאילתות לשנייה (QPS) לכל כתובת IP.
    • במסוף API יש מכסה דומה שנקראת Requests per 100 seconds per user. כברירת מחדל, הוא מוגדר ל-100 בקשות ל-100 שניות לכל משתמש, ואפשר לשנות אותו לערך מקסימלי של 1,000. עם זאת, מספר הבקשות ל-API מוגבל ל-10 בקשות לשנייה לכל משתמש לכל היותר.
    • אם האפליקציה שלכם שולחת את כל בקשות ה-API מכתובת IP יחידה (כלומר בשם המשתמשים שלכם), השתמשו בפרמטר userIP או quotaUser בכל בקשה כדי לקבל את מכסת ה-QPS המלאה לכל משתמש. לפרטים נוספים, קראו את סיכום הפרמטרים הרגילים של שאילתות.

ממשקי API לניהול

מערכת Google Analytics מחילה מכסות על בקשות לממשקי ה-API הבאים לניהול:

כתיבת ממשקי API

המכסות האלה חלות על בקשות הכתיבה (insert, update, patch ו-delete):

  • 50 בקשות כתיבה לכל פרויקט ביום, ניתן להגדיל
  • 1.5 שאילתות לשנייה (QPS) לכל מספר חשבון

כתיבת שגיאות בבקשות

אם בקשת הכתיבה שלכם נכשלת וקיבלתם קוד תגובה 500 או 503, אתם יכולים לשלוח אותו מחדש. מערכת Google Analytics מאפשרת:

  • 50 בקשות כתיבה שנכשלו בשעה.

אם תנסו לשלוח יותר מ-50 בקשות כתיבה שנכשלו בשעה, תקבלו את השגיאה הבאה:

Quota Error: The number of recent failed writes is too high.

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

ממשק API לייבוא נתונים

המכסות האלה הן ספציפיות למשאב Uploads:

  • מגבלות האחסון של ייבוא נתונים מורחבים בכל משך החיים (לא חלות על נתוני היטים שנשלחים מערכות ה-SDK וממשקי ה-API של האוסף):
  • 50 מערכי נתונים לכל נכס
  • 50 פעולות העלאה לכל נכס ביום
  • 1GB לכל קובץ שהועלה
  • מגבלות ספציפיות לנתוני עלות:
    • 100 MB לכל תאריך (ga:date) לכל קבוצת נתונים. לדוגמה, במקרה שמייבאים נתונים של 50 MB של 2014-10-10 בהעלאה אחת, ונתוני 50 MB עבור 2014-10-10 בהעלאה שנייה, הגעתם למגבלה של 100MB של 2014-10-10 עבור קבוצת נתונים זו.

ממשק API של ניסויים

המכסה הזו רלוונטית רק לניסויים:

  • 12 ניסויים לכל תצוגה מפורטת (פרופיל)

ניסויים עם אחד מהערכים הבאים של statuses נכללים במכסה הזו:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

הניסויים שהסתיימו (סטטוס = ENDED) למשך יותר מיום אחד לא נכללים במכסה הזו.

ממשק API של דוחות ללא דגימה

המכסות האלה חלות רק על דוחות ללא דגימה:

  • בקשות API ליצירת דוחות ללא דגימה נספרות במכסת הבקשות לכתיבה הכללית.
  • ה-API משתמש באותה מערכת אסימונים לכל נכס, ליום שבה משתמש ממשק האינטרנט כדי ליצור דוחות ללא דגימה.
  • המספר המקסימלי של דוחות ללא דגימה הוא 3,500. כשמגיעים למגבלה הזו, כשמנסים ליצור דוחות נוספים ללא דגימה ב-API מקבלים את השגיאה הבאה: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

ממשק API להרשאות משתמש

המכסה הזו חלה רק על הרשאות משתמש:

  • למשתמש יכולים להיות עד 100 חשבונות Analytics. כשמוסיפים משתמש שיש לו 100 חשבונות Analytics לחשבון חדש, מתקבלת שגיאה.

המכסות הבאות חלות על בקשות כתיבה מקובצות (delete, insert, update) להרשאות משתמשים:

  • 300 בקשות לכתיבה להרשאות משתמש בכל בקשה באצווה
  • 30 אצווה של בקשות כתיבה להרשאות משתמש נספרו כבקשת כתיבה אחת

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

אם תחרגו ממכסת הבקשות ל-Google Analytics API, ה-API יחזיר קוד שגיאה 403 או 429 ותוצג הודעה על כך שהחשבון חרג מהמכסה. למידע נוסף, כדאי לעיין בתנאים ובהגבלות.

בקשה להגדלת מכסה

אפשר לבקש להגדיל רק את:

כדי לראות או לשנות את מגבלות השימוש בפרויקט, או כדי לבקש להגדיל את המכסה:

  1. אם עדיין אין לכם חשבון לחיוב בפרויקט, יוצרים חשבון.
  2. נכנסים לדף Enabled APIs של ספריית ה-API ב-API Console ובוחרים ממשק API מהרשימה.
  3. כדי להציג ולשנות הגדרות שקשורות למכסות, בוחרים באפשרות Quotas. כדי להציג סטטיסטיקות שימוש, בוחרים באפשרות Usage (שימוש).

כדי לבקש הגדלה של המכסה המקסימלית, צריך להשתמש בטופס הבקשה למכסה ב-Analytics API. חשוב לבדוק את הפרטים ולפעול לפי ההוראות בטופס הבקשה למכסה לפני שליחת הבקשה. בגרסה 4 של Reporting API, שם ה-API במסוף Google API הוא Google Analytics Reporting API. כל שאר ממשקי ה-API האחרים של v3 (למשל, Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) מופיעים בקטע Analytics API במסוף Google API.

במאמר ניהול מכסות ושימוש במכסות תוכלו לקרוא מידע נוסף על ניהול המכסות ועל צמצום המכסות באפליקציה.