REST Resource: enterprises.devices

משאב: מכשיר

מכשיר בבעלות ארגון. אלא אם צוין אחרת, כל השדות הם לקריאה בלבד ואי אפשר לשנות אותם עד enterprises.devices.patch.

ייצוג JSON 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
שדות
name

string

שם המכשיר בפורמט enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

שם המשאב של המשתמש שהוא הבעלים של המכשיר הזה, בצורה enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

סוג מצב הניהול של אפליקציית Android Device Policy במכשיר. זה משפיע על הגדרות המדיניות הנתמכות.
state

enum (DeviceState)

המצב שיש להחיל על המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. חשוב לשים לב שכשקוראים ל-enterprises.devices.patch, ל-ACTIVE ול-DISABLED הם הערכים המותרים היחידים. כדי להעביר את המכשיר למצב DELETED, צריך להתקשר אל enterprises.devices.delete.
appliedState

enum (DeviceState)

המצב שמוגדר כרגע על המכשיר.
policyCompliant

boolean

האם המכשיר עומד בדרישות המדיניות שלו.
nonComplianceDetails[]

object (NonComplianceDetail)

פרטים על הגדרות המדיניות שהמכשיר לא עומד בהן.
enrollmentTime

string (Timestamp format)

מועד שיוך המכשיר לארגון.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

הפעם האחרונה שהמכשיר שלח דוח סטטוס.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

הוּצא משימוש.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

הפעם האחרונה שהמכשיר אחזר את המדיניות שלו.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
policyName

string

שם המדיניות שהוחלה על המכשיר, בפורמט enterprises/{enterpriseId}/policies/{policyId}. אם המדיניות לא מוגדרת, הערך policyName חל עבור משתמש המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. אפשר לציין רק את policyId כשקוראים אל enterprises.devices.patch, כל עוד אין לוכסנים ב-policyId. המערכת מסיקה את שאר שם המדיניות.
appliedPolicyName

string

שם המדיניות שמוחלת כרגע על המכשיר.
appliedPolicyVersion

string (int64 format)

גרסת המדיניות שמוחלת עכשיו על המכשיר.
apiLevel

integer

רמת ה-API של גרסת פלטפורמת Android שפועלת במכשיר.
enrollmentTokenData

string

אם המכשיר נרשם באמצעות אסימון רישום עם נתונים נוספים, השדה הזה מכיל את הנתונים.
enrollmentTokenName

string

אם המכשיר נרשם באמצעות אסימון רישום, השדה הזה מכיל את שם האסימון.
disabledReason

object (UserFacingMessage)

אם מצב המכשיר הוא DISABLED, זו הודעה אופציונלית שמוצגת במכשיר שמציינת את הסיבה להשבתת המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון.
softwareInfo

object (SoftwareInfo)

מידע מפורט על התוכנה של המכשיר. המידע הזה זמין רק אם המדיניות softwareInfoEnabled מוגדרת כ-True במדיניות המכשיר.
hardwareInfo

object (HardwareInfo)

מידע מפורט על החומרה של המכשיר.
displays[]

object (Display)

מידע מפורט על המסכים במכשיר. המידע הזה זמין רק אם המדיניות displayInfoEnabled מוגדרת כ-True במדיניות המכשיר.
applicationReports[]

object (ApplicationReport)

דוחות לגבי האפליקציות שמותקנות במכשיר. המידע הזה זמין רק אם הערך applicationReportsEnabled מוגדר במדיניות של המכשיר.
previousDeviceNames[]

string

אם אותו מכשיר פיזי נרשם כמה פעמים, השדה הזה יכלול את שמות המכשירים הקודמים שלו. המספר הסידורי משמש כמזהה ייחודי כדי לקבוע אם אותו מכשיר פיזי נרשם בעבר. השמות מופיעים בסדר כרונולוגי.
networkInfo

object (NetworkInfo)

