המגבלות והמכסות הבאות חלות על Data API.
איך המכסות חלות
כל הבקשות לגרסה 1 של Google Analytics Data API מחייבות פרויקט ב-Google Cloud וכפופות למכסות שמפורטות בדף הזה. המכסות נצרכות ללא קשר לשיטה שבה משתמשים כדי לזהות את הפרויקט שמבצע את הקריאה, כולל:
- בקשות שאומתו באמצעות פרטי כניסה של OAuth 2.0.
- בקשות שאומתו באמצעות מפתח API בלבד.
מפתחות API משמשים לשיוך בקשה לפרויקט ספציפי בענן של Google לצורכי מכסה וחיוב. כל הקריאות ל-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 עברו סינון. המטרה של ערכי הסף היא למנוע ממי שצופה בדוח להסיק ממנו נתונים דמוגרפיים או תחומי עניין של משתמשים ספציפיים.
מכסת טוקנים של נכסים
כל בקשה ל-Google Analytics Data API v1 צורכת טוקנים. מספר הטוקנים שחויבו תלוי במורכבות הבקשה. רוב הבקשות יחייבו 10 טוקנים או פחות, אבל בקשות מורכבות יותר יחייבו יותר טוקנים.
גורמים שמשפיעים על צריכת האסימונים
העלות המדויקת של האסימון עבור בקשה נקבעת בזמן הביצוע, ולכן קשה לבצע חישוב מדויק מראש. העלות מושפעת משילוב של גורמים שקשורים לבקשה עצמה ולנתונים הבסיסיים בנכס ב-Google Analytics. הגורמים האלה יכולים להוביל לעלויות גבוהות יותר:
- מספר השורות: בקשה של מספר גדול יותר של שורות.
- מספר המאפיינים והמדדים: כולל מספר גדול יותר של מאפיינים ומדדים.
- מורכבות הסינון: שימוש בביטויי סינון מורכבים.
- אורך טווח התאריכים: שאילתות שמתפרסות על תקופות ארוכות יותר.
- עוצמת הנתונים (cardinality): מאפיינים בעלי עוצמה גבוהה (הרבה ערכים ייחודיים, כמו
pagePath, מאפיינים מותאמים אישית) יכולים להגדיל באופן משמעותי את עלות האסימונים. - נפח האירועים בנכס: שאילתות בנכסים עם נפח גבוה יותר של אירועים עשויות לצרוך יותר טוקנים מאשר אותה שאילתה בנכס עם פחות נתונים.
מעקב אחרי השימוש בטוקנים
הדרך היעילה ביותר לקבוע את עלות הטוקנים עבור קריאות ספציפיות ל-API היא לכלול את הפרמטר "returnPropertyQuota": true בגוף הבקשה.
התשובה של ה-API תכלול את האובייקט PropertyQuota, שבו מפורטים הטוקנים שנצרכו בבקשה הספציפית הזו ויתרות המכסות שנותרו.