Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

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

בקשת HTTP

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

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

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

פרמטרים
customer

string

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

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

פרמטרים
pageSize

integer

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

string

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

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

string

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

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

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

אופרטורים נתמכים: ‎- = ל-user,‏ event_domain ו-content_category. ‫- <= למשך event_time.

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

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

enum (ContentTransfersMetric)

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

enum (ContentTransfersBreakdownDimension)

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

enum (FixedTimeRange)

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (ContentTransfersBreakdown)

פירוט של העברת התוכן מהתובנה שצוינה.
nextPageToken

string

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

היקפי הרשאות

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

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

ContentTransfersBreakdownDimension

המאפיין שלפיו יפורטו העברות התוכן.

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

ContentTransfersBreakdown

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

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

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

object (ContentTransfersSummary)

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

string

המשתמש שהעביר את התוכן.
eventDomain

string

דומיין האירוע של העברות התוכן.
contentCategory

string

קטגוריית התוכן של העברות התוכן.