המגבלות והמכסות הבאות חלות על Data API.
איך המכסות חלות
כל הבקשות לגרסה 1 של Google Analytics Data API מחייבות פרויקט ב-Google Cloud וכפופות למכסות שמפורטות בדף הזה. המכסות נצרכות ללא קשר לשיטה שבה משתמשים כדי לזהות את הפרויקט שממנו מתבצעת הקריאה, כולל:
- בקשות שאומתו באמצעות פרטי כניסה של OAuth 2.0.
- בקשות שאומתו באמצעות מפתח API בלבד.
מפתחות API משמשים לשיוך בקשה לפרויקט ספציפי ב-Google Cloud לצורכי מכסה וחיוב. כל הקריאות ל-API שמתבצעות באמצעות פרטי כניסה או מפתח API מהפרויקט שלכם ייספרו במכסות הרלוונטיות של הפרויקט ושל נכס Google Analytics.
קטגוריות מכסות
ל-Data API יש שלוש קטגוריות של מכסות בקשות: Core, Realtime ו-Funnel. בקשות ל-API לשיטות ליבה מחויבות במכסות ליבה. בקשות API לשיטות של זמן אמת מחויבות במכסות של זמן אמת. כל בקשה צורכת רק סוג אחד של מכסה.
| קטגוריית מכסה | שיטות API |
|---|---|
| ליבה | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| זמן אמת | runRealtimeReport |
| משפך | runFunnelReport |
מכסות בנכס Analytics
כל הבקשות צורכות מכסות של נכסים.
| שם המכסה | הגבלה בנכס רגיל | מגבלת נכסים ב-Analytics 360 |
|---|---|---|
| טוקנים מרכזיים לכל נכס ביום | 200,000 | 2,000,000 |
| Core Tokens Per Property Per Hour | 40,000 | 400,000 |
| טוקנים מרכזיים לכל פרויקט, לכל נכס, לכל שעה | 14,000 | 140,000 |
| בקשות ליבה בו-זמניות לכל נכס | 10 | 50 |
| שגיאות ליבה בשרת לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
| טוקנים בזמן אמת לכל נכס ביום | 200,000 | 2,000,000 |
| טוקנים בזמן אמת לכל נכס לשעה | 40,000 | 400,000 |
| טוקנים בזמן אמת לכל פרויקט, לכל נכס, לכל שעה | 14,000 | 140,000 |
| בקשות מקבילות בזמן אמת לכל נכס | 10 | 50 |
| שגיאות בשרת בזמן אמת לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
| טוקנים של משפך לכל נכס ביום | 200,000 | 2,000,000 |
| Funnel Tokens Per Property Per Hour | 40,000 | 400,000 |
| Funnel Tokens Per Project Per Property Per Hour | 14,000 | 140,000 |
| בקשות בו-זמניות במשפך לכל נכס | 10 | 50 |
| שגיאות בחיבור לשרת במשפך לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
- בקשות בו-זמניות נמדדות לפי מספר הבקשות שמופעלות בו-זמנית. כדי לצמצם את מספר הבקשות המקבילות, צריך לחכות שהבקשות הקודמות יושלמו לפני ששולחים בקשות נוספות.
- שגיאות שרת הן קודים 500 ו-503. המכסות של שגיאות בחיבור לשרת נספרות רק כשבקשה גורמת לשגיאה בחיבור לשרת. כשמגיעים למכסה של שגיאות שרת עבור פרויקט וזוג נכסים, כל הבקשות לנכס מהפרויקט נחסמות.
- כל בקשה צורכת מכסה של Tokens Per Property Per Hour וגם של Tokens Per Project Per Property Per Hour. המשמעות היא שצריך לגשת לנכס אחד ביותר מ-3 פרויקטים כדי שהמכסה 'אסימונים לכל נכס לשעה' תנוצל במלואה לפני המכסה 'אסימונים לכל פרויקט לכל נכס לשעה'.
לכל נכס מותר לשלוח עד 120 בקשות לשעה שעשויות להיות מוגבלות. יכול להיות שהמדדים userAgeBracket, userGender, brandingInterest, audienceId ו-audienceName עברו סינון. המטרה של ערכי הסף היא למנוע ממי שצופה בדוח להסיק ממנו נתונים דמוגרפיים או תחומי עניין של משתמשים ספציפיים.
מכסת טוקנים של נכסים
החישוב של האסימונים מתבצע בכל בקשה בהתאם למורכבות שלה. ברוב הבקשות יחויבו 10 טוקנים או פחות. כשבקשה צורכת מספר גדול של טוקנים של מכסה, בדרך כלל זה קורה בגלל הגורמים הבאים:
- מספר גדול של שורות
- מספר גדול של עמודות
- קריטריונים מורכבים לסינון
- טווח תאריכים ארוך
בכל בקשת API, אפשר לציין "returnPropertyQuota": true בתוכן הבקשה כדי לקבל את הסטטוס הנוכחי של טוקנים של מכסת הנכס. הסטטוס הזה כולל את הכמות שנוצלה בבקשה הזו ואת הכמות שנותרה בכל קבוצת מכסות. לדוגמה, אפשר לציין את הפרמטר הזה ב-RunReportRequest.