Method: customers.reports.findSaasUsage

חיפוש דוחות שימוש ב-SaaS של לקוח על סמך קריטריונים נתונים לחיפוש ולמיון.

בקשת HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsage

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

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

פרמטרים
customer

string

חובה. מספר לקוח שעבר טשטוש, עם הקידומת customers/C או customers/my_customer.

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

פרמטרים
pageSize

integer

אופציונלי. מספר הדוחות המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר עד 100 דוחות. הערך המקסימלי הוא 200. ערכים גבוהים יותר יומרו ל-200.
pageToken

string

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

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

string

אופציונלי. ביטוי המסנן לצמצום התוצאות של דוחות ה-SaaS. האופרטורים הנתמכים הם: =, ‏!=, ‏<, ‏<=, ‏>, ‏>=, ‏:. האופרטורים הלוגיים AND,‏ OR ו-NOT נתמכים.

שדות נתמכים:

  • אפליקציה
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • קטגוריה
  • ארגון
  • foundedYear
  • משרד ראשי
  • primaryDomain
  • דומיינים
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

לדוגמה: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

אופציונלי. הביטוי למיון דוחות ה-SaaS.

שדות נתמכים:

  • אפליקציה
  • קטגוריה
  • ארגון
  • foundedYear
  • משרד ראשי
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

ברירת המחדל היא בסדר עולה. כדי לציין סדר יורד בשדה, מוסיפים את המחרוזת ' desc'.

לדוגמה: visitsCount desc

גוף הבקשה

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

גוף התשובה

תגובה לשיטת reports.findSaasUsage.

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

ייצוג JSON 
{
  "saasReports": [
    {
      object (SaasUsageReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
שדות
saasReports[]

object (SaasUsageReport)

רשימת דוחות השימוש ב-SaaS.
nextPageToken

string

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

string (int64 format)

המספר הכולל של דוחות השימוש ב-SaaS שתואמים לבקשה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

SaasUsageReport

מייצג רשומה אחת בדוח SaaS.

ייצוג JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
שדות
app

string

פלט בלבד. שם האפליקציה.
orgUnitId

string

פלט בלבד. המזהה של היחידה הארגונית.
category

string

פלט בלבד. הקטגוריה של האפליקציה.
organization

string

פלט בלבד. הארגון שמפתח את האפליקציה.
foundedYear

integer

פלט בלבד. השנה שבה הארגון נוסד.
headquarters

string

פלט בלבד. מיקום המטה של הארגון.
primaryDomain

string

פלט בלבד. הדומיין הראשי של האפליקציה.
domains[]

string

פלט בלבד. רשימה של דומיינים ותת-דומיינים שמשויכים לאפליקציה.
encryptionProtocols[]

string

פלט בלבד. רשימה של פרוטוקולי הצפנה שמשמשים לגישה לאפליקציה.
visitsCount

string (int64 format)

פלט בלבד. המספר הכולל של ביקורים באפליקציה.
distinctUsersCount

string (int64 format)

פלט בלבד. מספר המשתמשים הייחודיים שביקרו באפליקציה.
distinctBrowsersCount

string (int64 format)

פלט בלבד. מספר הדפדפנים הייחודיים שביקרו באפליקציה.
contentTransferDetails

object (ContentTransferDetails)

פלט בלבד. מספק מידע על אירועי העברת תוכן, אם יש כאלה.
firstNavigationTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

ContentTransferDetails

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

ייצוג JSON 
{
  "contentTransferCount": string
}
שדות
contentTransferCount

string (int64 format)

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