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)

เวลาที่ลงทะเบียนอุปกรณ์

ใช้ 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 สำหรับผู้ใช้อุปกรณ์ โดยแก้ไขฟิลด์นี้ได้ด้วยคำขอแพตช์ คุณระบุได้เฉพาะ 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 เป็น "จริง" ในนโยบายของอุปกรณ์
hardwareInfo

object (HardwareInfo)

ข้อมูลโดยละเอียดเกี่ยวกับฮาร์ดแวร์ของอุปกรณ์
displays[]

object (Display)

ข้อมูลโดยละเอียดเกี่ยวกับจอแสดงผลในอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ displayInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
applicationReports[]

object (ApplicationReport)

รายงานสำหรับแอปที่ติดตั้งในอุปกรณ์ ข้อมูลนี้จะใช้ได้เมื่อ applicationReportsEnabled เป็น "จริง" ในนโยบายของอุปกรณ์เท่านั้น
previousDeviceNames[]

string

หากมีการลงทะเบียนอุปกรณ์จริงเครื่องเดียวกันหลายครั้ง ฟิลด์นี้จะมีชื่ออุปกรณ์ก่อนหน้า ระบบจะใช้หมายเลขซีเรียลเป็นตัวระบุที่ไม่ซ้ำกันเพื่อพิจารณาว่าอุปกรณ์จริงเครื่องเดียวกันนี้เคยลงทะเบียนไว้ก่อนหน้านี้หรือไม่ โดยชื่อจะเรียงตามลำดับเวลา
networkInfo

object (NetworkInfo)

ข้อมูลเครือข่ายของอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ networkInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
memoryInfo

object (MemoryInfo)

ข้อมูลหน่วยความจำ: มีข้อมูลเกี่ยวกับหน่วยความจำและพื้นที่เก็บข้อมูลของอุปกรณ์
memoryEvents[]

object (MemoryEvent)

เหตุการณ์ที่เกี่ยวข้องกับการวัดหน่วยความจำและพื้นที่เก็บข้อมูลตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ memoryInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์

ระบบจะเก็บกิจกรรมไว้เป็นระยะเวลาหนึ่งและลบกิจกรรมเก่าออก
powerManagementEvents[]

object (PowerManagementEvent)

เหตุการณ์การจัดการพลังงานในอุปกรณ์ตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ powerManagementEventsEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
hardwareStatusSamples[]

object (HardwareStatus)

ตัวอย่างสถานะของฮาร์ดแวร์ตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ hardwareStatusEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
deviceSettings

object (DeviceSettings)

ข้อมูลการตั้งค่าอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ deviceSettingsEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
user

object (User)

ผู้ใช้ที่เป็นเจ้าของอุปกรณ์
systemProperties

map (key: string, value: string)

แผนที่ของชื่อและค่าพร็อพเพอร์ตี้ของระบบที่เลือกซึ่งเกี่ยวข้องกับอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ systemPropertiesEnabled เป็น "จริง" ในนโยบายของอุปกรณ์

ออบเจ็กต์ที่มีรายการคู่ "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 ในแอปพลิเคชันที่ 3 เส้นทางจะเป็น 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 องค์กรไม่ได้ลงทะเบียนกับ Managed Google Play อีกต่อไป หรือผู้ดูแลระบบยังไม่ได้ยอมรับข้อกำหนดในการให้บริการล่าสุดของ Managed 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

รหัสเวอร์ชันของแอป Android Device Policy
androidDevicePolicyVersionName

string

เวอร์ชันของแอป Android Device Policy ที่แสดงต่อผู้ใช้
androidBuildNumber

string

สตริงรหัสบิลด์ของ Android ที่มีไว้สำหรับแสดงต่อผู้ใช้ เช่น shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys
deviceKernelVersion

string

เวอร์ชันเคอร์เนล เช่น 2.6.32.9-g103d848
bootloaderVersion

string

หมายเลขเวอร์ชันของ Bootloader ของระบบ เช่น 0.6.7
androidBuildTime

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"
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)

เวลาที่การอัปเดตพร้อมใช้งานเป็นครั้งแรก ค่า 0 แสดงว่าไม่ได้ตั้งค่าช่องนี้ ช่องนี้จะตั้งค่าก็ต่อเมื่อมีการอัปเดต (กล่าวคือ 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 มีการอัปเดตระบบปฏิบัติการที่รอดำเนินการพร้อมใช้งาน

HardwareInfo

ข้อมูลเกี่ยวกับฮาร์ดแวร์ของอุปกรณ์ ฟิลด์ที่เกี่ยวข้องกับเกณฑ์อุณหภูมิจะใช้ได้ก็ต่อเมื่อ hardwareStatusEnabled เป็น "จริง" ในนโยบายของอุปกรณ์

การแสดง 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 เป็นองศาเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
cpuThrottlingTemperatures[]

number

เกณฑ์อุณหภูมิการควบคุม CPU เป็นองศาเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
gpuShutdownTemperatures[]

number

เกณฑ์อุณหภูมิการปิด GPU เป็นองศาเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
gpuThrottlingTemperatures[]

number

เกณฑ์อุณหภูมิการควบคุม GPU ในหน่วยเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
skinShutdownTemperatures[]

number

เกณฑ์อุณหภูมิการปิดเครื่องของผิวหนังอุปกรณ์เป็นหน่วยเซลเซียส
skinThrottlingTemperatures[]

number

เกณฑ์อุณหภูมิการควบคุมความร้อนของผิวหนังของอุปกรณ์ในหน่วยเซลเซียส
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 จอแสดงผลอยู่ในโหมดพักในสถานะพลังงานต่ำ
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 ของแอป ซึ่งใช้เพื่อยืนยันว่าแอปไม่ได้รับการแก้ไข แต่ละไบต์ของค่าแฮชจะแสดงเป็นตัวเลขฐาน 16 2 หลัก
signingKeyCertFingerprints[]

string

แฮช SHA-1 ของ android.content.pm.Signature แต่ละรายการที่เชื่อมโยงกับแพ็กเกจแอป แต่ละไบต์ของค่าแฮชแต่ละค่าจะแสดงเป็นตัวเลขฐาน 16 2 หลัก
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 Store

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)

