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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 ซึ่งเป็นมาตรฐานความปลอดภัยที่ระบุไว้ในเกณฑ์ร่วมกันสำหรับการประเมินความปลอดภัยด้านเทคโนโลยีสารสนเทศ (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

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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 เป็นเวอร์ชันที่ล้าสมัย
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
}
ช่อง
brand

string

แบรนด์ของอุปกรณ์ เช่น Google
hardware

string

ชื่อของฮาร์ดแวร์ เช่น Angler
deviceBasebandVersion

string

เวอร์ชันเบสแบนด์ เช่น MDM9625_104662.22.05.34p
manufacturer

string

ผู้ผลิต เช่น Motorola
serialNumber

string

หมายเลขซีเรียลของอุปกรณ์
model

string

รุ่นของอุปกรณ์ เช่น Asus Nexus 7
batteryShutdownTemperatures[]

number

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

number

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

number

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

number

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

number

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

number

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

number

เกณฑ์อุณหภูมิที่อุปกรณ์จะปิดในหน่วยเซลเซียส
skinThrottlingTemperatures[]

number

เกณฑ์อุณหภูมิที่จำกัดการทํางานของอุปกรณ์ในหน่วยเซลเซียส
enterpriseSpecificId

string

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

ดิสเพลย์

ข้อมูลการแสดงผลของอุปกรณ์

การแสดง JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
ช่อง
name

string

ชื่อจอแสดงผล
displayId

integer

รหัสการแสดงผลที่ไม่ซ้ำกัน
refreshRate

integer

อัตราการรีเฟรชของจอแสดงผลเป็นเฟรมต่อวินาที
state

enum (DisplayState)

สถานะของจอแสดงผล
width

integer

ความกว้างของการแสดงผลเป็นพิกเซล
height

integer

ความสูงของการแสดงผลเป็นพิกเซล
density

integer

ความหนาแน่นของการแสดงผลที่แสดงเป็นจุดต่อนิ้ว

DisplayState

สถานะของจอแสดงผล

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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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
}
ช่อง
phoneNumber

string

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

string

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

string

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

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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 ซึ่งเป็นมาตรฐานความปลอดภัยที่ระบุไว้ในเกณฑ์ร่วมกันสำหรับการประเมินความปลอดภัยด้านเทคโนโลยีสารสนเทศ (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

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