Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

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

בקשת HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
customer

string

חובה. מספר הלקוח בפורמט customers/{customer_id}.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

אופציונלי. מספר הפירוטים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר לכל היותר 50 פירוטים. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של securityInsights.queryUrlVisitsBreakdowns. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-securityInsights.queryUrlVisitsBreakdowns חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
filter

string

אופציונלי. המסנן שיוחל על הבקשה. למידע על התחביר, אפשר לעיין ב-AIP-160. הנתונים לא זמינים לאירועים שהתרחשו לפני יותר מ-180 ימים או לפני פחות מ-48 שעות. אם לא מציינים את event_time, התוצאות יסתיימו 48 שעות לפני מועד הבקשה.

שדות נתמכים לסינון: – user – event_domain – event_time

כדי לסנן לפי user או event_domain, צריך להגדיר את המאפיין breakdown לערך המתאים (לדוגמה, צריך להגדיר את breakdown = USER כדי לסנן לפי user).

אופרטורים נתמכים: – = עבור user ו-event_domain. ‫- <= למשך event_time.

מילות קישור נתמכות: – AND

לדוגמה: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

אופציונלי. המדד שעבורו רוצים להחזיר את פירוטי המשנה. ברירת המחדל היא URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

אופציונלי. המאפיין שלפיו יחולק פירוט הביקורים בכתובת ה-URL. ברירת המחדל היא USER.
fixedTimeRange

enum (FixedTimeRange)

אופציונלי. טווח הזמן הקבוע שבו רוצים לקבל את הפירוטים. ברירת המחדל היא FIXED_TIME_RANGE_FOUR_WEEKS. השימוש בטווחים קבועים של זמן מאפשר לבצע חישוב מראש ולשפר את זמני התגובה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת תגובה ל-securityInsights.queryUrlVisitsBreakdowns.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
שדות
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

פירוט הביקורים בכתובת ה-URL מהתובנה שצוינה.
nextPageToken

string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
  • https://www.googleapis.com/auth/chrome.management.securityinsights

UrlVisitsBreakdownDimension

המאפיין שלפיו יחולק פירוט הביקורים בכתובת ה-URL.

טיפוסים בני מנייה (enum)
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED מאפיין פירוט לא צוין. ברירת המחדל היא USER.
USER פירוט לפי משתמש.
EVENT_DOMAIN פירוט לפי דומיין האירוע.

UrlVisitsBreakdown

סיכום של ביקורים בכתובת URL עבור מאפיין פירוט נתון.

ייצוג ב-JSON 
{
  "summary": {
    object (UrlVisitsSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string
  // End of list of possible types for union field dimension.
}
שדות
summary

object (UrlVisitsSummary)

סיכום של ביקורים בכתובת URL עבור מאפיין החלוקה.
שדה איחוד dimension. המאפיין שלפיו מתבצע הפירוט. הערך dimension יכול להיות רק אחד מהבאים:
user

string

המשתמש שביקר בכתובת ה-URL.
eventDomain

string

דומיין האירוע של ביקורים בכתובת URL.