Method: customers.profiles.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

חובה. פורמט: customers/{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
  • osPlatformVersion
  • 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
  • osPlatformVersion

כברירת מחדל, המיון הוא בסדר עולה. כדי לציין מיון יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. סדר ברירת המחדל הוא סדר יורד של 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