רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.
ייצוגי משאבים
משאב 'מכשירים' מייצג מכשיר נייד שמנוהל על ידי ה-EMM ושייך למשתמש ספציפי בארגון.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string, "policyId": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
androidId |
string |
מזהה Android של Google Play Services למכשיר, המקודד כמחרוזת הקסדצימלית באותיות קטנות. לדוגמה, "123456789abcdef0" . |
|
device |
string |
שם הקוד הפנימי של החומרה במכשיר. מקור: android.os.Build.DEVICE . (שדה בשם 'device' לפי logs/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
המאפיינים הייחודיים של גרסת ה-build של המכשיר, אם הם ידועים. | |
maker |
string |
היצרן של המכשיר. המידע הזה מגיע מ-android.os.Build.MANUFACTURER . |
|
managementType |
string |
מזהה את מידת השליטה של EMM המנוהל ב-Google Play במכשיר בתצורות פריסה שונות. הערכים האפשריים כוללים:
הערכים הקבילים הם:
|
|
model |
string |
שם הדגם של המכשיר. מקור: android.os.Build.MODEL . |
|
policy |
nested object |
המדיניות שאוכפים על המכשיר. | |
policy.autoUpdatePolicy |
string |
קובע מתי ניתן להחיל עדכונים אוטומטיים של אפליקציות במכשיר. חלופה מומלצת: autoUpdateMode שמוגדרת לכל אפליקציה, מספקת יותר גמישות לגבי תדירות העדכון. אם המדיניות autoUpdateMode מוגדרת לערך AUTO_UPDATE_POSTPONED או AUTO_UPDATE_HIGH_PRIORITY , ל-autoUpdatePolicy אין השפעה.
הערכים הקבילים הם:
|
|
policy.deviceReportPolicy |
string |
האם המכשיר ידווח ל-EMM על מצבי האפליקציה. ערך ברירת המחדל הוא 'deviceReportDisabled'.
הערכים הקבילים הם:
|
|
policy.maintenanceWindow |
nested object |
חלון הזמן לתחזוקה שמגדיר מתי צריך לעדכן אפליקציות שפועלות בחזית. | |
policy.maintenanceWindow.durationMs |
long |
משך חלון הזמן לתחזוקה, באלפיות שנייה. משך הזמן חייב להיות בין 30 דקות ל-24 שעות (כולל). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
שעת ההתחלה של חלון התחזוקה, באלפיות השנייה אחרי חצות במכשיר. חלונות יכולים לחול על חצות. | |
policy.policyId |
string |
מזהה של המדיניות שיישלח עם המשוב על התקנת האפליקציה שנשלח מחנות Play. | |
policy.productAvailabilityPolicy |
string |
הזמינות שהוקצה למכשיר עבור המוצרים שצוינו. הערך 'all' מעניק למכשיר גישה לכל המוצרים, ללא קשר לסטטוס האישור שלהם. הערך 'all' לא מאפשר חשיפה אוטומטית של טראקים מסוג 'alpha' או 'beta'. 'whitelist' מעניק למכשיר גישה למוצרים שצוינו ב-productPolicy[]. אפשר להוסיף לרשימת ההיתרים רק מוצרים שאושרו על ידי הארגון או מוצרים שאושרו בעבר (מוצרים עם אישור שהתבטל). אם לא מציינים ערך, הזמינות שמוגדרת ברמת המשתמש חלה כברירת מחדל.
הערכים הקבילים הם:
|
|
policy.productPolicy[] |
list |
הרשימה של מדיניות המוצרים. כדי שמדיניות המוצרים תחול, צריך להגדיר את הערך של productAvailabilityPolicy כ-WHITELIST או כ-ALL . |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
מדיניות ההתקנה האוטומטית של המוצר. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
האילוצים להתקנה האוטומטית של האפליקציה. אפשר לציין עד אילוץ אחד. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
מגבלה על מצב הטעינה.
הערכים הקבילים הם:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
אילוץ על מצב המכשיר במצב חוסר פעילות.
הערכים הקבילים הם:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
אילוץ של סוג הרשת.
הערכים הקבילים הם:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
מצב ההתקנה האוטומטית. אם לא מגדירים את הערך, ברירת המחדל היא 'doNotAutoInstall'. האפליקציה מותקנת באופן אוטומטי, ללא קשר לחלון התחזוקה שהוגדר.
הערכים הקבילים הם:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
העדיפות של ההתקנה, כמספר שלם ללא סימן. ככל שהמספר נמוך יותר, כך העדיפות גבוהה יותר. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
הגרסה המינימלית של האפליקציה. אם מותקנת גרסה ישנה יותר של האפליקציה, היא תתעדכן באופן אוטומטי בהתאם למגבלות ההתקנה האוטומטית, במקום להמתין לעדכון האוטומטי הרגיל. אפשר להגדיר קוד גרסה מינימלי ל-20 אפליקציות לכל היותר בכל מכשיר. | |
policy.productPolicy[].autoUpdateMode |
string |
מצב העדכון האוטומטי של המוצר. כשמשתמשים ב-autoUpdateMode , הוא תמיד מקבל עדיפות על פני הבחירה של המשתמש. לכן, כשמשתמש מבצע שינויים בהגדרות המכשיר באופן ידני, המערכת מתעלמת מהשינויים האלה.
הערכים הקבילים הם:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
הגדרת כתובת URL לאימות של אפליקציית האימות של ספק הזהויות. הפעולה הזו מאפשרת להפעיל את האפליקציה לאימות חשבונות של ספק הזהויות במהלך האימות באפליקציה פרטית באמצעות Android WebView. אפליקציית מאמת החשבונות אמורה להיות כבר handler ברירת המחדל לכתובת ה-URL לאימות במכשיר. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
כתובת URL לאימות. | |
policy.productPolicy[].managedConfiguration |
nested object |
ההגדרות האישיות המנוהלות של המוצר. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
מכיל את המזהה של פרופיל ההגדרות האישיות המנוהלות ואת קבוצת משתני ההגדרה (אם יש) שהוגדרו עבור המשתמש. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
המזהה של הגדרות ההגדרות המנוהלות. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
קבוצת המשתנים שמשויכת למשתמש. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
מחרוזת placeholder שמוגדרת על ידי ה-EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
הערך של placeholder, שספציפי למשתמש. | |
policy.productPolicy[].managedConfiguration.kind |
string |
הוצא משימוש. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
קבוצת הנכסים המנוהלים של ההגדרה הזו. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
המפתח הייחודי שמזהה את הנכס. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
הערך הבוליאני - יוצג רק אם סוג הנכס הוא בוליאני. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
החבילה של הנכסים המנוהלים – השדה הזה יופיע רק אם סוג הנכס הוא 'חבילה'. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
רשימת הנכסים המנוהלים. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
רשימת החבילות של הנכסים – הרשימה הזו תופיע רק אם סוג הנכס הוא bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
רשימת הנכסים המנוהלים. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
הערך של המספר השלם – הוא יופיע רק אם סוג המאפיין הוא מספר שלם. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
ערך המחרוזת – הוא יופיע רק אם סוג המאפיין הוא מחרוזת, בחירה או מוסתר. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
רשימת ערכי המחרוזת – יוצג רק אם סוג המאפיין הוא בחירה מרובה. | |
policy.productPolicy[].managedConfiguration.productId |
string |
מזהה המוצר בשביל ההגדרה המנוהלת, למשל 'app:com.google.android.gm'. | |
policy.productPolicy[].productId |
string |
המזהה של המוצר. לדוגמה, "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
הרשאה שמעניקה למכשיר גישה למסלולי השקת המוצר שצוינו, שזוהו באמצעות trackIds . כדי לקבל את רשימת הטראקים של המוצר, אפשר להפעיל את הפונקציה Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב-trackIds . |
|
product |
string |
שם המוצר של המכשיר. המידע הזה מגיע מ-android.os.Build.PRODUCT . |
|
report |
nested object |
דוח המכשיר עודכן עם מצבי האפליקציות העדכניים ביותר. | |
report.appState[] |
list |
רשימת מצבי האפליקציות שהוגדרו על ידי אפליקציות מנוהלות במכשיר. מצבי האפליקציה מוגדרים על ידי מפתחי האפליקציה. השדה הזה תמיד יופיע. | |
report.appState[].keyedAppState[] |
list |
רשימה של מצבי אפליקציה עם מפתח. השדה הזה תמיד יוצג. | |
report.appState[].keyedAppState[].data |
string |
שדה נוסף המיועד לנתונים שניתנים לקריאה על ידי מכונה. לדוגמה, מספר או אובייקט JSON. כדי למנוע התקפת XSS, מומלץ להסיר את כל ה-HTML מהנתונים לפני הצגתם. | |
report.appState[].keyedAppState[].key |
string |
מפתח שמציין את המצב שהאפליקציה מספקת. תוכן המפתח מוגדר על ידי מפתח האפליקציה. כדי למנוע התקפת XSS, מומלץ להסיר כל HTML מהמפתח לפני שמוצגים אותו. השדה הזה תמיד יופיע. | |
report.appState[].keyedAppState[].message |
string |
הודעה חופשית שאנשים יכולים לקרוא, שמתארת את מצב האפליקציה. לדוגמה, הודעת שגיאה. כדי למנוע התקפת XSS, מומלץ להסיר את כל ה-HTML מההודעה לפני הצגתה. | |
report.appState[].keyedAppState[].severity |
string |
חומרת מצב האפליקציה. השדה הזה תמיד יופיע.
הערכים הקבילים הם:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
חותמת הזמן של המועד שבו האפליקציה הגדרה את המצב, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. השדה הזה תמיד יופיע. | |
report.appState[].packageName |
string |
שם החבילה של האפליקציה. השדה הזה תמיד יופיע. | |
report.lastUpdatedTimestampMillis |
long |
חותמת הזמן של עדכון הדוח האחרון, במיליוניות השנייה מאז תחילת הזמן. השדה הזה תמיד יופיע. | |
retailBrand |
string |
המותג הקמעונאי של המכשיר, אם הוא מוגדר. ראו android.os.Build.BRAND |
|
sdkVersion |
integer |
גרסת תאימות API. |
שיטות
- forceReportUpload
- מעלה דוח שמכיל את השינויים במצבי האפליקציה במכשיר מאז יצירת הדוח האחרון. אפשר להפעיל את השיטה הזו עד 3 פעמים בכל 24 שעות במכשיר נתון.
- get
- אחזור הפרטים של מכשיר.
- getState
- החזרת מידע על כך שהגישה של מכשיר לשירותי Google מופעלת או מושבתת. מצב המכשיר נכנס לתוקף רק אם אכיפת כללי מדיניות EMM במכשירי Android מופעלת במסוף Google Admin. אחרת, מצב המכשיר לא יילקח בחשבון וכל המכשירים יקבלו גישה לשירותי Google. התכונה הזו נתמכת רק למשתמשים בניהול Google.
- list
- אחזור המזהים של כל המכשירים של המשתמש.
- setState
- הגדרה שמציינת אם הגישה של מכשיר לשירותי Google מופעלת או מושבתת. מצב המכשיר ייכנס לתוקף רק אם אכיפת כללי מדיניות EMM במכשירי Android מופעלת במסוף Google Admin. אחרת, מצב המכשיר לא יילקח בחשבון וכל המכשירים יקבלו גישה לשירותי Google. האפשרות הזו נתמכת רק עבור משתמשים שמנוהלים על ידי Google.
- עדכון
- עדכון מדיניות המכשיר.
כדי לוודא שהמדיניות נאכפת כראוי, צריך למנוע מחשבונות לא מנוהלים לגשת ל-Google Play על ידי הגדרת הערךallowed_accounts
בתצורה המנוהלת של חבילת Google Play. איך מגבילים חשבונות ב-Google Play