- משאב: מכשיר
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- תצוגה
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- רמת החומרה
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- DpcMigrationInfo
- שיטות
משאב: מכשיר
מכשיר בבעלות ארגון. אלא אם צוין אחרת, כל השדות הם לקריאה בלבד ואי אפשר לשנות אותם באמצעות enterprises.devices.patch
.
ייצוג ב-JSON |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
שדות | |
---|---|
name |
שם המכשיר בפורמט |
user |
שם המשאב של המשתמש שבבעלותו המכשיר הזה, בפורמט |
management |
סוג מצב הניהול שבו Device Policy ל-Android פועלת במכשיר. הבחירה הזו משפיעה על הגדרות המדיניות הנתמכות. |
state |
המצב שיש להחיל על המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. חשוב לשים לב שכששולחים קריאה ל- |
applied |
המצב שחל כרגע על המכשיר. |
policy |
אם המכשיר עומד בדרישות המדיניות שלו. |
non |
פרטים על הגדרות המדיניות שהמכשיר לא עומד בהן. |
enrollment |
מועד השיוך של המכשיר לארגון. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
last |
המועד האחרון שבו המכשיר שלח דוח סטטוס. חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
lastPolicyComplianceReportTime |
הוצא משימוש. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
last |
הפעם האחרונה שבה המכשיר שלף את המדיניות שלו. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
policy |
שם המדיניות שחלה על המכשיר, בפורמט |
applied |
שם המדיניות שחלה כרגע על המכשיר. |
applied |
הגרסה של המדיניות שחלה כרגע על המכשיר. |
api |
רמת ה-API של גרסת פלטפורמת Android שפועלת במכשיר. |
enrollment |
אם המכשיר נרשם באמצעות אסימון הרשמה עם נתונים נוספים, השדה הזה מכיל את הנתונים האלה. |
enrollment |
אם המכשיר נרשם באמצעות טוקן הרשמה, השדה הזה מכיל את שם הטוקן. |
disabled |
אם מצב המכשיר הוא |
software |
מידע מפורט על התוכנה של המכשיר. המידע הזה זמין רק אם הערך של |
hardware |
מידע מפורט על חומרת המכשיר. |
displays[] |
מידע מפורט על המסכים במכשיר. המידע הזה זמין רק אם הערך של |
application |
דוחות על אפליקציות שמותקנות במכשיר. המידע הזה זמין רק כשהערך של |
previous |
אם אותו מכשיר פיזי נרשם כמה פעמים, השדה הזה מכיל את שמות המכשיר הקודמים. המספר הסידורי משמש כמזהה הייחודי כדי לקבוע אם אותו מכשיר פיזי נרשם בעבר. השמות מופיעים בסדר כרונולוגי. |
network |
פרטי הרשת של המכשיר. המידע הזה זמין רק אם הערך של |
memory |
פרטי זיכרון: מכילים מידע על הזיכרון והאחסון של המכשיר. |
memory |
אירועים שקשורים למדידות של זיכרון ואחסון בסדר כרונולוגי. המידע הזה זמין רק אם הערך של אירועים נשמרים למשך תקופה מסוימת, ואירועים ישנים נמחקים. |
power |
אירועי ניהול צריכת החשמל במכשיר בסדר כרונולוגי. המידע הזה זמין רק אם הערך של |
hardware |
דגימות של סטטוס החומרה בסדר כרונולוגי. המידע הזה זמין רק אם הערך של |
device |
מידע על הגדרות המכשיר. המידע הזה זמין רק אם הערך של |
user |
המשתמש שהמכשיר הוא הבעלים של המכשיר. |
system |
מפה של השם והערך של מאפייני המערכת שנבחרו שקשורים למכשיר. המידע הזה זמין רק אם הערך של אובייקט שמכיל רשימה של |
security |
ערך מצב האבטחה של המכשיר משקף את רמת האבטחה של המכשיר. |
ownership |
הבעלות על המכשיר המנוהל. |
common |
מידע על מצב קריטריונים משותפים – תקני אבטחה שמוגדרים ב-Common criteria for Information Technology Evaluation (הערכה של אבטחת טכנולוגיית מידע) (CC). המידע הזה זמין רק אם הערך של |
applied |
דרישות הסיסמה שחלות כרגע על המכשיר.
|
dpc |
פלט בלבד. מידע שמציין אם המכשיר הזה הועבר מניהול של בקר מדיניות מכשירים (DPC) אחר. |
DeviceState
המדינות שעשויות לחול על מכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
DEVICE_STATE_UNSPECIFIED |
אסור להשתמש בערך הזה. |
ACTIVE |
המכשיר פעיל. |
DISABLED |
המכשיר מושבת. |
DELETED |
המכשיר נמחק. המצב הזה אף פעם לא מוחזר על ידי קריאה ל-API, אבל הוא משמש בדוח הסטטוס הסופי כשהמכשיר מאשר את המחיקה. אם המכשיר יימחק באמצעות הקריאה ל-API, המצב הזה יפורסם ב-Pub/Sub. אם המשתמש ימחק את פרופיל העבודה או יאפס את המכשיר, מצב המכשיר יישאר לא ידוע לשרת. |
PROVISIONING |
המכשיר עובר הקצאה. מכשירים שנרשמו לאחרונה נמצאים במצב הזה עד שתחול עליהם מדיניות. |
LOST |
המכשיר אבד. המצב הזה אפשרי רק במכשירים שבבעלות הארגון. |
PREPARING_FOR_MIGRATION |
המכשיר מתכונן להעברה ל-Android Management API. לא נדרשת כל פעולה נוספת כדי שההעברה תמשיך. |
DEACTIVATED_BY_DEVICE_FINANCE |
זהו מכשיר ממומן שסוכן המימון 'נעל'. המשמעות היא שהוחלו הגדרות מדיניות מסוימות שמגבילות את הפונקציונליות של המכשיר עד שסוכן המימון 'יפתח' את המכשיר. המכשיר ימשיך להחיל את הגדרות המדיניות, לא כולל הגדרות שסווגרו כבלתי רלוונטיות על ידי סוכן המימון. כשהמכשיר 'נעול', המצב מדווח ב-appliedState כ-DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
פרטים על אי-תאימות להגדרת מדיניות.
ייצוג ב-JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
שדות | |
---|---|
setting |
שם הגדרת המדיניות. זהו שם השדה ב-JSON של שדה |
non |
הסיבה לכך שהמכשיר לא עומד בהגדרה. |
package |
שם החבילה שמציין איזו אפליקציה לא עומדת בדרישות, אם רלוונטי. |
field |
בהגדרות עם שדות בתצוגת עץ, אם שדה מסוים בתצוגת עץ לא עומד בדרישות התאימות, הנתיב המלא לשדה הבעייתי יצוין כאן. הפורמט של הנתיב זהה לפורמט של השדה JSON של המדיניות שמצוין ב-JavaScript, כלומר: 1) בשדות מסוג אובייקט, אחרי שם השדה מופיע נקודה ואז שם שדה משנה. 2) בשדות מסוג מערך, אחרי שם השדה מופיע אינדקס המערך שמוקף בסוגריים מרובעים. לדוגמה, כדי לציין בעיה בשדה |
current |
אם לא ניתן היה להחיל את הגדרת המדיניות, הערך הנוכחי של ההגדרה במכשיר. |
installation |
אם השדה |
specific |
הסיבה הספציפית למדיניות לכך שהמכשיר לא עומד בהגדרה. |
specific |
הקשר נוסף לגבי |
InstallationFailureReason
סיבות אפשריות לכך שהתקנת אפליקציה נכשלת.
טיפוסים בני מנייה (enum) | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
אסור להשתמש בערך הזה. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
תנאי לא ידוע מונע את ההתקנה של האפליקציה. חלק מהסיבות האפשריות הן שאין מספיק נפח אחסון במכשיר, שהחיבור לרשת של המכשיר לא אמין או שההתקנה נמשכת יותר זמן מהצפוי. המערכת תנסה שוב להתקין את העדכון באופן אוטומטי. |
IN_PROGRESS |
ההתקנה עדיין מתבצעת. |
NOT_FOUND |
האפליקציה לא נמצאה ב-Play. |
NOT_COMPATIBLE_WITH_DEVICE |
האפליקציה לא תואמת למכשיר. |
NOT_APPROVED |
האפליקציה לא אושרה על ידי האדמין. |
PERMISSIONS_NOT_ACCEPTED |
לאפליקציה יש הרשאות חדשות שלא אושרו על ידי האדמין. |
NOT_AVAILABLE_IN_COUNTRY |
האפליקציה לא זמינה במדינה של המשתמש. |
NO_LICENSES_REMAINING |
אין רישיונות זמינים להקצאה למשתמש. |
NOT_ENROLLED |
הארגון כבר לא רשום ב-Google Play לארגונים, או שהאדמין לא אישר את התנאים וההגבלות העדכניים ביותר של Google Play לארגונים. |
USER_INVALID |
המשתמש כבר לא בתוקף. ייתכן שהמשתמש נמחק או הושבת. |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
שגיאת רשת במכשיר של המשתמש מנעה את ההתקנה. בדרך כלל, המצב הזה קורה כשהחיבור לאינטרנט של המכשיר פגום, לא זמין או שיש בעיה בהגדרות הרשת. צריך לוודא שלמכשיר יש גישה מלאה לאינטרנט ברשת שעומדת בדרישות של |
INSUFFICIENT_STORAGE |
במכשיר של המשתמש אין מספיק מקום אחסון להתקנת האפליקציה. כדי לפתור את הבעיה, צריך לפנות מקום אחסון במכשיר. ההתקנה או העדכון של האפליקציה ימשיכו באופן אוטומטי ברגע שיהיה מספיק מקום אחסון במכשיר. |
SpecificNonComplianceReason
פרטים נוספים על הסיבה לכך שהמכשיר לא תואם להגדרת המדיניות. בעתיד אפשר להוסיף ל-enum ערכים חדשים.
טיפוסים בני מנייה (enum) | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
לא צוינה סיבה ספציפית לכך שהחשבון לא עומד בדרישות. השדות ב- לא מוגדרים. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
המשתמש צריך לאשר את פרטי הכניסה על ידי הזנת נעילת המסך. השדות ב- לא מוגדרים. הערך של מוגדר ל- . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
פג התוקף של הסיסמה של המכשיר או הפרופיל. הערך של מוגדר. מוגדר לערך . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
הסיסמה של המכשיר לא עומדת בדרישות הסיסמה. מוגדרת. מוגדר לערך . |
ONC_WIFI_INVALID_VALUE |
יש ערך שגוי בהגדרות ה-Wi-Fi של ONC. מציין איזה ערך שדה שגוי. הערך של מוגדר. מוגדר לערך . |
ONC_WIFI_API_LEVEL |
הגדרת ה-Wi-Fi של ONC לא נתמכת ברמת ה-API של גרסת Android שפועלת במכשיר. מציין איזה ערך שדה לא נתמך. הערך של מוגדר. מוגדר לערך . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
ברשת ה-Wi-Fi של הארגון חסר אישור ה-CA ברמה הבסיסית (root) או שם הדומיין. הערך של מוגדר ל- . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
המשתמש צריך להסיר את רשת ה-Wi-Fi שהוגדרה באופן ידני. ההגדרה הזו רלוונטית רק לפרופילי עבודה במכשירים בבעלות אישית. מוגדר לערך . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
הכינוי של זוג המפתחות שצוין בשדה ClientCertKeyPairAlias ב- לא תואם למפתח קיים שמותקן במכשיר. מוגדר לערך . |
SpecificNonComplianceContext
הקשר נוסף לגבי
.SpecificNonComplianceReason
ייצוג JSON |
---|
{ "oncWifiContext": { object ( |
שדות | |
---|---|
onc |
הקשר נוסף לגבי אי-תאימות שקשורה להגדרת Wi-Fi. צפייה ב |
password |
הקשר נוסף לאי-תאימות שקשור למדיניות בנושא סיסמאות. פרטים נוספים זמינים ב |
OncWifiContext
הקשר נוסף לחוסר תאימות שקשור להגדרת Wi-Fi.
ייצוג ב-JSON |
---|
{ "wifiGuid": string } |
שדות | |
---|---|
wifi |
מזהה GUID של תצורת Wi-Fi לא תואמת. |
PasswordPoliciesContext
הקשר נוסף לגבי אי-תאימות שקשור למדיניות סיסמאות.
ייצוג ב-JSON |
---|
{
"passwordPolicyScope": enum ( |
שדות | |
---|---|
password |
ההיקף של הסיסמה שלא עומדת בדרישות. |
SoftwareInfo
מידע על התוכנה של המכשיר.
ייצוג ב-JSON |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
שדות | |
---|---|
android |
מחרוזת הגרסה של Android שגלויה למשתמשים. לדוגמה, |
android |
קוד הגרסה של אפליקציית Android Device Policy. |
android |
גרסת האפליקציה של Android Device Policy כפי שהיא מוצגת למשתמש. |
android |
מחרוזת מזהה build של Android שמיועדת להצגה למשתמש. לדוגמה, |
device |
גרסת ליבה, למשל |
bootloader |
מספר הגרסה של תוכנת האתחול של המערכת, למשל |
android |
משך הזמן של תהליך ה-build. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
security |
רמת תיקון האבטחה, למשל |
primary |
קוד שפה מסוג IETF BCP 47 של הלוקאל הראשי במכשיר. |
device |
גיבוב SHA-256 של |
system |
מידע על עדכון מערכת פוטנציאלי בהמתנה. |
SystemUpdateInfo
מידע על עדכון מערכת פוטנציאלי בהמתנה.
ייצוג ב-JSON |
---|
{
"updateStatus": enum ( |
שדות | |
---|---|
update |
הסטטוס של העדכון: האם קיים עדכון ומהו הסוג. |
update |
המועד שבו העדכון היה זמין לראשונה. ערך אפס מציין שהשדה הזה לא מוגדר. השדה הזה מוגדר רק אם יש עדכון זמין (כלומר, חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
UpdateStatus
סטטוס העדכון: אם קיים עדכון ואיזה סוג הוא.
טיפוסים בני מנייה (enum) | |
---|---|
UPDATE_STATUS_UNKNOWN |
לא ידוע אם יש עדכון מערכת בהמתנה. מצב כזה קורה, למשל, אם רמת ה-API של המכשיר נמוכה מ-26, או אם גרסת המדיניות של מכשירי Android לא עדכנית. |
UP_TO_DATE |
אין עדכון מערכת בהמתנה במכשיר. |
UNKNOWN_UPDATE_AVAILABLE |
יש עדכון מערכת בהמתנה, אבל לא ידוע מה הסוג שלו. |
SECURITY_UPDATE_AVAILABLE |
יש עדכון אבטחה בהמתנה. |
OS_UPDATE_AVAILABLE |
יש עדכון זמין למערכת ההפעלה בהמתנה. |
HardwareInfo
מידע על חומרת המכשיר. השדות שקשורים לסף הטמפרטורה זמינים רק אם הערך של hardwareStatusEnabled
הוא True במדיניות של המכשיר.
ייצוג ב-JSON |
---|
{ "brand": string, "hardware": string, "deviceBasebandVersion": string, "manufacturer": string, "serialNumber": string, "model": string, "batteryShutdownTemperatures": [ number ], "batteryThrottlingTemperatures": [ number ], "cpuShutdownTemperatures": [ number ], "cpuThrottlingTemperatures": [ number ], "gpuShutdownTemperatures": [ number ], "gpuThrottlingTemperatures": [ number ], "skinShutdownTemperatures": [ number ], "skinThrottlingTemperatures": [ number ], "enterpriseSpecificId": string } |
שדות | |
---|---|
brand |
המותג של המכשיר. לדוגמה, |
hardware |
שם החומרה. לדוגמה, |
device |
גרסת פס בסיס. לדוגמה, |
manufacturer |
היצרן. לדוגמה, |
serial |
המספר הסידורי של המכשיר. |
model |
הדגם של המכשיר. לדוגמה, |
battery |
ערכי הסף של טמפרטורת כיבוי הסוללה בצלזיוס לכל סוללה במכשיר. |
battery |
ערכי הסף של הטמפרטורה לוויסות הביצועים של הסוללה בצלזיוס לכל סוללה במכשיר. |
cpu |
ערכי הסף של טמפרטורת כיבוי המעבד (CPU) בצלזיוס לכל מעבד במכשיר. |
cpu |
ערכי הסף של טמפרטורת ויסות הנתונים (throttle) של המעבד (CPU) בצלזיוס לכל מעבד במכשיר. |
gpu |
סף הטמפרטורה של כיבוי ה-GPU בצלזיוס לכל GPU במכשיר. |
gpu |
ערכי הסף של טמפרטורת ויסות הנתונים של GPU בצלזיוס לכל GPU במכשיר. |
skin |
ערכי הסף לטמפרטורת העור של המכשיר לצורך כיבוי, במעלות צלזיוס. |
skin |
ערכי הסף של טמפרטורת העור של המכשיר לצורך ויסות הקצב. הערכים הם במעלות צלזיוס. |
enterprise |
פלט בלבד. מזהה שמזהה באופן ייחודי מכשיר בבעלות אישית בארגון מסוים. באותו מכשיר פיזי, כשהמכשיר רשום לאותה הארגון, המזהה הזה נשמר במהלך ההגדרות ואפילו אחרי איפוס להגדרות המקוריות. התעודה הזו זמינה במכשירים בבעלות אישית עם פרופיל עבודה במכשירים עם Android מגרסה 12 ואילך. |
רשת המדיה
מידע על תצוגת המכשיר.
ייצוג ב-JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
שדות | |
---|---|
name |
השם של המסך. |
display |
מזהה תצוגה ייחודי. |
refresh |
קצב הרענון של המסך בפריימים לשנייה. |
state |
מצב המסך. |
width |
רוחב התצוגה בפיקסלים. |
height |
גובה התצוגה בפיקסלים. |
density |
צפיפות התצוגה, שמבוטאת בנקודות לאינץ'. |
DisplayState
המצב של המסך.
טיפוסים בני מנייה (enum) | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
הערך הזה אסור. |
OFF |
המסך כבוי. |
ON |
המסך פועל. |
DOZE |
המסך נמצא במצב שינה במצב צריכת אנרגיה נמוכה |
SUSPENDED |
המסך נמצא במצב שינה במצב חיסכון בסוללה מושעה. |
ApplicationReport
מידע שדווח על אפליקציה מותקנת.
ייצוג ב-JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
שדות | |
---|---|
package |
שם החבילה של האפליקציה. |
version |
גרסת האפליקציה כפי שהיא מוצגת למשתמש. |
version |
קוד גרסת האפליקציה, שבעזרתו אפשר לקבוע אם גרסה אחת עדכנית יותר מגרסה אחרת. |
events[] |
רשימת אירועי האפליקציה שהתרחשו ב-30 השעות האחרונות. |
display |
השם המוצג של האפליקציה. |
package |
גיבוב SHA-256 של קובץ ה-APK של האפליקציה, שאפשר להשתמש בו כדי לוודא שהאפליקציה לא שונתה. כל בייט מערך הגיבוב מיוצג כמספר הקסדצימלי דו-ספרתי. |
signing |
גיבוב SHA-1 של כל |
installer |
שם החבילה של האפליקציה שהתקינה את האפליקציה הזו. |
application |
מקור החבילה. |
state |
מצב האפליקציה. |
keyed |
רשימת מצבי המפתח של האפליקציה, שדווחו על ידי האפליקציה. |
user |
האם האפליקציה פונה למשתמש. |
ApplicationEvent
אירוע שקשור לאפליקציה.
ייצוג ב-JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
event |
סוג האירוע באפליקציה. |
create |
שעת היצירה של האירוע. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
ApplicationEventType
סוג של אירוע שקשור לאפליקציה.
טיפוסים בני מנייה (enum) | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
הערך הזה אסור. |
INSTALLED |
האפליקציה הותקנה. |
CHANGED |
האפליקציה השתנתה, למשל, רכיב הופעל או הושבת. |
DATA_CLEARED |
נתוני האפליקציה נמחקו. |
REMOVED |
האפליקציה הוסרה. |
REPLACED |
הותקנה גרסה חדשה של האפליקציה, שמחליפה את הגרסה הישנה. |
RESTARTED |
האפליקציה הופעלה מחדש. |
PINNED |
האפליקציה הוצמדה לחזית. |
UNPINNED |
הצמדת האפליקציה בוטלה. |
ApplicationSource
המקור שסיפק את האפליקציה.
טיפוסים בני מנייה (enum) | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
האפליקציה נטענה ממקור שלא צוין. |
SYSTEM_APP_FACTORY_VERSION |
זוהי אפליקציית מערכת מתמונת המפעל של המכשיר. |
SYSTEM_APP_UPDATED_VERSION |
זוהי אפליקציית מערכת מעודכנת. |
INSTALLED_FROM_PLAY_STORE |
האפליקציה הותקנה מחנות Google Play. |
ApplicationState
סטטוס ההתקנה הנוכחי.
טיפוסים בני מנייה (enum) | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
מצב האפליקציה לא צוין |
REMOVED |
האפליקציה הוסרה מהמכשיר |
INSTALLED |
האפליקציה מותקנת במכשיר |
KeyedAppState
מצב האפליקציה המקושר, שדווח על ידי האפליקציה.
ייצוג ב-JSON |
---|
{
"key": string,
"severity": enum ( |
שדות | |
---|---|
key |
המפתח למצב האפליקציה. היא נקודת התייחסות למה שהאפליקציה מספקת. לדוגמה, כששולחים משוב על הגדרה מנוהלת, המפתח הזה יכול להיות מפתח ההגדרה המנוהלת. |
severity |
רמת החומרה של מצב האפליקציה. |
message |
אפשר גם להוסיף מחרוזת של הודעה בפורמט חופשי כדי להסביר את מצב האפליקציה. אם המצב הופעל על ידי ערך מסוים (למשל, ערך של הגדרה מנוהלת), צריך לכלול אותו בהודעה. |
data |
אפשר גם לציין ערך שקריא למכונה, שייכתב על ידי ה-EMM. לדוגמה, הגדרת ערכים שהאדמין יכול לבחור להריץ נגדם שאילתה במסוף ה-EMM (למשל, 'notify me if the battery_warning data < 10'). |
create |
שעת היצירה של מצב האפליקציה במכשיר. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
last |
השעה שבה מצב האפליקציה עודכן לאחרונה. חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
מידת החומרה
רמת החומרה של מצב האפליקציה.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
רמת חומרה לא צוינה. |
INFO |
רמת החומרה של המידע. |
ERROR |
רמת החומרה של השגיאה. צריך להגדיר את האפשרות הזו רק לתנאי שגיאה אמיתיים שצריך לבצע פעולה כדי לתקן אותם בארגון הניהול. |
UserFacingType
האם האפליקציה מוצגת למשתמשים.
טיפוסים בני מנייה (enum) | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
הסוג של המשתמש באפליקציה לא צוין. |
NOT_USER_FACING |
האפליקציה לא מוצגת למשתמשים. |
USER_FACING |
האפליקציה מוצגת למשתמשים. |
NetworkInfo
פרטי הרשת של המכשיר.
ייצוג ב-JSON |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
שדות | |
---|---|
imei |
מספר ה-IMEI של מכשיר ה-GSM. לדוגמה, |
meid |
מספר MEID של מכשיר ה-CDMA. לדוגמה, |
wifi |
כתובת ה-MAC של ה-Wi-Fi של המכשיר. לדוגמה, |
networkOperatorName |
השם האלפביתי של המפעיל הרשום הנוכחי. לדוגמה, Vodafone. |
telephony |
מידע על טלפוניה שמשויך לכל כרטיס SIM במכשיר. התכונה נתמכת רק במכשירים מנוהלים באופן מלא, החל מרמת API 23 של Android. |
TelephonyInfo
פרטי טלפוניה שמשויכים לכרטיס SIM מסוים במכשיר. התכונה נתמכת רק במכשירים מנוהלים באופן מלא, החל מרמת API 23 של Android.
ייצוג ב-JSON |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string } |
שדות | |
---|---|
phone |
מספר הטלפון שמשויך לכרטיס ה-SIM הזה. |
carrier |
שם הספק שמשויך לכרטיס ה-SIM הזה. |
icc |
פלט בלבד. מספר ה-ICCID שמשויך לכרטיס ה-SIM הזה. |
MemoryInfo
מידע על הזיכרון והאחסון של המכשיר.
ייצוג ב-JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
שדות | |
---|---|
total |
נפח ה-RAM הכולל במכשיר, בבייט. |
total |
נפח האחסון הפנימי הכולל במכשיר בבייט. |
MemoryEvent
אירוע שקשור למדידות של זיכרון ואחסון.
כדי להבדיל בין אירועים חדשים לבין אירועים ישנים, מומלץ להשתמש בשדה
.createTime
ייצוג ב-JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
event |
סוג האירוע. |
create |
שעת היצירה של האירוע. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
byte |
מספר הבייטים הפנויים במדיום, או עבור |
MemoryEventType
סוג האירוע.
טיפוסים בני מנייה (enum) | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
לא צוין. אין אירועים מסוג זה. |
RAM_MEASURED |
נמדד נפח זיכרון RAM פנוי. |
INTERNAL_STORAGE_MEASURED |
נמדד נפח האחסון הפנוי באחסון הפנימי. |
EXTERNAL_STORAGE_DETECTED |
זוהה אמצעי אחסון חיצוני חדש. מספר הבייטים שמדווח הוא הקיבולת הכוללת של אמצעי האחסון. |
EXTERNAL_STORAGE_REMOVED |
הוסרה מדיה של אחסון חיצוני. מספר הבייטים שדווחו הוא אפס. |
EXTERNAL_STORAGE_MEASURED |
נמדדה מקום פנוי באמצעי של אחסון חיצוני. |
PowerManagementEvent
אירוע של ניהול צריכת הסוללה.
ייצוג ב-JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
event |
סוג האירוע. |
create |
שעת היצירה של האירוע. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
battery |
באירועים מסוג |
PowerManagementEventType
סוג האירוע.
טיפוסים בני מנייה (enum) | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
לא צוין. אין אירועים מהסוג הזה. |
BATTERY_LEVEL_COLLECTED |
רמת הטעינה של הסוללה נמדדה. |
POWER_CONNECTED |
הטעינה של המכשיר התחילה. |
POWER_DISCONNECTED |
הטעינה של המכשיר הופסקה. |
BATTERY_LOW |
המכשיר נכנס למצב חיסכון בסוללה. |
BATTERY_OKAY |
המכשיר יצא ממצב צריכת אנרגיה נמוכה. |
BOOT_COMPLETED |
המכשיר הופעל. |
SHUTDOWN |
המכשיר נכבה. |
HardwareStatus
סטטוס החומרה. כדי לקבוע את תקינות החומרה, יכול להיות שתתבצע השוואה בין הטמפרטורות לסף הטמפרטורות שזמין ב-hardwareInfo
.
ייצוג ב-JSON |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
שדות | |
---|---|
create |
השעה שבה בוצעו המדידות. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
battery |
הטמפרטורות הנוכחיות של הסוללות במכשיר, במדידה בצלזיוס. |
cpu |
הטמפרטורות הנוכחיות של המעבדים (CPU) בסולם צלזיוס לכל מעבד במכשיר. |
gpu |
הטמפרטורות הנוכחיות של ה-GPU במדידה בצלזיוס לכל GPU במכשיר. |
skin |
טמפרטורת העור הנוכחית במכשיר, במעלות צלזיוס. |
fan |
מהירויות המאווררים לפי סל״ד של כל מאוורר במכשיר. מערך ריק פירושו שאין מאווררים או שמהירות המאוורר לא נתמכת במערכת. |
cpu |
אחוז השימושים במעבד (CPU) בכל ליבה הזמינה במכשיר. הערך של Usage הוא 0 לכל ליבה לא מחוברת. מערך ריק מציין שהמערכת לא תומכת בשימוש במעבד. |
DeviceSettings
מידע על הגדרות המכשיר שקשורות לאבטחה.
ייצוג ב-JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
שדות | |
---|---|
is |
אם המכשיר מאובטח באמצעות קוד אימות או סיסמה. |
unknown |
האם האפשרות להתקין אפליקציות ממקורות לא מוכרים מופעלת. |
development |
אם מצב הפיתוח מופעל במכשיר. |
adb |
האם ADB מופעל במכשיר. |
is |
האם הצפנת האחסון מופעלת. |
encryption |
סטטוס הצפנה מ-DevicePolicyManager. |
verify |
אם האימות של Google Play Protect נאכף במכשיר. |
EncryptionStatus
סטטוס ההצפנה של המכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
לא צוין. הסוג הזה לא אמור להיות קיים באף מכשיר. |
UNSUPPORTED |
המכשיר לא תומך בהצפנה. |
INACTIVE |
ההצפנה נתמכת על ידי המכשיר, אבל היא לא פעילה כרגע. |
ACTIVATING |
ההצפנה לא פעילה כרגע, אבל היא מופעלת כרגע. |
ACTIVE |
ההצפנה פועלת. |
ACTIVE_DEFAULT_KEY |
ההצפנה פעילה, אבל המשתמש לא מגדיר מפתח הצפנה. |
ACTIVE_PER_USER |
ההצפנה פעילה, ומפתח ההצפנה מקושר לפרופיל המשתמש. |
SecurityPosture
מצב האבטחה של המכשיר, כפי שנקבע על סמך המצב הנוכחי של המכשיר והמדיניות שחלה עליו.
ייצוג ב-JSON |
---|
{ "devicePosture": enum ( |
שדות | |
---|---|
device |
הערך של מצב האבטחה של המכשיר. |
posture |
פרטים נוספים בנוגע למצב האבטחה של המכשיר. |
DevicePosture
הערכים האפשריים של מצב האבטחה של מכשיר בניהול.
טיפוסים בני מנייה (enum) | |
---|---|
POSTURE_UNSPECIFIED |
לא צוין. אין פרטים לגבי תנוחת הגוף בערך הזה. |
SECURE |
המכשיר הזה מאובטח. |
AT_RISK |
המכשיר הזה עשוי להיות פגיע יותר לגורמים זדוניים, ולכן לא מומלץ להשתמש בו עם נתונים עסקיים. |
POTENTIALLY_COMPROMISED |
יכול להיות שהמכשיר הזה נפרץ וגורמים לא מורשים יכולים לגשת לנתונים של החברה. |
PostureDetail
פרטים נוספים לגבי מצב האבטחה של המכשיר.
ייצוג ב-JSON |
---|
{ "securityRisk": enum ( |
שדות | |
---|---|
security |
סיכון אבטחה ספציפי שמשפיע לרעה על מצב האבטחה של המכשיר. |
advice[] |
ייעוץ מתאים לאדמינים כדי לצמצם את סיכון האבטחה הזה ולשפר את מצב האבטחה של המכשיר. |
SecurityRisk
הסיכון שגורם לכך שהמכשיר לא נמצא במצב האבטחה המאובטח ביותר.
טיפוסים בני מנייה (enum) | |
---|---|
SECURITY_RISK_UNSPECIFIED |
לא צוין. |
UNKNOWN_OS |
Play Integrity API מזהה שהמכשיר פועל עם מערכת הפעלה לא ידועה (הבדיקות basicIntegrity ו-ctsProfileMatch עוברות בהצלחה). |
COMPROMISED_OS |
Play Integrity API מזהה שהמכשיר פועל עם מערכת הפעלה שנפרצה (הבדיקות של basicIntegrity נכשלות). |
HARDWARE_BACKED_EVALUATION_FAILED |
אם התווית MEETS_STRONG_INTEGRITY לא מופיעה בשדה תקינות המכשיר, המערכת של Play Integrity API מזהה שהמכשיר לא מבטיח באופן חזק את תקינות המערכת. |
CommonCriteriaModeInfo
מידע על מצב Common Criteria – תקני אבטחה שמוגדרים בCommon Criteria for Information Technology Security Evaluation (CC).
המידע הזה זמין רק אם הערך של statusReportingSettings.commonCriteriaModeEnabled
הוא true
במדיניות של המכשיר.
ייצוג ב-JSON |
---|
{ "commonCriteriaModeStatus": enum ( |
שדות | |
---|---|
common |
האם מצב Common Criteria מופעל. |
policy |
פלט בלבד. סטטוס האימות של החתימה על המדיניות. |
CommonCriteriaModeStatus
האם מצב Common Criteria מופעל.
טיפוסים בני מנייה (enum) | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
סטטוס לא ידוע. |
COMMON_CRITERIA_MODE_DISABLED |
מצב Common Criteria מושבת כרגע. |
COMMON_CRITERIA_MODE_ENABLED |
מצב Common Criteria מופעל כרגע. |
PolicySignatureVerificationStatus
הסטטוס של אימות החתימה על המדיניות.
טיפוסים בני מנייה (enum) | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
לא צוין. סטטוס האימות לא דווח. השדה הזה מוגדר רק אם הערך של הוא false. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
האימות של חתימת המדיניות מושבת במכשיר כי המדיניות מוגדרת כ-False. |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED |
אימות החתימה על המדיניות הסתיים. |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED |
אין תמיכה באימות חתימה למדיניות, למשל כי המכשיר נרשם עם גרסת CloudDPC שלא תומכת באימות חתימת המדיניות. |
POLICY_SIGNATURE_VERIFICATION_FAILED |
האימות של חתימת המדיניות נכשל. המדיניות לא הוחלתה. |
DpcMigrationInfo
מידע לגבי המעבר של המכשיר מהניהול של בקר מדיניות אחר של מכשירים (DPC).
ייצוג ב-JSON |
---|
{ "previousDpc": string, "additionalData": string } |
שדות | |
---|---|
previous |
פלט בלבד. אם המכשיר הזה הועבר מבקר DPC אחר, זהו שם החבילה שלו. אחרת, השדה לא מאוכלס. |
additional |
פלט בלבד. אם המכשיר הזה הועבר מ-DPC אחר, השדה |
שיטות |
|
---|---|
|
מחיקה של מכשיר. |
|
אחזור מכשיר. |
|
יוצר פקודה למכשיר. |
|
הצגת רשימה של מכשירים בארגון נתון. |
|
עדכון מכשיר. |