פרטי הרשת של המכשיר המידע הזה זמין רק אם המדיניות networkInfoEnabled מוגדרת כ-True במדיניות המכשיר.
memoryInfo

object (MemoryInfo)

פרטי זיכרון: מכיל מידע על הזיכרון והאחסון של המכשיר.
memoryEvents[]

object (MemoryEvent)

אירועים שקשורים למדידות זיכרון ואחסון בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות memoryInfoEnabled מוגדרת כ-True במדיניות המכשיר.

אירועים נשמרים לפרק זמן מסוים ואירועים ישנים נמחקים.
powerManagementEvents[]

object (PowerManagementEvent)

אירועים של ניהול צריכת חשמל במכשיר בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות powerManagementEventsEnabled מוגדרת כ-True במדיניות המכשיר.
hardwareStatusSamples[]

object (HardwareStatus)

דוגמאות של סטטוס חומרה בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות hardwareStatusEnabled מוגדרת כ-True במדיניות המכשיר.
deviceSettings

object (DeviceSettings)

פרטי הגדרות המכשיר. המידע הזה זמין רק אם המדיניות deviceSettingsEnabled מוגדרת כ-True במדיניות המכשיר.
user

object (User)

המשתמש שהמכשיר הוא הבעלים שלו.
systemProperties

map (key: string, value: string)

מפה של השם והערך של מאפייני המערכת שנבחרו שקשורים למכשיר. המידע הזה זמין רק אם המדיניות systemPropertiesEnabled מוגדרת כ-True במדיניות המכשיר.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

ערך מצב האבטחה של המכשיר, שמשקף את מידת האבטחה שלו.
ownership

enum (Ownership)

בעלות על המכשיר המנוהל.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

מידע על מצב Common Criteria – תקני האבטחה שמוגדרים ב-Common Criteria for Information Technology Security Evaluation (CC).

המידע הזה זמין רק אם הסטטוס של statusReportingSettings.commonCriteriaModeEnabled הוא true במדיניות של המכשיר.
appliedPasswordPolicies[]

object (PasswordRequirements)

דרישות הסיסמה שחלות כרגע על המכשיר.

  • במקרים מסוימים, הדרישות שהוחלו עשויות להיות שונות מעט מאלה שצוינו ב-passwordPolicies.
  • fieldPath מוגדר לפי passwordPolicies.
dpcMigrationInfo

object (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 (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
שדות
settingName

string

השם של הגדרת המדיניות. זהו השם של שדה ה-JSON של שדה Policy ברמה העליונה.
nonComplianceReason

enum (NonComplianceReason)

הסיבה שבגללה המכשיר לא תואם להגדרה.
packageName

string

שם החבילה שמציין איזו אפליקציה לא עומדת בדרישות, אם רלוונטי.
fieldPath

string

בהגדרות עם שדות מקוננים, אם שדה מקונן מסוים לא עומד בדרישות, השדה הזה מציין את הנתיב המלא לשדה הפוגע. הנתיב בפורמט זהה לזה של שדה ה-JSON של המדיניות ב-JavaScript. כלומר: 1) בשדות מסוג אובייקט, לאחר שם השדה תופיע נקודה ולאחר מכן שם של שדה משנה. 2) בשדות מסוג מערך, לאחר שם השדה מופיע אינדקס המערך שמוקף בסוגריים. לדוגמה, כדי לציין בעיה בשדה url בשדה externalData באפליקציה השלישית, הנתיב יהיה applications[2].externalData.url
currentValue

value (Value format)

אם לא ניתן להחיל את הגדרת המדיניות, הערך הנוכחי של ההגדרה במכשיר.
installationFailureReason

enum (InstallationFailureReason)

אם המדיניות packageName מוגדרת והסיבה לאי-תאימות היא APP_NOT_INSTALLED או APP_NOT_UPDATED, הסיבה המפורטת לכך שלא ניתן להתקין או לעדכן את האפליקציה.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

