REST Resource: enterprises.devices

ทรัพยากร: อุปกรณ์

อุปกรณ์ขององค์กร ช่องทั้งหมดเป็นแบบอ่านอย่างเดียวและ enterprises.devices.patch จะแก้ไขไม่ได้ เว้นแต่จะระบุไว้เป็นอย่างอื่น

การแสดง JSON 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
ช่อง
name

string

ชื่อของอุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/devices/{deviceId}
userName

string

ชื่อทรัพยากรของผู้ใช้ที่เป็นเจ้าของอุปกรณ์นี้ในรูปแบบ enterprises/{enterpriseId}/users/{userId}
managementMode

enum (ManagementMode)

ประเภทของโหมดการจัดการที่ Android Device Policy ใช้ในอุปกรณ์ ซึ่งจะส่งผลต่อการตั้งค่านโยบายที่ระบบรองรับ
state

enum (DeviceState)

สถานะที่จะนำไปใช้กับอุปกรณ์ แก้ไขช่องนี้ได้โดยคำขอแพตช์ โปรดทราบว่าเมื่อเรียก enterprises.devices.patch, ACTIVE และ DISABLED จะเป็นค่าที่อนุญาตเพียงค่าเดียว หากต้องการป้อนอุปกรณ์ในสถานะDELETED โปรดโทรหา enterprises.devices.delete
appliedState

enum (DeviceState)

สถานะที่ใช้กับอุปกรณ์ในขณะนี้
policyCompliant

boolean

อุปกรณ์เป็นไปตามนโยบายหรือไม่
nonComplianceDetails[]

object (NonComplianceDetail)

รายละเอียดเกี่ยวกับการตั้งค่านโยบายที่อุปกรณ์ไม่เป็นไปตามข้อกำหนด
enrollmentTime

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
lastStatusReportTime

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

เลิกใช้งานแล้ว

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
lastPolicySyncTime

string (Timestamp format)

เวลาล่าสุดที่อุปกรณ์ดึงข้อมูลนโยบาย

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
policyName

string

ชื่อของนโยบายที่ใช้กับอุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/policies/{policyId} หากไม่ได้ระบุไว้ ระบบจะใช้ policyName สำหรับผู้ใช้อุปกรณ์ แก้ไขช่องนี้ได้โดยคำขอแพตช์ คุณระบุได้เฉพาะ policyId เมื่อเรียกใช้ enterprises.devices.patch ตราบใดที่ policyId ไม่มีเครื่องหมายทับ ชื่อนโยบายส่วนที่เหลือจะอนุมาน
appliedPolicyName

string

ชื่อของนโยบายที่ใช้กับอุปกรณ์ในปัจจุบัน
appliedPolicyVersion

string (int64 format)

เวอร์ชันของนโยบายที่ใช้กับอุปกรณ์ในปัจจุบัน
apiLevel

integer

ระดับ API ของเวอร์ชันแพลตฟอร์ม Android ที่ทำงานในอุปกรณ์
enrollmentTokenData

string

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

string

หากลงทะเบียนอุปกรณ์ด้วยโทเค็นการลงทะเบียน ช่องนี้จะมีชื่อของโทเค็น
disabledReason

object (UserFacingMessage)

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

object (SoftwareInfo)

ข้อมูลโดยละเอียดเกี่ยวกับซอฟต์แวร์ของอุปกรณ์ ข้อมูลนี้ใช้ได้เฉพาะเมื่อ softwareInfoEnabled เป็นจริงในนโยบายของอุปกรณ์
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)

ข้อมูลเกี่ยวกับโหมดเกณฑ์ทั่วไป - มาตรฐานด้านความปลอดภัยที่กำหนดไว้ในเกณฑ์ร่วมกันสำหรับการประเมินความปลอดภัยของเทคโนโลยีสารสนเทศ (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 ระดับ API ของเวอร์ชัน Android ที่ใช้งานบนอุปกรณ์ไม่รองรับการตั้งค่า ONC Wi-Fi 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)

เวลาที่สร้าง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
securityPatchLevel

string

