REST Resource: enterprises.devices

리소스: Device

기업 소유의 기기입니다. 달리 명시되지 않는 한 모든 필드는 읽기 전용이며 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가 적용됩니다. 이 필드는 패치 요청으로 수정할 수 있습니다. enterprises.devices.patch를 호출할 때 policyId만 지정할 수 있습니다. 단, policyId에 슬래시가 포함되어 있지 않아야 합니다. 나머지 정책 이름이 추론됩니다.
appliedPolicyName

string

현재 기기에 적용된 정책의 이름입니다.
appliedPolicyVersion

string (int64 format)

현재 기기에 적용된 정책의 버전입니다.
apiLevel

integer

기기에서 실행되는 Android 플랫폼 버전의 API 수준입니다.
enrollmentTokenData

string

추가 데이터가 제공되는 등록 토큰과 함께 기기가 등록된 경우 이 필드에 해당 데이터가 포함됩니다.
enrollmentTokenName

string

기기가 등록 토큰으로 등록된 경우 이 필드에 토큰의 이름이 포함됩니다.
disabledReason

object (UserFacingMessage)

기기 상태가 DISABLED인 경우 기기에 표시되는 선택적 메시지로서 기기가 사용 중지된 이유를 나타냅니다. 이 필드는 패치 요청으로 수정할 수 있습니다.
softwareInfo

object (SoftwareInfo)

기기 소프트웨어에 대한 자세한 정보입니다. 이 정보는 기기 정책에서 softwareInfoEnabled가 true인 경우에만 제공됩니다.
hardwareInfo

object (HardwareInfo)

기기 하드웨어에 대한 세부정보입니다.
displays[]

object (Display)

기기의 디스플레이에 관한 자세한 정보입니다. 이 정보는 기기 정책에서 displayInfoEnabled가 true인 경우에만 제공됩니다.
applicationReports[]

object (ApplicationReport)

기기에 설치된 앱에 대한 보고서입니다. 이 정보는 기기 정책에서 applicationReportsEnabled가 true인 경우에만 제공됩니다.
previousDeviceNames[]

string

동일한 실제 기기가 여러 번 등록된 경우 이 필드에는 이전 기기 이름이 포함됩니다. 일련번호는 동일한 실제 기기가 이전에 등록되었는지 확인하기 위한 고유 식별자로 사용됩니다. 이름은 시간순으로 표시됩니다.
networkInfo

object (NetworkInfo)

기기 네트워크 정보입니다. 이 정보는 기기 정책에서 networkInfoEnabled가 true인 경우에만 제공됩니다.
memoryInfo

object (MemoryInfo)

메모리 정보: 기기 메모리와 저장용량에 관한 정보를 포함합니다.
memoryEvents[]

object (MemoryEvent)

시간순으로 표시된 메모리 및 스토리지 측정과 관련된 이벤트입니다. 이 정보는 기기 정책에서 memoryInfoEnabled가 true인 경우에만 제공됩니다.

일정은 특정 기간 동안 보관되며 오래된 일정은 삭제됩니다.
powerManagementEvents[]

object (PowerManagementEvent)

시간순으로 기기의 전원 관리 이벤트입니다. 이 정보는 기기 정책에서 powerManagementEventsEnabled가 true인 경우에만 제공됩니다.
hardwareStatusSamples[]

object (HardwareStatus)

시간순으로 표시된 하드웨어 상태 샘플 이 정보는 기기 정책에서 hardwareStatusEnabled가 true인 경우에만 제공됩니다.
deviceSettings

object (DeviceSettings)

기기 설정 정보 이 정보는 기기 정책에서 deviceSettingsEnabled가 true인 경우에만 제공됩니다.
user

object (User)

기기를 소유한 사용자입니다.
systemProperties

map (key: string, value: string)

기기와 관련된 선택한 시스템 속성 이름 및 값의 맵입니다. 이 정보는 기기 정책에서 systemPropertiesEnabled가 true인 경우에만 제공됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

기기의 보안 수준을 반영하는 기기의 보안 상태 값입니다.
ownership

enum (Ownership)

관리 기기의 소유권입니다.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

공통 기준 모드에 대한 정보—정보 기술 보안 평가에 대한 공통 기준 (CC)에 정의된 보안 표준

