מכסה מבוססת משאבים

במאמר הזה מתוארת מערכת Resource Quota Quota ב-Google Analytics Reporting API v4, שזמינה רק ללקוחות Analytics 360. במאמר מגבלות ומכסות של API מפורטות המגבלות המלאות שחלות על ממשקי ה-API.

מבוא

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

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

מכסה על בסיס משאבים

לא כל הבקשות נוצרות באופן שווה; בקשות מסוימות יקרות יותר מבחינה חישובית בהרבה מאחרות. מערכת המכסות על בסיס המשאבים תוכננה לתמוך בסף גבוה יותר של דגימה ועדיין להגן על תשתית הדוחות של Analytics.

לכל נכס יוקצה כמות מוגדרת של אסימונים למשאבי שאילתות. לקוח ה-API יכול להוסיף שדה אופציונלי לבקשת ה-API כדי לקבל סף גבוה יותר לדגימה בתמורה לאסימונים היחסיים של משאב השאילתות. לגבי בקשה יקרה יותר מבחינה חישובית, יידרשו יותר אסימונים.

סף הדגימה

בקשות לנתונים באמצעות Google Analytics API v4 כפופות לספי הדגימה הכלליים הבאים, על סמך מספר הסשנים בטווח התאריכים המבוקש (ברמת הנכס):

  • Analytics Standard: 500,000 ביקורים
  • Analytics 360: מיליון סשנים
  • מכסה מבוססת-משאבים ב-Analytics 360: 100 מיליון סשנים

הפעלת מכסה מבוססת משאבים

כדי להפעיל מכסות שמבוססות על משאבים בבקשה נתונה, הקריאה ל-API חייבת לכלול את השדה האופציונלי useResourceQuotas בשיטה batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

למשל:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

שדה תגובה של עלות משאב של שאילתה

עבור כל קריאה ל-method batchGet, התשובה תכלול שדה queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

השדה queryCost הוא מספר שלם שמייצג את עלות המשאב הכוללת של כל ReportRequests בבקשה batchGet. למשל:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

הקצאת מכסה

מכסה של נכסי Analytics 360

  • 100,000 יחידות עלות של שאילתות ליום לכל נכס.
  • 25,000 יחידות עלות של שאילתות לשעה לכל נכס.

אם תחרגו מהמכסה, תקבלו הודעת שגיאה RESOURCE_EXHAUSTED. פרטים נוספים זמינים בקטע תגובות לשגיאות.

חישוב העלויות

העלות של בקשה היא יחסי ל:

  • הגודל של טווח התאריכים.
  • מספר ההיטים בתצוגה המפורטת.
  • העוצמה של המאפיינים המבוקשים.
  • מספר המאפיינים והמדדים המבוקשים.
  • המורכבות של הגדרות פלחים ומסננים.
  • סטטוס העיבוד של המידע המבוקש (בקשת הנתונים של היום יקרה יותר מבקשת הנתונים מאתמול).
  • נוכחות המאפיינים והמדדים של ייבוא בזמן השאילתה.

מגבלות API והשימוש בהן

בנוסף למערכת המכסות שמבוססת על משאבים, ממשקי ה-API כפופים גם למגבלות והמכסות של Analytics API v4.

הערות

  • שדה התגובה queryCost מייצג את העלות המחושבת של בקשה. זו לא עלות כספית, והשימוש ב-API הוא בחינם.
  • ייתכן שיידגמו דוחות של נתונים יומיים ונתונים היסטוריים מסוימים (מגיל שנה ומעלה), ללא קשר להגדרה useResourceQuotas.
  • אם לא ניתן למלא סף דגימה גבוה יותר לבקשה מסוימת, האסימונים של מכסת המשאבים לא ינוכו (התגובות שנדגמו תמיד מניבות עלות של אפס משאבים).
  • הדוח מכיל נתונים שנדגמו אם יש בתגובה את השדות samplesReadCounts ו-samplingSpaceSizes.

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

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