המגבלות והמכסות הבאות חלות על Data API.
איך המכסות חלות
כל הבקשות אל Google Analytics Data API v1 מחייבות פרויקט בענן ב-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 |
| טוקנים של משפך לכל נכס לשעה | 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, שבו מפורטים הטוקנים שנצרכו בבקשה הספציפית הזו ויתרות המכסות שנותרו.