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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 של משתמש המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. אפשר לציין רק את 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 – תקני אבטחה שמוגדרים ב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)
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 ברמה הבסיסית (root) או שם הדומיין. 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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 שמשויך לחבילת המערכת, שאפשר להשתמש בו כדי לוודא שה-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).

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 לא עדכנית.
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

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

cpuShutdownTemperatures[]

number

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

cpuThrottlingTemperatures[]

number

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

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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 האפליקציה הותקנה מחוץ לחנות Google Play ממקור לא ידוע.
SYSTEM_APP_FACTORY_VERSION זוהי אפליקציית מערכת מתמונת המפעל של המכשיר.
SYSTEM_APP_UPDATED_VERSION זוהי אפליקציית מערכת מעודכנת.
INSTALLED_FROM_PLAY_STORE האפליקציה הותקנה מחנות Google Play.

ApplicationState

סטטוס ההתקנה הנוכחי.

טיפוסים בני מנייה (enum)
APPLICATION_STATE_UNSPECIFIED מצב האפליקציה לא צוין
REMOVED האפליקציה הוסרה מהמכשיר
INSTALLED האפליקציה מותקנת במכשיר

KeyedAppState

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

ייצוג ב-JSON
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
שדות
key

string

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

severity

enum (Severity)

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

message

string

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

data

string

אפשר גם לציין ערך שקריא למכונה, שייכתב על ידי ה-EMM. לדוגמה, הגדרת ערכים שהאדמין יכול לבחור להריץ נגדם שאילתה במסוף ה-EMM (למשל, 'notify me if the battery_warning data < 10').

createTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 במכשיר. התכונה נתמכת רק במכשירים מנוהלים באופן מלא, החל מרמת API‏ 23 של Android.

TelephonyInfo

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

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

string

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

carrierName

string

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

iccId

string

פלט בלבד. מספר ה-ICCID שמשויך לכרטיס ה-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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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

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

cpuUsages[]

number

שימוש ב-CPU באחוזים לכל ליבה שזמינה במכשיר. הערך של Usage הוא 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 עוברות, אבל הבדיקה 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

עדכון מכשיר.