- משאב: מכשיר
- 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 |
שם המכשיר בפורמט |
userName |
שם המשאב של המשתמש שבבעלותו המכשיר הזה, בפורמט |
managementMode |
סוג מצב הניהול שבו Device Policy ל-Android פועלת במכשיר. האפשרות הזו משפיעה על הגדרות המדיניות הנתמכות. |
state |
המצב שיחול על המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. שימו לב: כשקוראים ל- |
appliedState |
המצב שחלה על המכשיר כרגע. |
policyCompliant |
אם המכשיר פועל בהתאם למדיניות שלו. |
nonComplianceDetails[] |
פרטים על הגדרות המדיניות שהמכשיר לא עומד בהן. |
enrollmentTime |
השעה שבה המכשיר נרשם. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
lastStatusReportTime |
המועד האחרון שבו המכשיר שלח דוח סטטוס. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
lastPolicyComplianceReportTime |
הוצא משימוש. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
lastPolicySyncTime |
הפעם האחרונה שבה המכשיר שלף את המדיניות שלו. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
policyName |
שם המדיניות שחלה על המכשיר, בפורמט |
appliedPolicyName |
שם המדיניות שחלה כרגע על המכשיר. |
appliedPolicyVersion |
הגרסה של המדיניות שחלה כרגע על המכשיר. |
apiLevel |
רמת ה-API של גרסת פלטפורמת Android שפועלת במכשיר. |
enrollmentTokenData |
אם המכשיר נרשם באמצעות אסימון הרשמה עם נתונים נוספים, השדה הזה מכיל את הנתונים האלה. |
enrollmentTokenName |
אם המכשיר נרשם באמצעות טוקן הרשמה, השדה הזה מכיל את שם הטוקן. |
disabledReason |
אם מצב המכשיר הוא |
softwareInfo |
מידע מפורט על תוכנת המכשיר. המידע הזה זמין רק אם הערך של |
hardwareInfo |
מידע מפורט על חומרת המכשיר. |
displays[] |
מידע מפורט על המסכים במכשיר. המידע הזה זמין רק אם הערך של |
applicationReports[] |
דוחות על אפליקציות שמותקנות במכשיר. המידע הזה זמין רק כשהערך של |
previousDeviceNames[] |
אם אותו מכשיר פיזי נרשם כמה פעמים, השדה הזה מכיל את שמות המכשיר הקודמים. המספר הסידורי משמש כמזהה הייחודי כדי לקבוע אם אותו מכשיר פיזי נרשם בעבר. השמות מופיעים בסדר כרונולוגי. |
networkInfo |
פרטי הרשת של המכשיר. המידע הזה זמין רק אם הערך של |
memoryInfo |
פרטי הזיכרון: מכילים מידע על הזיכרון והאחסון של המכשיר. |
memoryEvents[] |
אירועים שקשורים למדידות של זיכרון ואחסון בסדר כרונולוגי. המידע הזה זמין רק אם הערך של האירועים נשמרים למשך פרק זמן מסוים, ואירועים ישנים נמחקים. |
powerManagementEvents[] |
אירועי ניהול צריכת החשמל במכשיר בסדר כרונולוגי. המידע הזה זמין רק אם הערך של |
hardwareStatusSamples[] |
דגימות של סטטוס החומרה בסדר כרונולוגי. המידע הזה זמין רק אם הערך של |
deviceSettings |
מידע על הגדרות המכשיר. המידע הזה זמין רק אם הערך של |
user |
המשתמש שהוא הבעלים של המכשיר. |
systemProperties |
מפה של השם והערך של מאפייני המערכת שנבחרו שקשורים למכשיר. המידע הזה זמין רק אם הערך של אובייקט שמכיל רשימה של זוגות |
securityPosture |
הערך של מצב האבטחה של המכשיר, שמשקף את רמת האבטחה שלו. |
ownership |
הבעלות על המכשיר המנוהל. |
commonCriteriaModeInfo |
מידע על מצב Common Criteria – תקני אבטחה שמוגדרים בCommon Criteria for Information Technology Security Evaluation (CC). המידע הזה זמין רק אם הערך של |
appliedPasswordPolicies[] |
דרישות הסיסמה שחלות כרגע על המכשיר.
|
dpcMigrationInfo |
פלט בלבד. מידע לגבי המעבר של המכשיר מהניהול של בקר מדיניות אחר של מכשירים (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 ( |
שדות | |
---|---|
settingName |
שם הגדרת המדיניות. זהו שם השדה ב-JSON של שדה |
nonComplianceReason |
הסיבה לכך שהמכשיר לא עומד בהגדרה. |
packageName |
שם החבילה שמציין איזו אפליקציה לא עומדת בדרישות, אם רלוונטי. |
fieldPath |
בהגדרות עם שדות בתצוגת עץ, אם שדה ספציפי בתצוגת עץ לא עומד בדרישות התאימות, הנתיב המלא לשדה הבעייתי יצוין כאן. הפורמט של הנתיב זהה לפורמט של השדה JSON של המדיניות שמצוין ב-JavaScript, כלומר: 1) בשדות מסוג אובייקט, אחרי שם השדה מופיע נקודה ואז שם שדה משנה. 2) בשדות מסוג מערך, שם השדה מופיע אחרי אינדקס המערך שמוקף בסוגריים. לדוגמה, כדי לציין בעיה בשדה |
currentValue |
אם לא ניתן היה להחיל את הגדרת המדיניות, הערך הנוכחי של ההגדרה במכשיר. |
installationFailureReason |
אם השדה |
specificNonComplianceReason |
הסיבה הספציפית למדיניות לכך שהמכשיר לא עומד בהגדרה. |
specificNonComplianceContext |
הקשר נוסף לגבי |
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) | |
---|---|
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 ( |
שדות | |
---|---|
oncWifiContext |
הקשר נוסף לגבי אי-תאימות שקשורה להגדרת Wi-Fi. ראו |
passwordPoliciesContext |
הקשר נוסף לגבי אי-תאימות שקשור למדיניות סיסמאות. פרטים נוספים זמינים ב |
OncWifiContext
הקשר נוסף לגבי אי-תאימות שקשורה להגדרת Wi-Fi.
ייצוג ב-JSON |
---|
{ "wifiGuid": string } |
שדות | |
---|---|
wifiGuid |
מזהה GUID של תצורת Wi-Fi לא תואמת. |
PasswordPoliciesContext
הקשר נוסף לגבי אי-תאימות שקשור למדיניות סיסמאות.
ייצוג ב-JSON |
---|
{
"passwordPolicyScope": enum ( |
שדות | |
---|---|
passwordPolicyScope |
ההיקף של סיסמה שלא עומדת בדרישות. |
SoftwareInfo
מידע על תוכנת המכשיר.
ייצוג ב-JSON |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
שדות | |
---|---|
androidVersion |
המחרוזת של גרסת Android שגלויה למשתמשים. לדוגמה, |
androidDevicePolicyVersionCode |
קוד הגרסה של אפליקציית Device Policy ל-Android. |
androidDevicePolicyVersionName |
גרסת האפליקציה של Android Device Policy כפי שהיא מוצגת למשתמש. |
androidBuildNumber |
מחרוזת של מזהה build של Android שמיועדת להצגה למשתמש. לדוגמה, |
deviceKernelVersion |
גרסת הליבה, לדוגמה, |
bootloaderVersion |
מספר הגרסה של תוכנת האתחול של המערכת, למשל |
androidBuildTime |
משך הזמן של תהליך ה-build. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
securityPatchLevel |
רמת תיקון האבטחה, למשל |
primaryLanguageCode |
קוד שפה מסוג IETF BCP 47 של הלוקאל הראשי במכשיר. |
deviceBuildSignature |
גיבוב SHA-256 של |
systemUpdateInfo |
מידע על עדכון מערכת פוטנציאלי בהמתנה. |
SystemUpdateInfo
מידע על עדכון מערכת פוטנציאלי בהמתנה.
ייצוג ב-JSON |
---|
{
"updateStatus": enum ( |
שדות | |
---|---|
updateStatus |
סטטוס העדכון: אם קיים עדכון ואיזה סוג הוא. |
updateReceivedTime |
המועד שבו העדכון היה זמין בפעם הראשונה. ערך אפס מציין שהשדה הזה לא מוגדר. השדה הזה מוגדר רק אם יש עדכון זמין (כלומר, הערך של הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
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 |
שם החומרה. לדוגמה, |
deviceBasebandVersion |
גרסת פס בסיס. לדוגמה, |
manufacturer |
היצרן. לדוגמה, |
serialNumber |
המספר הסידורי של המכשיר. |
model |
הדגם של המכשיר. לדוגמה, |
batteryShutdownTemperatures[] |
ערכי הסף של טמפרטורת כיבוי הסוללה בצלזיוס לכל סוללה במכשיר. |
batteryThrottlingTemperatures[] |
ערכי הסף של הטמפרטורה לוויסות הביצועים של הסוללה בצלזיוס לכל סוללה במכשיר. |
cpuShutdownTemperatures[] |
ערכי הסף לטמפרטורה של כיבוי המעבד (CPU) בצלזיוס לכל מעבד במכשיר. |
cpuThrottlingTemperatures[] |
ערכי הסף של טמפרטורת ויסות הנתונים (throttle) של המעבד (CPU) בצלזיוס לכל מעבד במכשיר. |
gpuShutdownTemperatures[] |
ערכי הסף של טמפרטורת כיבוי ה-GPU בצלזיוס לכל GPU במכשיר. |
gpuThrottlingTemperatures[] |
ערכי הסף של טמפרטורת ויסות הנתונים של GPU בצלזיוס לכל GPU במכשיר. |
skinShutdownTemperatures[] |
ערכי הסף של טמפרטורת העור של המכשיר לכיבוי, במעלות צלזיוס. |
skinThrottlingTemperatures[] |
ערכי הסף של טמפרטורת העור של המכשיר לצורך הגבלת הביצועים, במעלות צלזיוס. |
enterpriseSpecificId |
פלט בלבד. מזהה שמזהה באופן ייחודי מכשיר בבעלות אישית בארגון מסוים. באותו מכשיר פיזי, כשהמכשיר רשום לאותה הארגון, המזהה הזה נשמר במהלך ההגדרות ואפילו אחרי איפוס להגדרות המקוריות. התעודה הזו זמינה במכשירים בבעלות אישית עם פרופיל עבודה במכשירים עם Android מגרסה 12 ואילך. |
רשת המדיה
פרטי המסך של המכשיר.
ייצוג ב-JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
שדות | |
---|---|
name |
השם של המסך. |
displayId |
מזהה תצוגה ייחודי. |
refreshRate |
קצב הרענון של המסך בפריימים לשנייה. |
state |
מצב המסך. |
width |
רוחב התצוגה בפיקסלים. |
height |
גובה התצוגה בפיקסלים. |
density |
צפיפות התצוגה, שמבוטאת בנקודות לאינץ'. |
DisplayState
המצב של המסך.
טיפוסים בני מנייה (enum) | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
אסור להשתמש בערך הזה. |
OFF |
המסך כבוי. |
ON |
המסך פועל. |
DOZE |
המסך נמצא במצב שינה במצב צריכת אנרגיה נמוכה |
SUSPENDED |
המסך נמצא במצב שינה במצב חיסכון בסוללה מושעה. |
ApplicationReport
מידע שדווח על אפליקציה מותקנת.
ייצוג ב-JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
שדות | |
---|---|
packageName |
שם החבילה של האפליקציה. |
versionName |
גרסת האפליקציה כפי שהיא מוצגת למשתמש. |
versionCode |
קוד הגרסה של האפליקציה, שאפשר להשתמש בו כדי לקבוע אם גרסה אחת עדכנית יותר מגרסה אחרת. |
events[] |
רשימת אירועי האפליקציה שהתרחשו ב-30 השעות האחרונות. |
displayName |
השם המוצג של האפליקציה. |
packageSha256Hash |
גיבוב SHA-256 של קובץ ה-APK של האפליקציה, שאפשר להשתמש בו כדי לוודא שהאפליקציה לא שונתה. כל בית של ערך הגיבוב מיוצג כמספר הקסדצימלי בן שתי ספרות. |
signingKeyCertFingerprints[] |
הגיבוב מסוג SHA-1 של כל |
installerPackageName |
שם החבילה של האפליקציה שהתקינה את האפליקציה הזו. |
applicationSource |
המקור של החבילה. |
state |
מצב האפליקציה. |
keyedAppStates[] |
רשימה של מצבי האפליקציה עם מפתחות שדווחו על ידי האפליקציה. |
userFacingType |
האם האפליקציה פונה למשתמש. |
ApplicationEvent
אירוע שקשור לאפליקציה.
ייצוג ב-JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
eventType |
סוג האירוע באפליקציה. |
createTime |
שעת היצירה של האירוע. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
ApplicationEventType
סוג של אירוע שקשור לאפליקציה.
טיפוסים בני מנייה (enum) | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
אסור להשתמש בערך הזה. |
INSTALLED |
האפליקציה הותקנה. |
CHANGED |
האפליקציה השתנתה, למשל, רכיב הופעל או הושבת. |
DATA_CLEARED |
נתוני האפליקציה נמחקו. |
REMOVED |
האפליקציה הוסרה. |
REPLACED |
הותקנה גרסה חדשה של האפליקציה, שמחליפה את הגרסה הישנה. |
RESTARTED |
האפליקציה הופעלה מחדש. |
PINNED |
האפליקציה מוצמדת לחזית. |
UNPINNED |
הצמדת האפליקציה בוטלה. |
ApplicationSource
המקור שסיפק אפליקציה.
טיפוסים בני מנייה (enum) | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
האפליקציה הותקנה מחוץ לחנות Google Play ממקור לא ידוע. |
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'). |
createTime |
מועד היצירה של מצב האפליקציה במכשיר. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
lastUpdateTime |
השעה שבה מצב האפליקציה עודכן לאחרונה. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
מידת החומרה
רמת החומרה של מצב האפליקציה.
טיפוסים בני מנייה (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. לדוגמה, |
wifiMacAddress |
כתובת ה-MAC של ה-Wi-Fi של המכשיר. לדוגמה, |
networkOperatorName |
השם האלפביתי של המפעיל הרשום הנוכחי. לדוגמה, Vodafone. |
telephonyInfos[] |
מידע על טלפוניה שמשויך לכל כרטיס SIM במכשיר. התכונה נתמכת רק במכשירים מנוהלים באופן מלא, החל מרמת API 23 של Android. |
TelephonyInfo
פרטי טלפוניה שמשויכים לכרטיס SIM מסוים במכשיר. התכונה נתמכת רק במכשירים מנוהלים באופן מלא, החל מרמת API 23 של Android.
ייצוג ב-JSON |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string } |
שדות | |
---|---|
phoneNumber |
מספר הטלפון שמשויך לכרטיס ה-SIM הזה. |
carrierName |
שם הספק שמשויך לכרטיס ה-SIM הזה. |
iccId |
פלט בלבד. מספר ה-ICCID שמשויך לכרטיס ה-SIM הזה. |
MemoryInfo
מידע על הזיכרון והאחסון של המכשיר.
ייצוג ב-JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
שדות | |
---|---|
totalRam |
נפח ה-RAM הכולל במכשיר, בבייט. |
totalInternalStorage |
נפח האחסון הפנימי הכולל במכשיר בבייט. |
MemoryEvent
אירוע שקשור למדידות של זיכרון ואחסון.
כדי להבדיל בין אירועים חדשים לבין אירועים ישנים, מומלץ להשתמש בשדה
.createTime
ייצוג ב-JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
eventType |
סוג האירוע. |
createTime |
שעת היצירה של האירוע. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
byteCount |
מספר הבייטים הפנויים במדיום, או עבור |
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 ( |
שדות | |
---|---|
eventType |
סוג האירוע. |
createTime |
שעת היצירה של האירוע. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
batteryLevel |
באירועים מסוג |
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 ] } |
שדות | |
---|---|
createTime |
השעה שבה בוצעו המדידות. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
batteryTemperatures[] |
הטמפרטורות הנוכחיות של הסוללות במכשיר, במדידה בצלזיוס. |
cpuTemperatures[] |
הטמפרטורות הנוכחיות של המעבדים (CPU) בסולם צלזיוס לכל מעבד במכשיר. |
gpuTemperatures[] |
הטמפרטורות הנוכחיות של ה-GPU במדידה בסלזיוס לכל GPU במכשיר. |
skinTemperatures[] |
הטמפרטורות הנוכחיות של העור במכשיר, במעלות צלזיוס. |
fanSpeeds[] |
מהירויות המאווררים במספר סיבובים בדקה לכל מאוורר במכשיר. מערך ריק פירושו שאין מאווררים או שמהירות המאוורר לא נתמכת במערכת. |
cpuUsages[] |
שימוש ב-CPU באחוזים לכל ליבה שזמינה במכשיר. הערך של Usage הוא 0 לכל ליבה לא מחוברת. מערך ריק מציין שהמערכת לא תומכת בשימוש במעבד. |
DeviceSettings
מידע על הגדרות המכשיר שקשורות לאבטחה.
ייצוג ב-JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
שדות | |
---|---|
isDeviceSecure |
אם המכשיר מאובטח באמצעות קוד גישה או סיסמה. |
unknownSourcesEnabled |
אם האפשרות להתקין אפליקציות ממקורות לא מוכרים מופעלת. |
developmentSettingsEnabled |
אם מצב הפיתוח מופעל במכשיר. |
adbEnabled |
אם ADB מופעל במכשיר. |
isEncrypted |
האם הצפנת האחסון מופעלת. |
encryptionStatus |
סטטוס ההצפנה מ-DevicePolicyManager. |
verifyAppsEnabled |
אם אימות Google Play Protect נאכף במכשיר. |
EncryptionStatus
סטטוס ההצפנה של מכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
לא צוין. לא אמור להיות מכשיר עם סוג כזה. |
UNSUPPORTED |
המכשיר לא תומך בהצפנה. |
INACTIVE |
המכשיר תומך בהצפנה, אבל היא לא פעילה כרגע. |
ACTIVATING |
ההצפנה לא פעילה כרגע, אבל היא מופעלת כרגע. |
ACTIVE |
ההצפנה פועלת. |
ACTIVE_DEFAULT_KEY |
ההצפנה פעילה, אבל המשתמש לא מגדיר מפתח הצפנה. |
ACTIVE_PER_USER |
ההצפנה פעילה ומפתח ההצפנה קשור לפרופיל המשתמש. |
SecurityPosture
מצב האבטחה של המכשיר, כפי שנקבע לפי מצב המכשיר הנוכחי והמדיניות שחלה עליו.
ייצוג ב-JSON |
---|
{ "devicePosture": enum ( |
שדות | |
---|---|
devicePosture |
הערך של מצב האבטחה של המכשיר. |
postureDetails[] |
פרטים נוספים לגבי מצב האבטחה של המכשיר. |
DevicePosture
הערכים האפשריים של מצב האבטחה של מכשיר בניהול.
טיפוסים בני מנייה (enum) | |
---|---|
POSTURE_UNSPECIFIED |
לא צוין. אין פרטים לגבי תנוחת הגוף בערך הזה. |
SECURE |
המכשיר הזה מאובטח. |
AT_RISK |
המכשיר הזה עלול להיות פגיע יותר לגורמים זדוניים, ולכן לא מומלץ להשתמש בו עם נתונים עסקיים. |
POTENTIALLY_COMPROMISED |
יכול להיות שהמכשיר הזה נפרץ וגורמים לא מורשים יכולים לגשת לנתונים של החברה. |
PostureDetail
פרטים נוספים לגבי מצב האבטחה של המכשיר.
ייצוג ב-JSON |
---|
{ "securityRisk": enum ( |
שדות | |
---|---|
securityRisk |
סיכון אבטחה ספציפי שמשפיע לרעה על מצב האבטחה של המכשיר. |
advice[] |
ייעוץ מתאים לאדמינים כדי לצמצם את סיכון האבטחה הזה ולשפר את מצב האבטחה של המכשיר. |
SecurityRisk
הסיכון שגורם לכך שהמכשיר לא נמצא במצב האבטחה המאובטח ביותר.
טיפוסים בני מנייה (enum) | |
---|---|
SECURITY_RISK_UNSPECIFIED |
לא צוין. |
UNKNOWN_OS |
Play Integrity API מזהה שמופיעה במכשיר מערכת הפעלה לא ידועה (הבדיקות basicIntegrity ו-ctsProfileMatch עוברות, אבל הבדיקה 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 ( |
שדות | |
---|---|
commonCriteriaModeStatus |
האם מצב Common Criteria מופעל. |
policySignatureVerificationStatus |
פלט בלבד. הסטטוס של אימות החתימה על המדיניות. |
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 } |
שדות | |
---|---|
previousDpc |
פלט בלבד. אם המכשיר הזה הועבר מ-DPC אחר, זהו שם החבילה שלו. אחרת, השדה לא מאוכלס. |
additionalData |
פלט בלבד. אם המכשיר הזה הועבר מ-DPC אחר, השדה |
Methods |
|
---|---|
|
מחיקה של מכשיר. |
|
אחזור מכשיר. |
|
שליחת פקודה למכשיר. |
|
הצגת רשימה של מכשירים בארגון נתון. |
|
עדכון מכשיר. |