Method: customers.reports.findInstalledAppDevices

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customer

string

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

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

פרמטרים
orgUnitId

string

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

string

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

enum (AppType)

סוג האפליקציה.
pageSize

integer

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

string

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

string

שדה המשמש להזמנת התוצאות.

סדר נתמך לפי שדות:

  • מכונה
  • deviceId
filter

string

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

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

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

  • last_active_date

גוף הבקשה

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

גוף התשובה

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

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

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

object (Device)

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

string

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

integer

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

היקפי הרשאות

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

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

מכשיר

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

ייצוג JSON 
{
  "deviceId": string,
  "machine": string
}
שדות
deviceId

string

פלט בלבד. מזהה המכשיר שדיווח על המידע הזה מדפדפן Chrome.
machine

string

פלט בלבד. שם המכונה ברשת המקומית שלה.