이 정보는 기기 정책에서 statusReportingSettings.commonCriteriaModeEnabled이(가) true인 경우에만 사용할 수 있습니다.
appliedPasswordPolicies[]

object (PasswordRequirements)

현재 기기에 적용된 비밀번호 요구사항입니다.

  • 경우에 따라 적용되는 요구사항이 passwordPolicies에 명시된 요구사항과 약간 다를 수 있습니다.
  • fieldPath는 passwordPolicies에 따라 설정됩니다.
dpcMigrationInfo

object (DpcMigrationInfo)

출력 전용. 이 기기가 다른 기기 정책 컨트롤러 (DPC)에서 관리되지 않도록 이전되었는지와 관련된 정보입니다.

DeviceState

기기에 적용될 수 있는 상태입니다.

열거형
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

정책 설정의 이름입니다. 최상위 Policy 필드의 JSON 필드 이름입니다.
nonComplianceReason

enum (NonComplianceReason)

기기가 설정을 준수하지 않는 이유입니다.
packageName

string

해당하는 경우 정책을 준수하지 않는 앱을 나타내는 패키지 이름입니다.
fieldPath

string

중첩 필드가 있는 설정의 경우 특정 중첩 필드가 규정을 준수하지 않으면 문제가 되는 필드의 전체 경로를 지정합니다. 경로의 형식은 JavaScript에서 정책 JSON 필드를 참조하는 방식과 동일합니다. 즉, 1) 객체 유형 필드의 경우 필드 이름, 마침표, 하위 필드 이름이 차례로 나옵니다. 2) 배열 형식 필드의 경우 필드 이름 뒤에 배열 색인이 괄호로 묶여 표시됩니다. 예를 들어 세 번째 애플리케이션의 externalData 필드에 있는 url 필드에 문제가 있음을 나타내려면 경로는 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

앱 설치에 실패할 수 있는 이유입니다.

열거형
INSTALLATION_FAILURE_REASON_UNSPECIFIED 허용되지 않는 값입니다.
INSTALLATION_FAILURE_REASON_UNKNOWN 알 수 없는 상태로 인해 앱을 설치할 수 없습니다. 기기의 저장용량이 충분하지 않거나, 기기의 네트워크 연결이 불안정하거나, 설치하는 데 예상보다 시간이 오래 걸리기 때문일 수 있습니다. 설치가 자동으로 다시 시도됩니다.
IN_PROGRESS 설치가 아직 진행 중입니다.
NOT_FOUND Play에서 앱을 찾을 수 없습니다.
NOT_COMPATIBLE_WITH_DEVICE 앱이 기기와 호환되지 않습니다.
NOT_APPROVED 관리자가 앱을 승인하지 않았습니다.
PERMISSIONS_NOT_ACCEPTED 앱에 관리자가 승인하지 않은 새로운 권한이 있습니다.
NOT_AVAILABLE_IN_COUNTRY 사용자의 국가에서 사용할 수 없는 앱입니다.
NO_LICENSES_REMAINING 사용자에게 할당할 수 있는 라이선스가 없습니다.
NOT_ENROLLED 기업이 더 이상 관리 Google Play에 등록되어 있지 않거나 관리자가 최신 관리 Google Play 서비스 약관에 동의하지 않았습니다.
USER_INVALID 사용자가 더 이상 유효하지 않습니다. 사용자가 삭제되었거나 사용 중지되었을 수 있습니다.
NETWORK_ERROR_UNRELIABLE_CONNECTION

사용자 기기의 네트워크 오류로 인해 설치할 수 없습니다. 이 문제는 일반적으로 기기의 인터넷 연결이 불안정하거나, 사용할 수 없거나, 네트워크 구성 문제가 있을 때 발생합니다. 기기가 Android Enterprise Network Requirements을(를) 충족하는 네트워크에서 인터넷에 완전히 연결될 수 있는지 확인하세요. 이 경우 앱 설치 또는 업데이트가 자동으로 재개됩니다.
INSUFFICIENT_STORAGE 사용자의 기기에 앱을 설치하기 위한 저장공간이 충분하지 않습니다. 이 문제는 기기의 저장공간을 확보하면 해결할 수 있습니다. 기기에 저장용량이 충분하면 앱 설치 또는 업데이트가 자동으로 재개됩니다.

