Method: customers.reports.findInstalledAppProfiles

יצירת דוח של פרופילים מנוהלים ב-Chrome שבהם מותקנת אפליקציה מסוימת.

בקשת HTTP

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

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

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

פרמטרים
customer

string

חובה. מספר הלקוח או הערך my_customer כדי להשתמש בלקוח שמשויך לחשבון שממנו נשלחת הבקשה.

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

פרמטרים
orgUnitId

string

אופציונלי. המזהה של היחידה הארגונית.
appId

string

חובה. מזהה ייחודי של האפליקציה. באפליקציות ובתוספים ל-Chrome, המזהה הוא בן 32 תווים (לדוגמה: ehoadneljpdggcbbknedodolkkjodefl). באפליקציות ל-Android, שם החבילה (למשל, com.evernote).
pageSize

integer

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

string

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

string

אופציונלי. השדה שמשמש לסידור התוצאות.

שדות נתמכים למיון:

  • אימייל
  • profileId
  • profilePermanentId
filter

string

אופציונלי. מחרוזת שאילתה לסינון תוצאות, שדות מופרדים באמצעות AND בתחביר EBNF.

הערה: פעולות OR לא נתמכות במסנן הזה.

שדות המסננים הנתמכים:

  • last_active_date
appType

enum (AppType)

סוג האפליקציה. אופציונלי. אם לא מספקים את סוג האפליקציה, המערכת מסיקה אותו מפורמט מזהה האפליקציה.

גוף הבקשה

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

גוף התשובה

תגובה שמכילה רשימה של פרופילים שבהם האפליקציה שביקשתם מותקנת.

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

ייצוג ב-JSON 
{
  "profiles": [
    {
      object (ProfileAppInstallInstance)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
שדות
profiles[]

object (ProfileAppInstallInstance)

רשימה של פרופילים שבהם האפליקציה מותקנת. העמודה ממוינת בסדר אלפביתי עולה בשדה profile.Email.
nextPageToken

string

אסימון שמציין את הדף הבא של הבקשה.
totalSize

integer

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

היקפי הרשאות

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

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

ProfileAppInstallInstance

מתאר דוח פרופיל שמכיל מידע על פרופיל Chrome.

ייצוג ב-JSON 
{
  "profileId": string,
  "profilePermanentId": string,
  "email": string,
  "profileOrgUnitId": string
}
שדות
profileId

string

פלט בלבד. מזהה הפרופיל בצד הלקוח ב-Chrome.
profilePermanentId

string

פלט בלבד. מזהה קבוע של פרופיל הוא מזהה ייחודי של פרופיל בתוך לקוח אחד.
email

string

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

string

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