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)

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

enum (DeviceState)

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

enum (DeviceState)

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

boolean

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

object (NonComplianceDetail)

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

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

הוצא משימוש.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
policyName

string

שם המדיניות שחלה על המכשיר, בתבנית enterprises/{enterpriseId}/policies/{policyId}. אם לא מציינים את המדיניות, חלה מדיניות policyName של המשתמש במכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. כשמתקשרים אל enterprises.devices.patch, אפשר לציין רק את policyId, בתנאי ש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 – תקני אבטחה שמוגדרים בCommon Criteria for Information Technology Security 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 הגדרת ה-Wi-Fi של ONC לא נתמכת ברמת ה-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.
PERMISSIBLE_USAGE_RESTRICTION הגדרת המדיניות הזו מוגבלת ואי אפשר להגדיר אותה עבור הפרויקט הזה ב-Google Cloud Platform. פרטים נוספים (כולל הוראות להפעלת הגדרת המדיניות הזו) זמינים במדיניות השימוש המותר. הערך של nonComplianceReason הוא PROJECT_NOT_PERMITTED.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE החשבון לצורכי עבודה שנדרש בהגדרת המדיניות של workAccountSetupConfig כבר לא שייך לארגון. הערך של nonComplianceReason הוא USER_ACTION.
NEW_ACCOUNT_NOT_IN_ENTERPRISE החשבון לצורכי עבודה שהמשתמש הוסיף לא שייך לארגון. הערך של nonComplianceReason הוא USER_ACTION.

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)

משך זמן של תהליך build.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

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

string

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

string

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

object (SystemUpdateInfo)

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

SystemUpdateInfo

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

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

enum (UpdateStatus)

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

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

UpdateStatus

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

טיפוסים בני מנייה (enum)
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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
שדות
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) במעלות צלזיוס לכל מעבד במכשיר.
cpuThrottlingTemperatures[]

number

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

number

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

number

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

number

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

number

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

string

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

object (EuiccChipInfo)

פלט בלבד. מידע שקשור לצ'יפ eUICC.

EuiccChipInfo

מידע שקשור לצ'יפ eUICC.

ייצוג ב-JSON 
{
  "eid": string
}
שדות
eid

string

פלט בלבד. מסמך הזהות המוטמע (EID) שמזהה את שבב ה-eUICC עבור כל שבב eUICC במכשיר. התכונה הזו זמינה במכשירים בבעלות החברה עם Android מגרסה 13 ואילך.

רשת המדיה

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

ייצוג ב-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 המסך במצב שינה עמוקה (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 של האפליקציה, שאפשר להשתמש בו כדי לוודא שהאפליקציה לא שונתה. כל בית (byte) של ערך הגיבוב מיוצג כמספר הקסדצימלי בן שתי ספרות.
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)

השעה שבה האירוע נוצר.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

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 (למשל, 'התראה אם הנתונים של battery_warning < 10').
createTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

מידת החומרה

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

טיפוסים בני מנייה (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 במכשיר. התמיכה קיימת רק במכשירים בניהול מלא החל מרמת Android API‏ 23.

TelephonyInfo

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

ייצוג ב-JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
שדות
phoneNumber

string

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

string

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

string

פלט בלבד. מספר ה-ICCID שמשויך לכרטיס ה-SIM הזה.
activationState

enum (ActivationState)

פלט בלבד. מצב ההפעלה של כרטיס ה-SIM במכשיר. ההגדרה הזו רלוונטית רק לכרטיסי eSIM. התכונה הזו נתמכת בכל המכשירים ברמת API‏ 35 ומעלה. הערך הזה הוא תמיד ACTIVATION_STATE_UNSPECIFIED עבור כרטיסי SIM פיזיים ועבור מכשירים מתחת לרמת API‏ 35.
configMode

enum (ConfigMode)

פלט בלבד. מצב ההגדרה של כרטיס ה-SIM במכשיר. ההגדרה הזו רלוונטית רק לכרטיסי eSIM. התכונה הזו נתמכת בכל המכשירים ברמת API‏ 35 ומעלה. הערך הזה הוא תמיד CONFIG_MODE_UNSPECIFIED עבור כרטיסי SIM פיזיים ועבור מכשירים מתחת לרמת API‏ 35.

ActivationState

מצב ההפעלה של כרטיס ה-SIM במכשיר.

טיפוסים בני מנייה (enum)
ACTIVATION_STATE_UNSPECIFIED לא צוין מצב הפעלה.
ACTIVATED כרטיס ה-SIM מופעל.
NOT_ACTIVATED כרטיס ה-SIM לא הופעל.

ConfigMode

מצב ההגדרה של כרטיס ה-SIM במכשיר.

טיפוסים בני מנייה (enum)
CONFIG_MODE_UNSPECIFIED מצב ההגדרה לא מוגדר.
ADMIN_CONFIGURED האדמין הגדיר את כרטיס ה-SIM הזה.
USER_CONFIGURED המשתמש הגדיר את כרטיס ה-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)

השעה שבה האירוע נוצר.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

השעה שבה האירוע נוצר.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

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

number

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

number

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

number

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

number

מהירויות המאווררים בסיבובים לדקה (RPM) לכל מאוורר במכשיר. מערך ריק מציין שאין מאווררים או שהמערכת לא תומכת במהירות המאוורר.
cpuUsages[]

number

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

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 מזהה שבמכשיר פועלת מערכת הפעלה לא ידועה (הבדיקה basicIntegrity מצליחה אבל הבדיקה ctsProfileMatch נכשלת).
COMPROMISED_OS ‫Play Integrity API מזהה שבמכשיר פועלת מערכת הפעלה שנפרצה (הבדיקה basicIntegrity נכשלת).
HARDWARE_BACKED_EVALUATION_FAILED אם התווית MEETS_STRONG_INTEGRITY לא מופיעה בשדה תקינות המכשיר, המשמעות היא ש-Play Integrity API זיהה שלמכשיר אין ערובה חזקה לתקינות המערכת.

CommonCriteriaModeInfo

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

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

ייצוג ב-JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
שדות
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

האם מצב Common Criteria מופעל.
policySignatureVerificationStatus

enum (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 לא צוין. סטטוס האימות לא דווח. השדה הזה מוגדר רק אם הערך של statusReportingSettings.commonCriteriaModeEnabled הוא False.
POLICY_SIGNATURE_VERIFICATION_DISABLED האימות של חתימת המדיניות מושבת במכשיר כי הערך של commonCriteriaMode מוגדר כ-false.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED האימות של חתימת המדיניות בוצע בהצלחה.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED לא מתבצע אימות של חתימת המדיניות, למשל כי המכשיר נרשם לגרסה של CloudDPC שלא תומכת באימות של חתימת המדיניות.
POLICY_SIGNATURE_VERIFICATION_FAILED אימות החתימה של המדיניות נכשל. המדיניות לא הוחלה.

DpcMigrationInfo

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

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

string

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

string

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

Methods

delete

 מחיקת מכשיר.

get

 מקבל מכשיר.

issueCommand

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

list

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

patch

 עדכון של מכשיר.