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 คุณไม่ต้องดำเนินการใดๆ อีกเพื่อให้การย้ายข้อมูลดำเนินต่อไป

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)

เวลาที่การอัปเดตพร้อมใช้งานเป็นครั้งแรก ค่า 0 หมายความว่าไม่ได้ตั้งค่าช่องนี้ ช่องนี้จะมีการตั้งค่าเฉพาะเมื่อมีการอัปเดตเท่านั้น (กล่าวคือ 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 ขึ้นไป

Display

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

การแสดง 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 ได้ (เช่น "แจ้งฉันหากข้อมูลแบตเตอรี่_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 นำสื่อที่จัดเก็บข้อมูลภายนอกออกแล้ว จำนวนไบต์ที่รายงานคือศูนย์
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)

เปิดใช้โหมด Common Criteria อยู่หรือไม่

CommonCriteriaModeStatus

เปิดใช้โหมด Common Criteria อยู่หรือไม่

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

DpcMigrationInfo

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

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

string

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

string

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

วิธีการ

delete

 ลบอุปกรณ์

get

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

issueCommand

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

list

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

patch

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