ระดับแพตช์ด้านความปลอดภัย เช่น 2016-05-01
primaryLanguageCode

string

รหัสภาษา IETF BCP 47 สำหรับภาษาหลักในอุปกรณ์
deviceBuildSignature

string

แฮช SHA-256 ของ android.content.pm.Signature ที่เชื่อมโยงกับแพ็กเกจระบบ ซึ่งสามารถใช้เพื่อยืนยันว่าไม่มีการแก้ไขบิลด์ของระบบ
systemUpdateInfo

object (SystemUpdateInfo)

ข้อมูลเกี่ยวกับการอัปเดตระบบที่รอดำเนินการ

SystemUpdateInfo

ข้อมูลเกี่ยวกับการอัปเดตระบบที่รอดำเนินการ

การแสดง JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
ช่อง
updateStatus

enum (UpdateStatus)

สถานะของการอัปเดต: มีอัปเดตหรือไม่และเป็นประเภทการอัปเดตหรือไม่
updateReceivedTime

string (Timestamp format)

เวลาที่การอัปเดตพร้อมใช้งานครั้งแรก ค่าศูนย์หมายความว่าไม่มีการตั้งค่าช่องนี้ ช่องนี้จะตั้งค่าเฉพาะในกรณีที่มีการอัปเดต (กล่าวคือ updateStatus ไม่ใช่ทั้ง UPDATE_STATUS_UNKNOWN หรือ UP_TO_DATE)

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

UpdateStatus

สถานะของการอัปเดต: มีอัปเดตหรือไม่และเป็นประเภทการอัปเดตหรือไม่

Enum
UPDATE_STATUS_UNKNOWN ไม่ทราบว่ามีการอัปเดตระบบที่รอดำเนินการหรือไม่ เช่น เมื่อระดับ API ของอุปกรณ์ต่ำกว่า 26 หรือเมื่อเวอร์ชัน Android Device Policy ล้าสมัย เป็นต้น
UP_TO_DATE ไม่มีการอัปเดตระบบที่รอดำเนินการในอุปกรณ์
UNKNOWN_UPDATE_AVAILABLE มีการอัปเดตระบบที่รอดำเนินการพร้อมใช้งาน แต่ยังไม่ทราบประเภท
SECURITY_UPDATE_AVAILABLE มีการอัปเดตความปลอดภัยที่รอดำเนินการ
OS_UPDATE_AVAILABLE มีอัปเดตระบบปฏิบัติการที่รอดำเนินการ

HardwareInfo

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

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

string

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

เวลาที่สร้างกิจกรรม

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ApplicationEventType

ประเภทของเหตุการณ์ที่เกี่ยวข้องกับแอป

Enum
APPLICATION_EVENT_TYPE_UNSPECIFIED ค่านี้ไม่ได้รับอนุญาต
INSTALLED ติดตั้งแอปแล้ว
CHANGED แอปมีการเปลี่ยนแปลง เช่น มีการเปิดหรือปิดใช้คอมโพเนนต์
DATA_CLEARED ล้างข้อมูลแอปแล้ว
REMOVED แอปถูกนำออกไปแล้ว
REPLACED ติดตั้งแอปเวอร์ชันใหม่แล้วแทนที่เวอร์ชันเก่า
RESTARTED รีสตาร์ทแอปแล้ว
PINNED ปักหมุดแอปไว้ที่เบื้องหน้าแล้ว
UNPINNED เลิกปักหมุดแอปแล้ว

ApplicationSource

แหล่งที่มาที่ให้บริการแอป