הסיבה הספציפית למדיניות שהמכשיר לא תואם להגדרה.
specificNonComplianceContext

object (SpecificNonComplianceContext)

הקשר נוסף עבור specificNonComplianceReason.

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

שגיאת רשת במכשיר של המשתמש מנעה את ההצלחה של ההתקנה. זה קורה בדרך כלל כשהחיבור לאינטרנט של המכשיר פגום, לא זמין או כשיש בעיה בהגדרת הרשת. צריך לוודא שלמכשיר יש גישה לחיבור אינטרנט מלא ברשת שעומדת בדרישות של Android Enterprise Network Requirements. במקרה כזה, ההתקנה או העדכון של האפליקציה ימשיכו באופן אוטומטי.
INSUFFICIENT_STORAGE במכשיר של המשתמש אין מספיק נפח אחסון פנוי להתקנת האפליקציה. כדי לפתור את הבעיה, אפשר לפנות מקום אחסון במכשיר. ההתקנה או העדכון של האפליקציה ימשיכו באופן אוטומטי ברגע שיהיה במכשיר מספיק נפח אחסון.

SpecificNonComplianceReason

פרטים נוספים על הסיבה לכך שמכשיר לא תואם להגדרת מדיניות מסוימת. בעתיד אפשר יהיה להוסיף ערכים חדשים לטיפוסים בני מנייה (enum).

טיפוסים בני מנייה (enums)
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED הסיבה הספציפית לאי-תאימות לא צוינה. השדות בspecificNonComplianceContext לא הוגדרו.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED המשתמש צריך לאשר את פרטי הכניסה על ידי הזנת נעילת המסך. השדות בspecificNonComplianceContext לא הוגדרו. nonComplianceReason מוגדר לערך USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED פג התוקף של סיסמת המכשיר או הפרופיל. passwordPoliciesContext הוגדר. nonComplianceReason מוגדר לערך USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT סיסמת המכשיר לא עומדת בדרישות הסיסמה. passwordPoliciesContext הוגדר. nonComplianceReason מוגדר לערך USER_ACTION.
ONC_WIFI_INVALID_VALUE יש ערך שגוי בתצורת Wi-Fi של ONC. הערך fieldPath מציין איזה ערך בשדה שגוי. oncWifiContext הוגדר. nonComplianceReason מוגדר לערך INVALID_VALUE.
ONC_WIFI_API_LEVEL הגדרת ONC Wi-Fi לא נתמכת ברמת ה-API של גרסת Android שפועלת במכשיר. הערך fieldPath מציין איזה ערך של השדה לא נתמך. oncWifiContext הוגדר. nonComplianceReason מוגדר לערך API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG ברשת ה-Wi-Fi של הארגון חסרים רשות האישורים או שם הדומיין ברמה הבסיסית. nonComplianceReason מוגדר לערך INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK המשתמש צריך להסיר את רשת ה-Wi-Fi שהוגדרה באופן ידני. רלוונטי רק לפרופילים של עבודה במכשירים בבעלות אישית. nonComplianceReason מוגדר לערך USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY הכינוי של זוג המפתחות שצוין בשדה ClientCertKeyPairAlias ב-openNetworkConfiguration לא תואם למפתח קיים שהותקן במכשיר. nonComplianceReason מוגדר לערך INVALID_VALUE.

SpecificNonComplianceContext

הקשר נוסף עבור SpecificNonComplianceReason.

ייצוג JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
שדות
oncWifiContext

object (OncWifiContext)

הקשר נוסף במקרים של אי-תאימות שקשורה להגדרת Wi-Fi. פרטים נוספים זמינים ב-ONC_WIFI_INVALID_VALUE וב-ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

הקשר נוסף לאי-תאימות שקשורה למדיניות בנושא סיסמאות. פרטים נוספים זמינים בPASSWORD_POLICIES_PASSWORD_EXPIRED ובPASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