SpecificNonComplianceReason

기기가 정책 설정을 준수하지 않을 수 있는 이유에 관한 자세한 내용 향후 enum에 새 값을 추가할 수 있습니다.

열거형
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED 구체적인 규정 미준수 이유는 명시되어 있지 않습니다. specificNonComplianceContext의 필드는 설정되지 않습니다.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED 사용자는 화면 잠금을 입력하여 사용자 인증 정보를 확인해야 합니다. specificNonComplianceContext의 필드는 설정되지 않습니다. nonComplianceReason가 USER_ACTION로 설정되어 있습니다.
PASSWORD_POLICIES_PASSWORD_EXPIRED 기기 또는 프로필 비밀번호가 만료되었습니다. passwordPoliciesContext가 설정되었습니다. nonComplianceReason가 USER_ACTION로 설정되어 있습니다.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT 기기 비밀번호가 비밀번호 요구사항을 충족하지 않습니다. passwordPoliciesContext가 설정되었습니다. nonComplianceReason가 USER_ACTION로 설정되어 있습니다.
ONC_WIFI_INVALID_VALUE ONC Wi-Fi 구성에 잘못된 값이 있습니다. fieldPath는 잘못된 필드 값을 지정합니다. oncWifiContext가 설정되었습니다. nonComplianceReason이 INVALID_VALUE으로 설정되어 있습니다.
ONC_WIFI_API_LEVEL 기기에서 실행되는 Android 버전의 API 수준에서는 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 openNetworkConfiguration의 ClientCertKeyPairAlias 필드를 통해 지정된 키 쌍 별칭이 기기에 설치된 기존 키와 일치하지 않습니다. 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

규정을 준수하지 않는 Wi-Fi 구성의 GUID입니다.

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 빌드 ID 문자열입니다. 예를 들면 다음과 같습니다. shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys
deviceKernelVersion

string

커널 버전입니다(예: 2.6.32.9-g103d848).
bootloaderVersion

string

시스템 부트로더 버전 번호입니다(예: 0.6.7).
androidBuildTime

string (Timestamp format)

빌드 시간

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

시스템 패키지와 연결된 android.content.pm.Signature의 SHA-256 해시로 시스템 빌드가 수정되지 않았는지 확인하는 데 사용할 수 있습니다.
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

업데이트 상태: 업데이트 존재 여부 및 업데이트 유형입니다.

열거형
UPDATE_STATUS_UNKNOWN 보류 중인 시스템 업데이트가 있는지 알 수 없습니다. 예를 들어 기기 API 수준이 26 미만이거나 Android Device Policy의 버전이 오래된 경우 이러한 상황이 발생합니다.
UP_TO_DATE 기기에 보류 중인 시스템 업데이트가 없습니다.
UNKNOWN_UPDATE_AVAILABLE 사용 가능한 대기 중인 시스템 업데이트가 있지만 유형을 알 수 없습니다.
SECURITY_UPDATE_AVAILABLE 대기 중인 보안 업데이트가 있습니다.
OS_UPDATE_AVAILABLE 대기 중인 OS 업데이트가 있습니다.

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

출력 전용. 특정 조직에서 개인 소유 기기를 고유하게 식별하는 ID입니다. 동일한 실제 기기에서 동일한 조직에 등록한 경우 이 ID는 설정 및 초기화 시에도 유지됩니다. 이 ID는 Android 12 이상을 실행하는 기기에서 직장 프로필이 있는 개인 소유 기기에서 사용할 수 있습니다.

디스플레이

기기 디스플레이 정보입니다.

JSON 표현 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
입력란
name

string

디스플레이의 이름입니다.
displayId

integer

고유한 디스플레이 ID입니다.
refreshRate

integer

디스플레이의 화면 재생 빈도입니다(초당 프레임 수).
state

enum (DisplayState)

디스플레이 상태입니다.
width

integer

픽셀 단위의 디스플레이 너비입니다.
height

integer

픽셀 단위의 디스플레이 높이입니다.
density

integer

인치당 도트 수로 표시된 화면 밀도입니다.

DisplayState

디스플레이 상태입니다.

열거형
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