Enum
APPLICATION_SOURCE_UNSPECIFIED แอปไซด์โหลดมาจากแหล่งที่มาที่ไม่ระบุ
SYSTEM_APP_FACTORY_VERSION ซึ่งเป็นแอประบบจากอิมเมจเริ่มต้นของอุปกรณ์
SYSTEM_APP_UPDATED_VERSION นี่เป็นแอประบบที่อัปเดตแล้ว
INSTALLED_FROM_PLAY_STORE โดยแอปติดตั้งจาก Google Play 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 (เช่น "แจ้งฉันหากข้อมูลคำว่า "bat_warning < 10")
createTime

string (Timestamp format)

เวลาที่สร้างสถานะแอปในอุปกรณ์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

เวลาที่อัปเดตสถานะแอปครั้งล่าสุด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ความรุนแรง

ความรุนแรงของสถานะแอป

Enum
SEVERITY_UNSPECIFIED ระดับความรุนแรงที่ไม่ได้ระบุ
INFO ระดับความรุนแรงของข้อมูล
ERROR ระดับความรุนแรงของข้อผิดพลาด ควรตั้งค่าเฉพาะเงื่อนไขข้อผิดพลาดที่แท้จริงซึ่งองค์กรที่มีการจัดการต้องดำเนินการแก้ไขเท่านั้น

UserFacingType

แอปแสดงต่อผู้ใช้หรือไม่

Enum
USER_FACING_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทที่แสดงต่อผู้ใช้แอป
NOT_USER_FACING แอปไม่แสดงต่อผู้ใช้
USER_FACING แอปแสดงต่อผู้ใช้

NetworkInfo

ข้อมูลเครือข่ายของอุปกรณ์

การแสดง JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
ช่อง
imei

string

หมายเลข IMEI ของอุปกรณ์ GSM เช่น A1000031212
meid

string

หมายเลข MEID ของอุปกรณ์ CDMA เช่น A00000292788E1
wifiMacAddress

string

ที่อยู่ MAC ของ Wi-Fi ของอุปกรณ์ เช่น 7c:11:11:11:11:11
networkOperatorName
(deprecated)

string

ชื่อตัวอักษรของโอเปอเรเตอร์ที่ลงทะเบียนปัจจุบัน เช่น Vodafone
telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

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

การแสดง JSON 
{
  "phoneNumber": string,
  "carrierName": string
}
ช่อง
phoneNumber

string

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

string

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

MemoryInfo

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

การแสดง JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
ช่อง
totalRam

string (int64 format)

RAM ทั้งหมดในอุปกรณ์ในหน่วยไบต์
totalInternalStorage

string (int64 format)

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

MemoryEvent

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

หากต้องการแยกความแตกต่างระหว่างกิจกรรมใหม่กับกิจกรรมเก่า เราขอแนะนำให้ใช้ช่อง createTime

การแสดง JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
ช่อง
eventType

enum (MemoryEventType)

ประเภทของกิจกรรม
createTime

string (Timestamp format)

เวลาที่สร้างกิจกรรม

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
byteCount

string (int64 format)

จำนวนไบต์ฟรีในสื่อ หรือสำหรับ EXTERNAL_STORAGE_DETECTED คือความจุรวมเป็นไบต์ของสื่อจัดเก็บข้อมูล

MemoryEventType

ประเภทของเหตุการณ์

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED ไม่ระบุ ไม่มีเหตุการณ์ประเภทนี้
RAM_MEASURED วัดพื้นที่ว่างใน RAM แล้ว
INTERNAL_STORAGE_MEASURED วัดพื้นที่ว่างในที่จัดเก็บข้อมูลภายในแล้ว
EXTERNAL_STORAGE_DETECTED ตรวจพบสื่อการเก็บข้อมูลภายนอกรายการใหม่ จำนวนไบต์ที่รายงานคือความจุรวมของสื่อการเก็บข้อมูล
EXTERNAL_STORAGE_REMOVED มีการนำสื่อพื้นที่เก็บข้อมูลภายนอกออก จำนวนไบต์ที่รายงานเป็น 0
EXTERNAL_STORAGE_MEASURED วัดพื้นที่ว่างในสื่อพื้นที่เก็บข้อมูลภายนอกแล้ว

PowerManagementEvent

เหตุการณ์การจัดการพลังงาน

การแสดง JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
ช่อง
eventType

enum (PowerManagementEventType)

ประเภทของกิจกรรม
createTime

string (Timestamp format)

เวลาที่สร้างกิจกรรม

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
batteryLevel

number

สำหรับเหตุการณ์ BATTERY_LEVEL_COLLECTED ระบบจะใช้ระดับแบตเตอรี่เป็นเปอร์เซ็นต์

PowerManagementEventType

ประเภทของเหตุการณ์

Enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED ไม่ระบุ ไม่มีเหตุการณ์ประเภทนี้
BATTERY_LEVEL_COLLECTED วัดระดับแบตเตอรี่แล้ว
POWER_CONNECTED อุปกรณ์เริ่มชาร์จแล้ว
POWER_DISCONNECTED อุปกรณ์หยุดชาร์จแล้ว
BATTERY_LOW อุปกรณ์เข้าสู่โหมดพลังงานต่ำ
BATTERY_OKAY อุปกรณ์ออกจากโหมดพลังงานต่ำแล้ว
BOOT_COMPLETED อุปกรณ์เปิดเครื่องแล้ว
SHUTDOWN อุปกรณ์ปิดการทำงาน

HardwareStatus

สถานะฮาร์ดแวร์ ระบบอาจเปรียบเทียบอุณหภูมิกับเกณฑ์อุณหภูมิที่มีอยู่ในhardwareInfo เพื่อพิจารณาประสิทธิภาพของฮาร์ดแวร์

การแสดง JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
ช่อง
createTime

string (Timestamp format)

เวลาที่วัด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
batteryTemperatures[]

number

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

number

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

number

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

number

อุณหภูมิผิวหนังของอุปกรณ์ตอนนี้เป็นเซลเซียส
fanSpeeds[]

number

ความเร็วของพัดลมเป็น 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 ตรวจพบว่าอุปกรณ์ใช้ระบบปฏิบัติการที่ถูกบุกรุก (ตรวจสอบความสมบูรณ์ขั้นพื้นฐานไม่สำเร็จ)
HARDWARE_BACKED_EVALUATION_FAILED Play Integrity API ตรวจพบว่าอุปกรณ์ไม่มีการรับประกันความสมบูรณ์ของระบบที่เข้มงวด หากป้ายกำกับ MEETS_STRONG_INTEGRITY ไม่แสดงในช่องความสมบูรณ์ของอุปกรณ์

CommonCriteriaModeInfo

ข้อมูลเกี่ยวกับโหมดเกณฑ์ทั่วไป - มาตรฐานด้านความปลอดภัยที่กำหนดไว้ในเกณฑ์ร่วมกันสำหรับการประเมินความปลอดภัยของเทคโนโลยีสารสนเทศ (CC)

ข้อมูลนี้ใช้ได้เฉพาะเมื่อ statusReportingSettings.commonCriteriaModeEnabled เป็น true ในนโยบายของอุปกรณ์

การแสดง JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
ช่อง
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

เปิดใช้โหมดเกณฑ์ทั่วไปหรือไม่

CommonCriteriaModeStatus

เปิดใช้โหมดเกณฑ์ทั่วไปหรือไม่

Enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN สถานะที่ไม่รู้จัก
COMMON_CRITERIA_MODE_DISABLED ปิดใช้โหมด Common criterion อยู่ในขณะนี้
COMMON_CRITERIA_MODE_ENABLED เปิดใช้โหมดเกณฑ์ทั่วไปอยู่ในขณะนี้

DpcMigrationInfo

ข้อมูลที่แสดงให้เห็นว่าอุปกรณ์นี้ได้รับการย้ายจากการจัดการโดยเครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) อื่นหรือไม่

การแสดง JSON 
{
  "previousDpc": string,
  "additionalData": string
}
ช่อง
previousDpc

string

เอาต์พุตเท่านั้น หากย้ายข้อมูลอุปกรณ์นี้มาจาก DPC อื่น ค่านี้จะเป็นชื่อแพ็กเกจ ไม่ได้ระบุค่าอื่น
additionalData

string

เอาต์พุตเท่านั้น หากมีการย้ายข้อมูลอุปกรณ์นี้จาก DPC อื่น ระบบจะป้อนข้อมูลในช่อง additionalData ของโทเค็นการย้ายข้อมูลที่นี่

เมธอด

delete

 ลบอุปกรณ์

get

 ได้รับอุปกรณ์

issueCommand

 ออกคำสั่งให้กับอุปกรณ์

list

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

patch

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