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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

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

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

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

הוצא משימוש.

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

lastPolicySyncTime

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 מוגדרת כ-True במדיניות המכשיר.

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 for Information Technology Evaluation (הערכה של אבטחת מידע טכנולוגיים) (CC).

המידע הזה זמין רק אם לפי המדיניות של המכשיר statusReportingSettings.commonCriteriaModeEnabled הוא true הוא מכשיר בבעלות החברה.

appliedPasswordPolicies[]

object (PasswordRequirements)

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

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

object (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 (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

סיבות אפשריות לכישלון של התקנת אפליקציה.

טיפוסים בני מנייה (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

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

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

SpecificNonComplianceReason

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

טיפוסים בני מנייה (enum)
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 של הארגון חסרים ה-CA ברמה הבסיסית או שם הדומיין. הערך של 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

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

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)

זמן היצירה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

UpdateStatus

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

טיפוסים בני מנייה (enum)
UPDATE_STATUS_UNKNOWN לא ידוע אם יש עדכון מערכת בהמתנה. זה קורה כאשר, למשל, רמת ה-API של המכשיר נמוכה מ-26, או אם הגרסה של Android Device Policy מיושנת.
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

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

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

cpuShutdownTemperatures[]

number

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

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

מצב המסך.

טיפוסים בני מנייה (enum)
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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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 (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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

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

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

מידת החומרה

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

טיפוסים בני מנייה (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 (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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

byteCount

string (int64 format)

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

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

enum (PowerManagementEventType)

סוג האירוע.

createTime

string (Timestamp format)

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

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

batteryLevel

number

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

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

טיפוסים בני מנייה (enum)
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

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

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

PostureDetail

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

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

enum (SecurityRisk)

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

advice[]

object (UserFacingMessage)

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

SecurityRisk

הסיכון לכך שהמכשיר לא יהיה במצב המאובטח ביותר.

טיפוסים בני מנייה (enum)
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 for Information Technology Evaluation (הערכה של אבטחת מידע טכנולוגיים) (CC).

המידע הזה זמין רק אם הערך של statusReportingSettings.commonCriteriaModeEnabled הוא true במדיניות של המכשיר.

ייצוג JSON
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
שדות
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

האם מצב Common criterion (קריטריונים משותפים) מופעל.

CommonCriteriaModeStatus

האם מצב Common criterion (קריטריונים משותפים) מופעל.

טיפוסים בני מנייה (enum)
COMMON_CRITERIA_MODE_STATUS_UNKNOWN סטטוס לא ידוע.
COMMON_CRITERIA_MODE_DISABLED מצב 'קריטריונים משותפים' מושבת כרגע.
COMMON_CRITERIA_MODE_ENABLED מצב 'קריטריונים משותפים' מופעל כרגע.

DpcMigrationInfo

מידע שמציין אם המכשיר הזה הועבר מניהול של בקר מדיניות מכשירים (DPC) אחר.

ייצוג JSON
{
  "previousDpc": string,
  "additionalData": string
}
שדות
previousDpc

string

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

additionalData

string

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

שיטות

delete

מחיקת מכשיר.

get

מקבל מכשיר.

issueCommand

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

list

בתיבת הדו-שיח הזו מפורטים מכשירים של ארגון נתון.

patch

עדכון מכשיר.