Method: customers.enterprise.securityInsights.queryUrlVisits

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

בקשת HTTP

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

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

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

פרמטרים
customer

string

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

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

פרמטרים
filter

string

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

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

אופרטורים נתמכים: ‎- >= ו-<= ל-event_time

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

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

גוף הבקשה

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

גוף התשובה

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

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

ייצוג ב-JSON 
{
  "summaries": [
    {
      object (UrlVisitsSummary)
    }
  ]
}
שדות
summaries[]

object (UrlVisitsSummary)

אוסף של סיכומים של מדדים שונים של ביקורים בכתובות URL.

היקפי הרשאות

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

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