הקשר נוסף במקרים של אי-תאימות שקשורה להגדרת Wi-Fi.

ייצוג JSON 
{
  "wifiGuid": string
}
שדות
wifiGuid

string

ה-GUID של תצורת Wi-Fi שלא תואמת.

PasswordPoliciesContext

הקשר נוסף לאי-תאימות שקשורה למדיניות בנושא סיסמאות.

ייצוג JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
שדות
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 (SystemUpdateInfo)
  }
}
שדות
androidVersion

string

מחרוזת גרסת Android הגלויה למשתמש. לדוגמה, 6.0.1.
androidDevicePolicyVersionCode

integer

קוד הגרסה של אפליקציית Android Device Policy.
androidDevicePolicyVersionName

string

גרסת האפליקציה של Android Device Policy כפי שמוצגת למשתמש.
androidBuildNumber

string

מחרוזת של מזהה ה-build של Android שמיועדת להצגה למשתמש. לדוגמה, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

גרסת הליבה, למשל 2.6.32.9-g103d848.
bootloaderVersion

string

מספר הגרסה של תוכנת האתחול של המערכת, למשל 0.6.7.
androidBuildTime

string (Timestamp format)

זמן Build.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
securityPatchLevel

string

רמת תיקון האבטחה, למשל 2016-05-01.
primaryLanguageCode

string

קוד שפה IETF BCP 47 ללוקאל הראשי של המכשיר.
deviceBuildSignature

string

גיבוב SHA-256 של android.content.pm.Signature שמשויך לחבילת המערכת. אפשר להשתמש בו כדי לוודא שלא בוצעו שינויים ב-build של המערכת.
systemUpdateInfo

object (SystemUpdateInfo)

מידע על עדכון מערכת פוטנציאלי בהמתנה.

SystemUpdateInfo

מידע על עדכון מערכת פוטנציאלי בהמתנה.

ייצוג JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
שדות
updateStatus

enum (UpdateStatus)

סטטוס העדכון: האם קיים עדכון ומה הסוג שלו.
updateReceivedTime

string (Timestamp format)

השעה שבה העדכון היה זמין לראשונה. הערך אפס מציין שהשדה הזה לא מוגדר. השדה הזה מוגדר רק אם יש עדכון זמין (כלומר, updateStatus הוא לא UPDATE_STATUS_UNKNOWN וגם לא UP_TO_DATE).

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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

string

המותג של המכשיר. לדוגמה, Google.
hardware

string

שם החומרה. לדוגמה, Angler.
deviceBasebandVersion

string

גרסת פס בסיס. לדוגמה, MDM9625_104662.22.05.34p.
manufacturer

string

יצרן. לדוגמה, Motorola.
serialNumber

string

המספר הסידורי של המכשיר.
model

string

הדגם של המכשיר. לדוגמה, Asus Nexus 7.
batteryShutdownTemperatures[]

number

ערכי הסף של הטמפרטורה לכיבוי הסוללה בצלזיוס לכל סוללה במכשיר.
batteryThrottlingTemperatures[]

number

ערכי הסף של ויסות הטמפרטורה של הסוללה בצלזיוס לכל סוללה במכשיר.
cpuShutdownTemperatures[]

number

ערכי סף של טמפרטורות לכיבוי המעבד (CPU), בצלזיוס לכל מעבד (CPU) במכשיר.
cpuThrottlingTemperatures[]

number

ערכי הסף של ויסות הטמפרטורה של המעבד (CPU) בצלזיוס לכל מעבד (CPU) במכשיר.
gpuShutdownTemperatures[]

number

ערכי סף לכיבוי של GPU בצלזיוס לכל יחידת GPU במכשיר.
gpuThrottlingTemperatures[]

number

ערכי הסף של ויסות הטמפרטורה של ה-GPU בצלזיוס לכל GPU במכשיר.
skinShutdownTemperatures[]

