המגבלות והמכסות הבאות חלות על Data API.
קטגוריות מכסות
ל-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 |
| Core Tokens לכל פרויקט, לכל נכס, לשעה | 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 |
| מספר הטוקנים במשפך לכל פרויקט לכל נכס לכל שעה | 14,000 | 140,000 |
| מספר הבקשות בו-זמנית במשפך לכל נכס | 10 | 50 |
| מספר שגיאות השרת במשפך לכל פרויקט לכל נכס לשעה | 10 | 50 |
- מספר הבקשות בו-זמנית נמדד לפי מספר הבקשות שמבוצעות בו-זמנית. כדי לצמצם את מספר הבקשות בו-זמנית, צריך להמתין להשלמת הבקשות הקודמות לפני ששולחים בקשות נוספות.
- שגיאות שרת הן קודים 500 ו-503. החיוב על מכסות של שגיאות בחיבור לשרת מתבצע רק כשבקשה מובילה לשגיאת שרת. כשהמכסות של שגיאות השרת ינוצלו בפרויקט ובנכס, כל הבקשות מהנכס לפרויקט ייחסמו.
- כל בקשה צורכת מכסה גם של טוקנים לכל נכס לשעה וגם של טוקנים לכל פרויקט לכל נכס לשעה. כלומר, כדי למצות את המכסה 'אסימונים לכל נכס לשעה', צריך להיות גישה לנכס אחד מיותר מ-3 פרויקטים, לפני שמיצוה המכסה 'אסימונים לכל פרויקט לכל נכס לשעה'.
לכל נכס מותר לשלוח 120 בקשות שעומדות בתנאי הסף בכל שעה. יכול להיות שנקבע ערך סף למאפיינים userAgeBracket, userGender, brandingInterest, audienceId ו-audienceName. המטרה של ערכי הסף היא למנוע ממי שצופה בדוח להסיק ממנו נתונים דמוגרפיים או תחומי עניין של משתמשים ספציפיים.
מכסת טוקנים של נכס
האסימונים מחושבים בכל בקשה בהתאם למורכבות שלה. ברוב הבקשות יחויבו 10 טוקנים או פחות. כשבקשה צורכת מספר גדול של אסימוני מכסה, לרוב הגורמים הבאים יש קשר לכך:
- מספר גדול של שורות
- מספר גדול של עמודות
- קריטריונים מורכבים לסינון
- טווח תאריכים ארוך
בכל בקשת API, אפשר לציין את הערך "returnPropertyQuota": true בגוף הבקשה כדי לקבל את הסטטוס הנוכחי של אסימוני המכסה של הנכס. הסטטוס הזה מכיל גם את הסכום שהבקשה הזו ניצלה וגם את הסכום שנותר בכל קבוצת מכסות. לדוגמה, אפשר לציין את הפרמטר הזה ב-RunReportRequest.