Method: customers.reports.findSaasUsageProfiles

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

בקשת HTTP

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

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

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

פרמטרים
customer

string

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

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

פרמטרים
app

string

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

integer

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

string

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

string

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

שדות נתמכים:

  • אימייל
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

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

שדות נתמכים:

  • אימייל
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (SaasUsageProfileReport)

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

string

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

string (int64 format)

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

היקפי הרשאות

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

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

SaasUsageProfileReport

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

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

string

פלט בלבד. כתובת האימייל של המשתמש.
profilePermanentId

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

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