number

ערכי הסף לכיבוי העור במכשיר, בצלזיוס.
skinThrottlingTemperatures[]

number

ערכי הסף של טמפרטורת העור של המכשיר בצלזיוס.
enterpriseSpecificId

string

פלט בלבד. מזהה שמזהה באופן ייחודי מכשיר בבעלות אישית בארגון מסוים. המזהה הזה מופיע באותו מכשיר פיזי כשהוא רשום באותו ארגון, בכל ההגדרות ואפילו באיפוס להגדרות המקוריות. המזהה הזה זמין במכשירים אישיים עם פרופיל עבודה במכשירים עם Android 12 ומעלה.

מסך

מידע על תצוגת המכשיר.

ייצוג JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
שדות
name

string

שם המסך.
displayId

integer

מזהה ייחודי לתצוגה.
refreshRate

integer

קצב הרענון של התצוגה בפריימים לשנייה.
state

enum (DisplayState)

מצב המסך.
width

integer

רוחב התצוגה בפיקסלים.
height

integer

גובה התצוגה בפיקסלים.
density

integer

צפיפות התצוגה מבוטאת כנקודות לאינץ'.

DisplayState

המצב של המסך.

טיפוסים בני מנייה (enums)
DISPLAY_STATE_UNSPECIFIED הערך הזה אסור.
OFF המסך כבוי.
ON המסך פועל.
DOZE המסך נתקע במצב של צריכת חשמל נמוכה
SUSPENDED המסך נתקע במצב של סוללה חלשה.

ApplicationReport

דיווח מידע על אפליקציה מותקנת.

ייצוג JSON 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
שדות
packageName

string

שם החבילה של האפליקציה.
versionName

string

גרסת האפליקציה כפי שמוצגת למשתמש.
versionCode

integer

קוד גרסת האפליקציה, שבעזרתו אפשר לקבוע אם גרסה אחת עדכנית יותר מהאחרת.
events[]

object (ApplicationEvent)

רשימת האירועים באפליקציה שהתרחשו ב-30 השעות האחרונות.
displayName

string

השם המוצג של האפליקציה.
packageSha256Hash

string

גיבוב SHA-256 של קובץ ה-APK של האפליקציה, שיכול לשמש כדי לוודא שלא בוצעו שינויים באפליקציה. כל בייט של ערך הגיבוב מיוצג כמספר הקסדצימאלי דו-ספרתי.
signingKeyCertFingerprints[]

string

גיבוב SHA-1 של כל android.content.pm.Signature המשויך לחבילת האפליקציה. כל בייט של כל ערך גיבוב מיוצג כמספר הקסדצימאלי דו-ספרתי.
installerPackageName

string

שם החבילה של האפליקציה שהתקינה אותה.
applicationSource

enum (ApplicationSource)

מקור החבילה.
state

enum (ApplicationState)

מצב האפליקציה.
keyedAppStates[]

object (KeyedAppState)

רשימת מצבי האפליקציה העיקריים שדווחו על ידי האפליקציה.
userFacingType

enum (UserFacingType)

האם האפליקציה גלויה למשתמשים.

ApplicationEvent

אירוע שקשור לאפליקציה.

ייצוג JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
שדות
eventType

enum (ApplicationEventType)

סוג אירוע באפליקציה.
createTime

string (Timestamp format)