앱 APK 파일의 SHA-256 해시로 앱이 수정되지 않았는지 확인하는 데 사용할 수 있습니다. 해시 값의 각 바이트는 두 자리 16진수로 표현됩니다.
signingKeyCertFingerprints[]

string

앱 패키지와 연결된 각 android.content.pm.Signature의 SHA-1 해시입니다. 각 해시 값의 각 바이트는 두 자리 16진수로 표현됩니다.
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

앱 관련 이벤트의 유형입니다.

열거형
APPLICATION_EVENT_TYPE_UNSPECIFIED 허용되지 않는 값입니다.
INSTALLED 앱이 설치되었습니다.
CHANGED 앱이 변경됨(예: 구성요소가 사용 설정 또는 사용 중지됨)
DATA_CLEARED 앱 데이터가 삭제되었습니다.
REMOVED 앱이 삭제되었습니다.
REPLACED 이전 버전을 대체하는 새로운 버전의 앱이 설치되었습니다.
RESTARTED 앱이 다시 시작되었습니다.
PINNED 앱이 포그라운드에 고정되었습니다.
UNPINNED 앱이 고정 해제되었습니다.

ApplicationSource

앱을 제공한 소스입니다.

열거형
APPLICATION_SOURCE_UNSPECIFIED 앱이 지정되지 않은 소스에서 사이드로드되었습니다.
SYSTEM_APP_FACTORY_VERSION 기기의 공장 출고 시 이미지에서 가져온 시스템 앱입니다.
SYSTEM_APP_UPDATED_VERSION 업데이트된 시스템 앱입니다.
INSTALLED_FROM_PLAY_STORE Google Play 스토어에서 앱을 설치했습니다.

ApplicationState

현재 설치 상태입니다.

열거형
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)

기기에 앱 상태가 생성된 시간입니다.

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"입니다.

심각도

앱 상태의 심각도입니다.

열거형
SEVERITY_UNSPECIFIED 지정되지 않은 심각도 수준입니다.
INFO 정보 심각도 수준입니다.
ERROR 오류 심각도 수준입니다. 이는 관리 조직이 문제 해결을 위해 조치를 취해야 하는 실제 오류 조건에만 설정해야 합니다.

UserFacingType

앱이 사용자 대상인지 여부

열거형
USER_FACING_TYPE_UNSPECIFIED 앱 사용자 대상 유형이 지정되지 않았습니다.
NOT_USER_FACING 앱이 사용자에게 표시되지 않습니다.
USER_FACING 사용자에게 표시되는 앱입니다.

NetworkInfo

기기 네트워크 정보입니다.

JSON 표현 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
입력란
imei

string

GSM 기기의 IMEI 번호입니다. 예를 들면 다음과 같습니다. A1000031212
meid

string

CDMA 기기의 MEID 번호입니다. 예를 들면 다음과 같습니다. A00000292788E1
wifiMacAddress

string

기기의 Wi-Fi MAC 주소입니다. 예를 들면 다음과 같습니다. 7c:11:11:11:11:11
networkOperatorName
(deprecated)

string

현재 등록된 사업자의 알파벳 이름입니다. (예: Vodafone)
telephonyInfos[]

object (TelephonyInfo)

기기의 각 SIM 카드와 연결된 전화 통신 정보를 제공합니다. Android API 수준 23 이상의 완전 관리형 기기에서만 지원됩니다.

TelephonyInfo

기기의 지정된 SIM 카드와 연결된 전화 통신 정보입니다. Android API 수준 23 이상의 완전 관리형 기기에서만 지원됩니다.

JSON 표현 
{
  "phoneNumber": string,
  "carrierName": string
}
입력란
phoneNumber

string

SIM 카드와 연결된 전화번호입니다.
carrierName

string

이 SIM 카드와 연결된 이동통신사 이름입니다.

MemoryInfo

기기 메모리 및 저장용량에 관한 정보입니다.

JSON 표현 
{
  "totalRam": string,
  "totalInternalStorage": string
}
입력란
totalRam

string (int64 format)

기기의 총 RAM(바이트)입니다.
totalInternalStorage

string (int64 format)

기기의 총 내부 저장소(바이트)입니다.

MemoryEvent

메모리 및 저장소 측정과 관련된 이벤트입니다.

