Method: customers.profiles.list

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

בקשת HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

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

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

פרמטרים
parent

string

חובה. פורמט: customer/{customer_id}

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

פרמטרים
pageSize

integer

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

string

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

string

זה שינוי אופציונלי. המסנן שמשמש לסינון פרופילים. אפשר להשתמש בשדות הבאים במסנן:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • ouId

אפשר להשתמש בכל אחד מהשדות שלמעלה כדי לציין מסנן, ויש תמיכה בסינון לפי כמה שדות באמצעות אופרטור AND. שדות של סוג מחרוזת ושדות של סוג enum תומכים באופרטורים '=' ו-'!='. השדות מסוג מספר שלם ומסוג חותמת זמן תומכים באופרטורים '=', '!=', '<', '>', '<=' ו-'>='. חותמות הזמן צריכות להיות בפורמט של מחרוזת RFC-3339 (למשל 2012-04-21T11:30:00-04:00). אפשר להשתמש בתווים הכלליים לחיפוש '*' עם מסנן שדה מסוג מחרוזת. בנוסף, קיימת תמיכה בסינון ליטרל של מחרוזות. לדוגמה, 'ABC' כמסנן שממופה אל מסנן שבודק אם אחד מהשדות של סוגי המחרוזת שניתן לסנן מכיל את 'ABC'.

אפשר להשתמש במספר של היחידה הארגונית כקריטריונים לסינון כאן, על ידי ציון 'ouId = ${your_org_unit_id}'. לתשומת ליבך, יש תמיכה רק בהתאמה של מזהה יחידה ארגונית אחד.
orderBy

string

זה שינוי אופציונלי. השדות שמשמשים לציון סדר התוצאות. השדות הנתמכים הם:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState

כברירת מחדל, המיון הוא בסדר עולה. כדי לציין סדר יורד בשדה, צריך להוסיף לשם השדה סיומת 'ירידה'. סדר ברירת המחדל הוא סדר יורד של lastStatusReportTime.

גוף הבקשה

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

גוף התשובה

תגובה לשיטה profiles.list.

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

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

object (ChromeBrowserProfile)

רשימת הפרופילים שהוחזרו.
nextPageToken

string

אסימון העימוד שאפשר להשתמש בו כדי להציג את הדף הבא.
totalSize

string (int64 format)

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

היקפי ההרשאות

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

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