שעת היצירה של האירוע.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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 (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
שדות
key

string

המפתח למצב האפליקציה. משמש כנקודת השוואה של המצב שהאפליקציה מספקת לו. לדוגמה, כששולחים משוב על הגדרות מנוהלות, המפתח הזה יכול להיות מפתח ההגדרה המנוהלת.
severity

enum (Severity)

מידת החומרה של מצב האפליקציה.
message

string

אפשר גם להוסיף מחרוזת של הודעה בפורמט חופשי כדי להסביר את מצב האפליקציה. אם המצב הופעל על ידי ערך מסוים (למשל, ערך של הגדרה מנוהלת), הוא צריך להיכלל בהודעה.
data

string

אופציונלי: ערך קריא למחשבים שה-EMM יקריא. לדוגמה, הגדרת ערכים שהאדמין יכול לבחור בשאילתה שלהם במסוף ה-EMM (למשל, "אני רוצה לקבל תזכורת אם נתוני הסוללה < 10").
createTime

string (Timestamp format)

שעת היצירה של מצב האפליקציה במכשיר.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

מועד העדכון האחרון של מצב האפליקציה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

מידת החומרה

מידת החומרה של מצב האפליקציה.

טיפוסים בני מנייה (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 (TelephonyInfo)
    }
  ]
}
שדות
imei

string

מספר ה-IMEI של מכשיר ה-GSM. לדוגמה, A1000031212.
meid

string

מספר MEID של מכשיר ה-CDMA. לדוגמה, A00000292788E1.
wifiMacAddress

string

כתובת MAC של Wi-Fi של המכשיר. לדוגמה, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

השם האלפביתי של המפעיל הרשום הנוכחי. לדוגמה, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

מספק נתוני טלפוניה המשויכים לכל כרטיס SIM במכשיר. התכונה נתמכת רק במכשירים מנוהלים החל מרמת API של Android 23.

TelephonyInfo

נתוני טלפוניה המשויכים לכרטיס SIM נתון במכשיר. התכונה נתמכת רק במכשירים מנוהלים החל מרמת API של Android 23.

ייצוג JSON 
{
  "phoneNumber": string,
  "carrierName": string
}
שדות
phoneNumber

string

מספר הטלפון שמשויך לכרטיס ה-SIM הזה.
carrierName

string

שם הספק המשויך לכרטיס ה-SIM הזה.

MemoryInfo

מידע על הזיכרון והאחסון במכשיר.

ייצוג JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
שדות
totalRam

string (int64 format)

סך ה-RAM במכשיר בבייטים.
totalInternalStorage

string (int64 format)

סך כל האחסון הפנימי במכשיר בבייטים.

MemoryEvent

אירוע שקשור למדידות של הזיכרון והאחסון.

כדי להבחין בין אירועים חדשים לאירועים ישנים, מומלץ להשתמש בשדה createTime.

ייצוג JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
שדות
eventType

enum (MemoryEventType)

סוג האירוע.
createTime

string (Timestamp format)

שעת היצירה של האירוע.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

