Method: customers.reports.findSaasUsageBrowsers

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

בקשת HTTP

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

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

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

פרמטרים
customer

string

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

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

פרמטרים
app

string

חובה. השם של אפליקציית ה-SaaS (למשל, ChatGPT, ‏ Gemini).
pageSize

integer

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

string

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

string

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

שדות נתמכים:

  • מכונה
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

שדות נתמכים:

  • מכונה
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (SaasUsageBrowser)

רשימת דוחות הדפדפנים של השימוש ב-SaaS.
nextPageToken

string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא.
totalSize

string (int64 format)

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

היקפי הרשאות

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

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

SaasUsageBrowser

פרטים של דפדפן שמשמש לשימוש ב-SaaS.

ייצוג JSON 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
שדות
machine

string

פלט בלבד. שם המחשב.
devicePermanentId

string

פלט בלבד. המזהה הקבוע של המכשיר.
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".
orgUnitId

string

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

enum (DeviceSystem)

פלט בלבד. פלטפורמת מערכת ההפעלה.
osVersion

string

פלט בלבד. גרסת מערכת ההפעלה.