יצירת דוח על מכשירים עם דפדפן Chrome מנוהל שמותקנת בהם אפליקציה מסוימת.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customer |
חובה. Customer id או 'my_customer' כדי להשתמש בלקוח שמשויך לחשבון שמבצע את הבקשה. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
orgUnitId |
המזהה של היחידה הארגונית. |
appId |
המזהה הייחודי של האפליקציה. באפליקציות ובתוספים של Chrome, המזהה מורכב מ-32 תווים (למשל, ehoadneljpdggcbbknedodolkkjodefl). באפליקציות ל-Android, שם החבילה (למשל, com.evernote). |
pageSize |
המספר המקסימלי של תוצאות להחזרה. הערך המקסימלי והערך שמוגדר כברירת מחדל הם 100. |
pageToken |
אסימון לציון הדף של הבקשה שיוחזר. |
orderBy |
השדה שבו נעשה שימוש כדי למיין את התוצאות. שדות נתמכים לסדר לפי:
|
filter |
מחרוזת שאילתה לסינון תוצאות, שדות מופרדים ב-AND בסינטקס EBNF. הערה: אי אפשר להשתמש בפעולות OR (או) במסנן הזה. שדות מסנן נתמכים:
|
appType |
סוג האפליקציה. אופציונלי. אם לא תספקו את סוג האפליקציה, המערכת תסיק את סוג האפליקציה מהפורמט של מזהה האפליקציה. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה שמכילה רשימה של מכשירים שבהם מותקנת האפליקציה שבה בוצעה השאילתה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{
"devices": [
{
object ( |
שדות | |
---|---|
devices[] |
רשימה של מכשירים שבהם מותקנת האפליקציה. ממוינים בסדר אלפביתי עולה בשדה Device.machine. |
nextPageToken |
אסימון לציון הדף הבא בבקשה. |
totalSize |
המספר הכולל של מכשירים שתואמים לבקשה. |
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/chrome.management.reports.readonly
מכשיר
תיאור של מכשיר שמדווח על מידע מדפדפן Chrome.
ייצוג ב-JSON |
---|
{ "deviceId": string, "machine": string } |
שדות | |
---|---|
deviceId |
פלט בלבד. המזהה של המכשיר שדיווח על המידע הזה מדפדפן Chrome. |
machine |
פלט בלבד. השם של המכונה ברשת המקומית שלה. |