- משאב: מכשיר
- 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
- DpcMigrationInfo
- שיטות
משאב: מכשיר
מכשיר בבעלות ארגון. אלא אם צוין אחרת, כל השדות הם לקריאה בלבד ואי אפשר לשנות אותם עד enterprises.devices.patch
.
ייצוג JSON |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
שדות | |
---|---|
name |
שם המכשיר בפורמט |
userName |
שם המשאב של המשתמש שהוא הבעלים של המכשיר הזה, בצורה |
managementMode |
סוג מצב הניהול של אפליקציית Android Device Policy במכשיר. זה משפיע על הגדרות המדיניות הנתמכות. |
state |
המצב שיש להחיל על המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. חשוב לשים לב שכשקוראים ל- |
appliedState |
המצב שמוגדר כרגע על המכשיר. |
policyCompliant |
האם המכשיר עומד בדרישות המדיניות שלו. |
nonComplianceDetails[] |
פרטים על הגדרות המדיניות שהמכשיר לא עומד בהן. |
enrollmentTime |
מועד שיוך המכשיר לארגון. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
lastStatusReportTime |
הפעם האחרונה שהמכשיר שלח דוח סטטוס. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
lastPolicyComplianceReportTime |
הוּצא משימוש. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
lastPolicySyncTime |
הפעם האחרונה שהמכשיר אחזר את המדיניות שלו. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
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
מדינות שאפשר להחיל על מכשיר.
טיפוסים בני מנייה (enums) | |
---|---|
DEVICE_STATE_UNSPECIFIED |
הערך הזה אסור. |
ACTIVE |
המכשיר פעיל. |
DISABLED |
המכשיר מושבת. |
DELETED |
המכשיר נמחק. המצב הזה אף פעם לא מוחזר על ידי קריאה ל-API, אבל הוא משמש בדוח הסטטוס הסופי כשהמכשיר מאשר את המחיקה. אם המכשיר יימחק דרך הקריאה ל-API, המצב הזה יפורסם ב-Pub/Sub. אם המשתמש ימחק את פרופיל העבודה או יאפס את המכשיר, מצב המכשיר לא ישתנה לשרת. |
PROVISIONING |
ניהול ההקצאות של המכשיר מתבצע. מכשירים חדשים שנרשמו נמצאים במצב הזה עד שתוחל עליהם מדיניות. |
LOST |
המכשיר אבד. אפשר לשמור את המצב הזה רק במכשירים שבבעלות הארגון. |
PREPARING_FOR_MIGRATION |
המכשיר מתכונן למעבר ל-Android Management API. אין צורך בפעולה נוספת כדי להמשיך את תהליך ההעברה. |
NonComplianceDetail
מספקת פרטים על אי-תאימות להגדרת מדיניות.
ייצוג JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
שדות | |
---|---|
settingName |
השם של הגדרת המדיניות. זהו השם של שדה ה-JSON של שדה |
nonComplianceReason |
הסיבה שבגללה המכשיר לא תואם להגדרה. |
packageName |
שם החבילה שמציין איזו אפליקציה לא עומדת בדרישות, אם רלוונטי. |
fieldPath |
בהגדרות עם שדות מקוננים, אם שדה מקונן מסוים לא עומד בדרישות, השדה הזה מציין את הנתיב המלא לשדה הפוגע. הנתיב בפורמט זהה לזה של שדה ה-JSON של המדיניות ב-JavaScript. כלומר: 1) בשדות מסוג אובייקט, לאחר שם השדה תופיע נקודה ולאחר מכן שם של שדה משנה. 2) בשדות מסוג מערך, לאחר שם השדה מופיע אינדקס המערך שמוקף בסוגריים. לדוגמה, כדי לציין בעיה בשדה |
currentValue |
אם לא ניתן להחיל את הגדרת המדיניות, הערך הנוכחי של ההגדרה במכשיר. |
installationFailureReason |
אם המדיניות |
specificNonComplianceReason |
הסיבה הספציפית למדיניות שהמכשיר לא תואם להגדרה. |
specificNonComplianceContext |
הקשר נוסף עבור |
InstallationFailureReason
סיבות אפשריות לכישלון של התקנת אפליקציה.
טיפוסים בני מנייה (enums) | |
---|---|
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).
טיפוסים בני מנייה (enums) | |
---|---|
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 |
הגדרת ONC Wi-Fi לא נתמכת ברמת ה-API של גרסת Android שפועלת במכשיר. הערך מציין איזה ערך של השדה לא נתמך. הוגדר. מוגדר לערך . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
ברשת ה-Wi-Fi של הארגון חסרים רשות האישורים או שם הדומיין ברמה הבסיסית. מוגדר לערך . |
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 |
קוד הגרסה של אפליקציית Android Device Policy. |
androidDevicePolicyVersionName |
גרסת האפליקציה של Android Device Policy כפי שמוצגת למשתמש. |
androidBuildNumber |
מחרוזת של מזהה ה-build של Android שמיועדת להצגה למשתמש. לדוגמה, |
deviceKernelVersion |
גרסת הליבה, למשל |
bootloaderVersion |
מספר הגרסה של תוכנת האתחול של המערכת, למשל |
androidBuildTime |
זמן Build. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
securityPatchLevel |
רמת תיקון האבטחה, למשל |
primaryLanguageCode |
קוד שפה IETF BCP 47 ללוקאל הראשי של המכשיר. |
deviceBuildSignature |
גיבוב SHA-256 של |
systemUpdateInfo |
מידע על עדכון מערכת פוטנציאלי בהמתנה. |
SystemUpdateInfo
מידע על עדכון מערכת פוטנציאלי בהמתנה.
ייצוג JSON |
---|
{
"updateStatus": enum ( |
שדות | |
---|---|
updateStatus |
סטטוס העדכון: האם קיים עדכון ומה הסוג שלו. |
updateReceivedTime |
השעה שבה העדכון היה זמין לראשונה. הערך אפס מציין שהשדה הזה לא מוגדר. השדה הזה מוגדר רק אם יש עדכון זמין (כלומר, חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
UpdateStatus
סטטוס העדכון: האם קיים עדכון ומה הסוג שלו.
טיפוסים בני מנייה (enums) | |
---|---|
UPDATE_STATUS_UNKNOWN |
לא ידוע אם יש עדכון מערכת בהמתנה. זה קורה למשל כשרמת ה-API במכשיר נמוכה מ-26, או כשהגרסה של Android Device Policy מיושנת. |
UP_TO_DATE |
אין למכשיר עדכון מערכת בהמתנה. |
UNKNOWN_UPDATE_AVAILABLE |
יש עדכון מערכת זמין, אבל הסוג שלו לא ידוע. |
SECURITY_UPDATE_AVAILABLE |
יש עדכון אבטחה זמין שנמצא בהמתנה. |
OS_UPDATE_AVAILABLE |
יש עדכון OS זמין שנמצא בהמתנה. |
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), בצלזיוס לכל מעבד (CPU) במכשיר. |
cpuThrottlingTemperatures[] |
ערכי הסף של ויסות הטמפרטורה של המעבד (CPU) בצלזיוס לכל מעבד (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
המצב של המסך.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
שעת היצירה של האירוע. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
ApplicationEventType
סוג של אירוע שקשור לאפליקציה.
טיפוסים בני מנייה (enums) | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
הערך הזה אסור. |
INSTALLED |
האפליקציה הותקנה. |
CHANGED |
האפליקציה שונתה, לדוגמה, רכיב הופעל או הושבת. |
DATA_CLEARED |
נתוני האפליקציה נוקו. |
REMOVED |
האפליקציה הוסרה. |
REPLACED |
הותקנה גרסה חדשה של האפליקציה, שמחליפה את הגרסה הישנה. |
RESTARTED |
האפליקציה הופעלה מחדש. |
PINNED |
האפליקציה הוצמדה לחזית. |
UNPINNED |
הצמדת האפליקציה בוטלה. |
ApplicationSource
המקור שסיפק את האפליקציה.
טיפוסים בני מנייה (enums) | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
בוצעה התקנה של האפליקציה ממקור שלא צוין. |
SYSTEM_APP_FACTORY_VERSION |
זוהי אפליקציית מערכת מתמונת היצרן של המכשיר. |
SYSTEM_APP_UPDATED_VERSION |
זוהי אפליקציית מערכת מעודכנת. |
INSTALLED_FROM_PLAY_STORE |
האפליקציה הותקנה דרך חנות Google Play. |
ApplicationState
סטטוס ההתקנה הנוכחי.
טיפוסים בני מנייה (enums) | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
לא צוין מצב האפליקציה |
REMOVED |
האפליקציה הוסרה מהמכשיר |
INSTALLED |
האפליקציה מותקנת במכשיר |
KeyedAppState
מצב האפליקציה הראשי שדווח על ידי האפליקציה.
ייצוג JSON |
---|
{
"key": string,
"severity": enum ( |
שדות | |
---|---|
key |
המפתח למצב האפליקציה. משמש כנקודת השוואה של המצב שהאפליקציה מספקת לו. לדוגמה, כששולחים משוב על הגדרות מנוהלות, המפתח הזה יכול להיות מפתח ההגדרה המנוהלת. |
severity |
מידת החומרה של מצב האפליקציה. |
message |
אפשר גם להוסיף מחרוזת של הודעה בפורמט חופשי כדי להסביר את מצב האפליקציה. אם המצב הופעל על ידי ערך מסוים (למשל, ערך של הגדרה מנוהלת), הוא צריך להיכלל בהודעה. |
data |
אופציונלי: ערך קריא למחשבים שה-EMM יקריא. לדוגמה, הגדרת ערכים שהאדמין יכול לבחור בשאילתה שלהם במסוף ה-EMM (למשל, "אני רוצה לקבל תזכורת אם נתוני הסוללה < 10"). |
createTime |
שעת היצירה של מצב האפליקציה במכשיר. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
lastUpdateTime |
מועד העדכון האחרון של מצב האפליקציה. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
מידת החומרה
מידת החומרה של מצב האפליקציה.
טיפוסים בני מנייה (enums) | |
---|---|
SEVERITY_UNSPECIFIED |
רמת החומרה לא צוינה. |
INFO |
רמת החומרה של המידע. |
ERROR |
רמת החומרה של השגיאה. צריך להגדיר את האפשרות הזו רק במקרים של שגיאות אמיתיים שארגון הניהול צריך לנקוט פעולה כדי לתקן אותן. |
UserFacingType
האם האפליקציה גלויה למשתמשים.
טיפוסים בני מנייה (enums) | |
---|---|
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 של Android 23. |
TelephonyInfo
נתוני טלפוניה המשויכים לכרטיס SIM נתון במכשיר. התכונה נתמכת רק במכשירים מנוהלים החל מרמת API של Android 23.
ייצוג JSON |
---|
{ "phoneNumber": string, "carrierName": string } |
שדות | |
---|---|
phoneNumber |
מספר הטלפון שמשויך לכרטיס ה-SIM הזה. |
carrierName |
שם הספק המשויך לכרטיס ה-SIM הזה. |
MemoryInfo
מידע על הזיכרון והאחסון במכשיר.
ייצוג JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
שדות | |
---|---|
totalRam |
סך ה-RAM במכשיר בבייטים. |
totalInternalStorage |
סך כל האחסון הפנימי במכשיר בבייטים. |
MemoryEvent
אירוע שקשור למדידות של הזיכרון והאחסון.
כדי להבחין בין אירועים חדשים לאירועים ישנים, מומלץ להשתמש בשדה
.createTime
ייצוג JSON |
---|
{
"eventType": enum ( |
שדות | |
---|---|
eventType |
סוג האירוע. |
createTime |
שעת היצירה של האירוע. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
byteCount |
מספר הבייטים הפנויים באמצעי האחסון, או עבור |
MemoryEventType
סוג האירוע.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
שעת היצירה של האירוע. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
batteryLevel |
באירועי |
PowerManagementEventType
סוג האירוע.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
השעה שבה בוצעו המדידות. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
batteryTemperatures[] |
הטמפרטורות הנוכחיות של הסוללה בצלזיוס לכל סוללה במכשיר. |
cpuTemperatures[] |
הטמפרטורות הנוכחיות של המעבד (CPU) בצלזיוס לכל מעבד (CPU) במכשיר. |
gpuTemperatures[] |
הטמפרטורות הנוכחיות של יחידת ה-GPU בצלזיוס לכל יחידת GPU במכשיר. |
skinTemperatures[] |
טמפרטורות העור הנוכחיות של המכשיר בצלזיוס. |
fanSpeeds[] |
מהירויות המאוורר בסל"ד לכל מאוורר במכשיר. המשמעות של מערך ריק היא שאין מאווררים או שמהירות המאוורר לא נתמכת במערכת. |
cpuUsages[] |
אחוז השימוש במעבד (CPU) לכל ליבה שזמינה במכשיר. השימוש הוא 0 לכל ליבה מנותקת. אם מערך ריק, השימוש במעבד (CPU) לא נתמך במערכת. |
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
סטטוס ההצפנה של המכשיר.
טיפוסים בני מנייה (enums) | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
לא צוין. אף מכשיר לא אמור להיות מהסוג הזה. |
UNSUPPORTED |
ההצפנה אינה נתמכת על ידי המכשיר. |
INACTIVE |
ההצפנה נתמכת על ידי המכשיר, אבל אינה פעילה כרגע. |
ACTIVATING |
ההצפנה לא פעילה כרגע, אבל היא מופעלת כרגע. |
ACTIVE |
ההצפנה פעילה. |
ACTIVE_DEFAULT_KEY |
ההצפנה פעילה, אבל המשתמש לא הגדיר מפתח הצפנה. |
ACTIVE_PER_USER |
ההצפנה פעילה ומפתח ההצפנה מקושר לפרופיל המשתמש. |
SecurityPosture
מצב האבטחה של המכשיר, שנקבע לפי מצב המכשיר הנוכחי והמדיניות שהוחלה.
ייצוג JSON |
---|
{ "devicePosture": enum ( |
שדות | |
---|---|
devicePosture |
הערך של מצב האבטחה במכשיר. |
postureDetails[] |
פרטים נוספים על מצב האבטחה של המכשיר. |
DevicePosture
ערכים אפשריים של מצב אבטחה במכשיר שנמצא בניהול.
טיפוסים בני מנייה (enums) | |
---|---|
POSTURE_UNSPECIFIED |
לא צוין. אין פרטי מצבה עבור ערך המצב הזה. |
SECURE |
המכשיר הזה מאובטח. |
AT_RISK |
המכשיר הזה עשוי להיות חשוף יותר לגורמים זדוניים יותר מהמומלץ לשימוש עם נתונים ארגוניים. |
POTENTIALLY_COMPROMISED |
ייתכן שהמכשיר הזה נפרץ ונתונים ארגוניים עשויים להיות נגישים לגורמים לא מורשים. |
PostureDetail
פרטים נוספים על מצב האבטחה של המכשיר.
ייצוג JSON |
---|
{ "securityRisk": enum ( |
שדות | |
---|---|
securityRisk |
סיכון אבטחה ספציפי שמשפיע לרעה על מצב האבטחה של המכשיר. |
advice[] |
עצות רלוונטיות ממנהלי מערכת לצמצום סיכון האבטחה הזה ולשיפור מצב האבטחה של המכשיר. |
SecurityRisk
הסיכון שבגללו המכשיר לא יהיה במצב המאובטח ביותר.
טיפוסים בני מנייה (enums) | |
---|---|
SECURITY_RISK_UNSPECIFIED |
לא צוין. |
UNKNOWN_OS |
Play Integrity API מזהה שבמכשיר פועלת מערכת הפעלה לא ידועה (בדיקת התקינות הבסיסית מצליחה אבל ctsProfileMatch נכשל). |
COMPROMISED_OS |
Play Integrity API מזהה שבמכשיר פועלת מערכת הפעלה שנחשפה (בדיקת תקינות בסיסית נכשלה). |
HARDWARE_BACKED_EVALUATION_FAILED |
Play Integrity API מזהה שרמת הביטחון של המכשיר לתקינות המערכת לא גבוהה, אם התווית MEETS_STRONG_INTEGRITY לא מופיעה בשדה תקינות המכשיר. |
CommonCriteriaModeInfo
מידע על מצב Common Criteria – תקני האבטחה שמוגדרים ב-Common Criteria for Information Technology Security Evaluation (CC).
המידע הזה זמין רק אם הערך של statusReportingSettings.commonCriteriaModeEnabled
הוא true
במדיניות של המכשיר.
ייצוג JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
שדות | |
---|---|
commonCriteriaModeStatus |
האם מצב Common Criteria מופעל. |
CommonCriteriaModeStatus
האם מצב Common Criteria מופעל.
טיפוסים בני מנייה (enums) | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
סטטוס לא ידוע. |
COMMON_CRITERIA_MODE_DISABLED |
מצב Common Criteria מושבת כרגע. |
COMMON_CRITERIA_MODE_ENABLED |
מצב Common Criteria מופעל כרגע. |
DpcMigrationInfo
מידע שקשור לכך שהמכשיר הזה הועבר מניהול על ידי בקר אחר של מדיניות המכשיר (DPC).
ייצוג JSON |
---|
{ "previousDpc": string, "additionalData": string } |
שדות | |
---|---|
previousDpc |
פלט בלבד. אם המכשיר הזה הועבר מבקר DPC אחר, זהו שם החבילה שלו. אחרת, לא אוכלסו. |
additionalData |
פלט בלבד. אם המכשיר הזה הועבר מבקר DPC אחר, השדה |
שיטות |
|
---|---|
|
מחיקת מכשיר. |
|
מקבל מכשיר. |
|
שולחים פקודה למכשיר. |
|
רשימה של מכשירים של ארגון נתון. |
|
מתבצע עדכון של מכשיר. |