מספר הבייטים הפנויים באמצעי האחסון, או עבור EXTERNAL_STORAGE_DETECTED, הקיבולת הכוללת בבייטים של אמצעי האחסון.

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 (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
שדות
eventType

enum (PowerManagementEventType)

סוג האירוע.
createTime

string (Timestamp format)

שעת היצירה של האירוע.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
batteryLevel

number

באירועי BATTERY_LEVEL_COLLECTED, רמת הסוללה באחוזים.

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

string (Timestamp format)

השעה שבה בוצעו המדידות.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

הטמפרטורות הנוכחיות של הסוללה בצלזיוס לכל סוללה במכשיר.
cpuTemperatures[]

number

הטמפרטורות הנוכחיות של המעבד (CPU) בצלזיוס לכל מעבד (CPU) במכשיר.
gpuTemperatures[]

number

הטמפרטורות הנוכחיות של יחידת ה-GPU בצלזיוס לכל יחידת GPU במכשיר.
skinTemperatures[]

number

טמפרטורות העור הנוכחיות של המכשיר בצלזיוס.
fanSpeeds[]

number

מהירויות המאוורר בסל"ד לכל מאוורר במכשיר. המשמעות של מערך ריק היא שאין מאווררים או שמהירות המאוורר לא נתמכת במערכת.
cpuUsages[]

number

אחוז השימוש במעבד (CPU) לכל ליבה שזמינה במכשיר. השימוש הוא 0 לכל ליבה מנותקת. אם מערך ריק, השימוש במעבד (CPU) לא נתמך במערכת.

DeviceSettings

מידע על הגדרות המכשיר שקשורות לאבטחה.

ייצוג JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
שדות
isDeviceSecure

boolean

האם המכשיר מאובטח באמצעות קוד אימות/סיסמה.
unknownSourcesEnabled

boolean

האפשרות להתקין אפליקציות ממקורות לא מוכרים מופעלת.
developmentSettingsEnabled

boolean

האם מצב פיתוח מופעל במכשיר.
adbEnabled

boolean

האם ADB מופעל במכשיר.
isEncrypted

boolean

האם הצפנת האחסון מופעלת.
encryptionStatus

enum (EncryptionStatus)

סטטוס ההצפנה מ-DevicePolicyManager.
verifyAppsEnabled

boolean

האם אימות Google Play Protect נאכף במכשיר.

EncryptionStatus

סטטוס ההצפנה של המכשיר.

טיפוסים בני מנייה (enums)
ENCRYPTION_STATUS_UNSPECIFIED לא צוין. אף מכשיר לא אמור להיות מהסוג הזה.
UNSUPPORTED ההצפנה אינה נתמכת על ידי המכשיר.
INACTIVE ההצפנה נתמכת על ידי המכשיר, אבל אינה פעילה כרגע.
ACTIVATING ההצפנה לא פעילה כרגע, אבל היא מופעלת כרגע.
ACTIVE ההצפנה פעילה.
ACTIVE_DEFAULT_KEY ההצפנה פעילה, אבל המשתמש לא הגדיר מפתח הצפנה.
ACTIVE_PER_USER ההצפנה פעילה ומפתח ההצפנה מקושר לפרופיל המשתמש.

SecurityPosture

מצב האבטחה של המכשיר, שנקבע לפי מצב המכשיר הנוכחי והמדיניות שהוחלה.

ייצוג JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
שדות
devicePosture

enum (DevicePosture)

הערך של מצב האבטחה במכשיר.
postureDetails[]

object (PostureDetail)

פרטים נוספים על מצב האבטחה של המכשיר.

DevicePosture

ערכים אפשריים של מצב אבטחה במכשיר שנמצא בניהול.

טיפוסים בני מנייה (enums)
POSTURE_UNSPECIFIED לא צוין. אין פרטי מצבה עבור ערך המצב הזה.
SECURE המכשיר הזה מאובטח.
AT_RISK המכשיר הזה עשוי להיות חשוף יותר לגורמים זדוניים יותר מהמומלץ לשימוש עם נתונים ארגוניים.
POTENTIALLY_COMPROMISED ייתכן שהמכשיר הזה נפרץ ונתונים ארגוניים עשויים להיות נגישים לגורמים לא מורשים.

PostureDetail

פרטים נוספים על מצב האבטחה של המכשיר.

ייצוג JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
שדות
securityRisk

enum (SecurityRisk)

סיכון אבטחה ספציפי שמשפיע לרעה על מצב האבטחה של המכשיר.
advice[]

object (UserFacingMessage)

עצות רלוונטיות ממנהלי מערכת לצמצום סיכון האבטחה הזה ולשיפור מצב האבטחה של המכשיר.

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)
}
שדות
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

string

פלט בלבד. אם המכשיר הזה הועבר מבקר DPC אחר, זהו שם החבילה שלו. אחרת, לא אוכלסו.
additionalData

string

פלט בלבד. אם המכשיר הזה הועבר מבקר DPC אחר, השדה additionalData של אסימון ההעברה יאוכלס כאן.

שיטות

delete

 מחיקת מכשיר.

get

 מקבל מכשיר.

issueCommand

 שולחים פקודה למכשיר.

list

 רשימה של מכשירים של ארגון נתון.

patch

 מתבצע עדכון של מכשיר.