새 이벤트와 이전 이벤트를 구분하려면 createTime 필드를 사용하는 것이 좋습니다.

JSON 표현 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
입력란
eventType

enum (MemoryEventType)

이벤트 종류
createTime

string (Timestamp format)

일정 생성 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
byteCount

string (int64 format)

매체의 여유 바이트 수입니다. EXTERNAL_STORAGE_DETECTED의 경우 스토리지 매체의 총 용량(바이트)입니다.

MemoryEventType

이벤트 유형입니다.

열거형
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

이벤트 유형입니다.

열거형
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 프로텍트 인증을 시행할지 여부입니다.

EncryptionStatus

기기의 암호화 상태입니다.

열거형
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

관리 중인 기기의 가능한 보안 상태 값입니다.

열거형
POSTURE_UNSPECIFIED 지정되지 않았습니다. 이 상태 값에 대한 상태 세부정보가 없습니다.
SECURE 이 기기는 안전합니다.
AT_RISK 이 기기는 기업 데이터 사용에 권장되는 것보다 악의적인 행위자에게 더 취약할 수 있습니다.
POTENTIALLY_COMPROMISED 이 기기의 보안이 침해될 수 있으며 승인되지 않은 사용자가 회사 데이터에 액세스할 수 있습니다.

PostureDetail

기기의 보안 상태에 관한 추가 세부정보입니다.

JSON 표현 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
입력란
securityRisk

enum (SecurityRisk)

기기의 보안 상태에 부정적인 영향을 미치는 특정 보안 위험입니다.
advice[]

object (UserFacingMessage)

보안 위험을 완화하고 기기의 보안 상태를 개선하기 위한 관리자 대상 조언

SecurityRisk

기기가 가장 안전한 상태가 되지 않도록 하는 위험입니다.

열거형
SECURITY_RISK_UNSPECIFIED 지정되지 않았습니다.
UNKNOWN_OS Play Integrity API가 기기에서 알 수 없는 OS를 실행 중임을 감지합니다 (basicIntegrity 검사는 성공했지만 ctsProfileMatch는 실패함).
COMPROMISED_OS Play Integrity API가 기기에서 보안 침해된 OS를 실행 중임을 감지합니다 (basicIntegrity 검사 실패).
HARDWARE_BACKED_EVALUATION_FAILED Play Integrity API는 MEETS_STRONG_INTEGRITY 라벨이 기기 무결성 필드에 표시되지 않는 경우 기기가 시스템 무결성을 강력하게 보장하지 않는다는 것을 감지합니다.

CommonCriteriaModeInfo

공통 기준 모드에 대한 정보—정보 기술 보안 평가에 대한 공통 기준 (CC)에 정의된 보안 표준

이 정보는 기기 정책에서 statusReportingSettings.commonCriteriaModeEnabled이 true인 경우에만 사용할 수 있습니다.

JSON 표현 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
입력란
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

공통 기준 모드의 사용 설정 여부

CommonCriteriaModeStatus

공통 기준 모드의 사용 설정 여부

열거형
COMMON_CRITERIA_MODE_STATUS_UNKNOWN 알 수 없는 상태입니다.
COMMON_CRITERIA_MODE_DISABLED 현재 공통 기준 모드가 사용 중지되어 있습니다.
COMMON_CRITERIA_MODE_ENABLED 현재 공통 기준 모드가 사용 설정되어 있습니다.

DpcMigrationInfo

이 기기가 다른 기기 정책 컨트롤러 (DPC)에서 관리되지 않도록 이전되었는지와 관련된 정보입니다.

JSON 표현 
{
  "previousDpc": string,
  "additionalData": string
}
입력란
previousDpc

string

출력 전용. 기기가 다른 DPC에서 이전된 경우 이 기기의 패키지 이름입니다. 그 외에는 채워지지 않습니다.
additionalData

string

출력 전용. 이 기기가 다른 DPC에서 이전되었다면 이전 토큰의 additionalData 필드가 여기에 채워집니다.

방법

delete

 기기를 삭제합니다.

get

 기기를 가져옵니다.

issueCommand

 기기에 명령어를 실행합니다.

list

 지정된 기업의 기기를 나열합니다.

patch

 기기를 업데이트합니다.