ให้ข้อมูลการโทรที่เชื่อมโยงกับซิมการ์ดแต่ละอันในอุปกรณ์ รองรับเฉพาะในอุปกรณ์ที่มีการจัดการเต็มรูปแบบตั้งแต่ Android API ระดับ 23 ขึ้นไป

TelephonyInfo

ข้อมูลโทรศัพท์ที่เชื่อมโยงกับซิมการ์ดที่ระบุในอุปกรณ์ รองรับเฉพาะในอุปกรณ์ที่มีการจัดการเต็มรูปแบบตั้งแต่ Android API ระดับ 23 ขึ้นไป

การแสดง JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
ช่อง
phoneNumber

string

หมายเลขโทรศัพท์ที่เชื่อมโยงกับซิมการ์ดนี้
carrierName

string

ชื่อผู้ให้บริการที่เชื่อมโยงกับซิมการ์ดนี้
iccId

string

เอาต์พุตเท่านั้น ICCID ที่เชื่อมโยงกับซิมการ์ดนี้
activationState

enum (ActivationState)

เอาต์พุตเท่านั้น สถานะการเปิดใช้งานซิมการ์ดในอุปกรณ์ โดยจะใช้ได้กับ eSIM เท่านั้น ฟีเจอร์นี้ใช้ได้ในอุปกรณ์ทั้งหมดสำหรับ API ระดับ 35 ขึ้นไป ซึ่งจะเป็น ACTIVATION_STATE_UNSPECIFIED เสมอสำหรับซิมจริงและสำหรับอุปกรณ์ที่ต่ำกว่า API ระดับ 35
configMode

enum (ConfigMode)

เอาต์พุตเท่านั้น โหมดการกำหนดค่าของซิมการ์ดในอุปกรณ์ โดยจะใช้ได้กับ eSIM เท่านั้น ฟีเจอร์นี้ใช้ได้ในอุปกรณ์ทั้งหมดสำหรับ API ระดับ 35 ขึ้นไป ซึ่งจะเป็น CONFIG_MODE_UNSPECIFIED เสมอสำหรับซิมจริงและสำหรับอุปกรณ์ที่ต่ำกว่า API ระดับ 35

ActivationState

สถานะการเปิดใช้งานซิมการ์ดในอุปกรณ์

Enum
ACTIVATION_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการเปิดใช้งาน
ACTIVATED เปิดใช้งานซิมการ์ดแล้ว
NOT_ACTIVATED ไม่ได้เปิดใช้งานซิมการ์ด

ConfigMode

โหมดการกำหนดค่าของซิมการ์ดในอุปกรณ์

Enum
CONFIG_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการกำหนดค่า
ADMIN_CONFIGURED ผู้ดูแลระบบได้กำหนดค่าซิมนี้แล้ว
USER_CONFIGURED ผู้ใช้ได้กำหนดค่าซิมนี้แล้ว

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 นำสื่อจัดเก็บข้อมูลภายนอกออกแล้ว จำนวนไบต์ที่รายงานเป็น 0
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 ในหน่วยเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
gpuTemperatures[]

number

อุณหภูมิ GPU ปัจจุบันในหน่วยเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
skinTemperatures[]

number

อุณหภูมิผิวหนังปัจจุบันของอุปกรณ์ในหน่วยเซลเซียส
fanSpeeds[]

number

ความเร็วพัดลมในหน่วย RPM สำหรับพัดลมแต่ละตัวในอุปกรณ์ อาร์เรย์ว่างหมายความว่าไม่มีพัดลมหรือระบบไม่รองรับความเร็วพัดลม
cpuUsages[]

number

การใช้งาน CPU เป็นเปอร์เซ็นต์สำหรับแต่ละแกนที่พร้อมใช้งานในอุปกรณ์ การใช้งานจะเป็น 0 สำหรับแต่ละคอร์ที่ไม่ได้เสียบปลั๊ก อาร์เรย์ว่างหมายความว่าระบบไม่รองรับการใช้งาน CPU

DeviceSettings

ข้อมูลเกี่ยวกับการตั้งค่าอุปกรณ์ที่เกี่ยวข้องกับความปลอดภัยในอุปกรณ์

การแสดง JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
ช่อง
isDeviceSecure

boolean

อุปกรณ์รักษาความปลอดภัยด้วย PIN/รหัสผ่านหรือไม่
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 Play Integrity API จะตรวจพบว่าอุปกรณ์ไม่มีการรับประกันความสมบูรณ์ของระบบที่แข็งแกร่ง หากป้ายกำกับ MEETS_STRONG_INTEGRITY ไม่แสดงในช่องความสมบูรณ์ของอุปกรณ์

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 เป็น "เท็จ" เท่านั้น
POLICY_SIGNATURE_VERIFICATION_DISABLED ระบบปิดใช้การยืนยันลายเซ็นของนโยบายในอุปกรณ์เนื่องจากตั้งค่า commonCriteriaMode เป็น "เท็จ"
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 ของโทเค็นการย้ายข้อมูลที่นี่

เมธอด

delete

 ลบอุปกรณ์

get

 รับอุปกรณ์

issueCommand

 ออกคำสั่งไปยังอุปกรณ์

list

 แสดงรายการอุปกรณ์สำหรับองค์กรที่ระบุ

patch

 อัปเดตอุปกรณ์