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

מסמך זה מתאר את המגבלות ואת המכסות לבקשת ממשקי API לניהול ואת ממשקי ה-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 קיימת מכסה דומה שנקראת בקשות ל-100 שניות לכל משתמש. כברירת מחדל, היא מוגדרת ל-100 בקשות לכל 100 שניות לכל משתמש, וניתן להתאים אותה לערך מקסימלי של 1,000. עם זאת, מספר הבקשות ל-API מוגבל ל-10 בקשות לשנייה לכל משתמש.
    • אם האפליקציה שלכם שולחת את כל בקשות ה-API מכתובת IP יחידה (כלומר, בשם המשתמשים שלכם), תוכלו להשתמש בפרמטר userIP או quotaUser בכל בקשה כדי לקבל מכסה מלאה של QPS לכל משתמש. פרטים נוספים זמינים בסיכום של פרמטרים רגילים של שאילתות.

Reporting APIs

המכסות הבאות חלות על כל ממשקי ה-API של דיווח, כולל Core Reporting API v3, Analytics Reporting API v4, Real Time API v3 ו-Multi-channel API API v3:

  • 10,000 בקשות לכל צפייה (פרופיל) ביום (לא ניתן להגדיל)
  • 10 בקשות בו-זמנית לכל צפייה (פרופיל) (לא ניתן להגדיל)

שגיאות בבקשות API של דיווח

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

  • 10 שגיאות שרת שנכשלו בכל פרויקט לצפייה (פרופיל) לשעה
  • 50 שגיאות שרת שנכשלו בכל פרויקט לצפייה (פרופיל) ליום

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

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

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

אין לשלוח שוב ושוב בקשה שנכשלה. במקום זאת, צריך להטמיע השהיה מעריכית השהיה כדי לשלוח אותה מחדש.

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

לדוגמה, אם צמד פרויקט ותצוגה לא שלחו שגיאת שרת ב-24 השעות האחרונות, לפרויקט הזה ולתצוגה המפורטת הזו נעשה שימוש ב-0 מתוך מכסת 50 שלו. נניח שפרויקט ותצוגה אלה שולחים עכשיו שגיאת שרת בשעה 6:12. אם הפרויקט והתצוגה הזו שולחים 49 שגיאות שרת נוספות לפני 6:12 ביום שלמחרת, הפרויקט והתצוגה האלה ייחסמו עד 6:12 ביום שלמחרת. בשעה 06:12 ביום שלמחרת, מכסת השיעור של שגיאות השרת תאופס לגמרי בפרויקט ובתצוגה המפורטת האלה.

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

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

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

אתם יכולים רק לבקש להגדיל את הפעילות:

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

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

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

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