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를 호출할 때는 ACTIVEDISABLED만 허용되는 값입니다. 기기를 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

기기에서 실행되는 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.commonCriteriaModeEnabledtrue이고 기기가 회사 소유인 경우에만 사용할 수 있습니다.

appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • 경우에 따라 적용된 요구사항이 passwordPolicies에 지정된 요구사항과 약간 다를 수 있습니다.
  • fieldPathpasswordPolicies를 기반으로 설정됩니다.
dpcMigrationInfo

object (DpcMigrationInfo)

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

DeviceState

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

열거형
DEVICE_STATE_UNSPECIFIED 이 값은 허용되지 않습니다.
ACTIVE 기기가 활성 상태입니다.
DISABLED 기기가 사용 중지되었습니다.
DELETED 기기가 삭제되었습니다. 이 상태는 API 호출에서 반환되지 않지만 기기가 삭제를 확인하면 최종 상태 보고서에 사용됩니다. API 호출을 통해 기기가 삭제되면 이 상태가 Pub/Sub에 게시됩니다. 사용자가 직장 프로필을 삭제하거나 기기를 재설정하면 서버에서 기기 상태를 알 수 없는 상태로 유지됩니다.
PROVISIONING 기기를 프로비저닝하는 중입니다. 새로 등록된 기기는 정책이 적용될 때까지 이 상태로 유지됩니다.
LOST 기기가 분실되었습니다. 이 상태는 조직 소유 기기에서만 가능합니다.
PREPARING_FOR_MIGRATION 기기가 Android Management API로 이전할 준비 중입니다. 이전을 계속하기 위해 취해야 할 추가 조치는 없습니다.
DEACTIVATED_BY_DEVICE_FINANCE 할부 대행사에서 '잠긴' 할부 기기입니다. 즉, 파이낸싱 대리인이 기기를 '잠금 해제'할 때까지 기기 기능을 제한하는 특정 정책 설정이 적용되었습니다. 기기에는 파이낸싱 대리인이 재정의한 정책 설정을 제외한 정책 설정이 계속 적용됩니다. 기기가 '잠겨' 있으면 상태가 appliedStateDEACTIVATED_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

정책 설정의 이름입니다. 최상위 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

기기가 정책 설정을 준수하지 않을 수 있는 이유에 대한 세부정보입니다. 향후 열거형에 새 값이 추가될 수 있습니다.

열거형
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED 구체적인 정책 위반 사유가 지정되지 않았습니다. specificNonComplianceContext의 필드는 설정되지 않습니다.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED 사용자는 화면 잠금으로 이동하여 사용자 인증 정보를 확인해야 합니다. specificNonComplianceContext의 필드는 설정되지 않습니다. nonComplianceReasonUSER_ACTION로 설정됩니다.
PASSWORD_POLICIES_PASSWORD_EXPIRED 기기 또는 프로필 비밀번호가 만료되었습니다. passwordPoliciesContext가 설정됩니다. nonComplianceReasonUSER_ACTION로 설정되어 있습니다.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT 기기 비밀번호가 비밀번호 요구사항을 충족하지 않습니다. passwordPoliciesContext가 설정됩니다. nonComplianceReasonUSER_ACTION로 설정됩니다.
ONC_WIFI_INVALID_VALUE ONC Wi-Fi 구성에 잘못된 값이 있습니다. fieldPath은 잘못된 필드 값을 지정합니다. oncWifiContext가 설정되었습니다. nonComplianceReasonINVALID_VALUE으로 설정되어 있습니다.
ONC_WIFI_API_LEVEL 기기에서 실행되는 Android 버전의 API 수준에서 ONC Wi-Fi 설정이 지원되지 않습니다. fieldPath은 지원되지 않는 필드 값을 지정합니다. oncWifiContext가 설정됩니다. nonComplianceReasonAPI_LEVEL으로 설정되어 있습니다.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG 엔터프라이즈 Wi-Fi 네트워크에 루트 CA 또는 도메인 이름이 누락되었습니다. nonComplianceReasonINVALID_VALUE로 설정되어 있습니다.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK 사용자가 구성된 Wi-Fi 네트워크를 수동으로 삭제해야 합니다. 개인 소유 기기의 직장 프로필에만 적용됩니다. nonComplianceReasonUSER_ACTION로 설정되어 있습니다.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY openNetworkConfigurationClientCertKeyPairAlias 필드를 통해 지정된 키 쌍 별칭이 기기에 설치된 기존 키와 일치하지 않습니다. nonComplianceReasonINVALID_VALUE로 설정되어 있습니다.

SpecificNonComplianceContext

SpecificNonComplianceReason의 추가 컨텍스트입니다.

JSON 표현
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
필드
oncWifiContext

object (OncWifiContext)

Wi-Fi 구성과 관련된 규정 미준수에 관한 추가 컨텍스트입니다. ONC_WIFI_INVALID_VALUEONC_WIFI_API_LEVEL를 참고하세요.

passwordPoliciesContext

object (PasswordPoliciesContext)

비밀번호 정책 관련 정책 위반에 대한 추가 컨텍스트입니다. PASSWORD_POLICIES_PASSWORD_EXPIREDPASSWORD_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이면 이 필드가 설정되지 않았음을 나타냅니다. 이 필드는 업데이트를 사용할 수 있는 경우에만 설정됩니다 (즉, updateStatusUPDATE_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 기기 정책 버전이 오래된 경우 이 문제가 발생합니다.
UP_TO_DATE 기기에 대기 중인 시스템 업데이트가 없습니다.
UNKNOWN_UPDATE_AVAILABLE 대기 중인 시스템 업데이트가 있지만 유형을 알 수 없습니다.
SECURITY_UPDATE_AVAILABLE 대기 중인 보안 업데이트가 있습니다.
OS_UPDATE_AVAILABLE 대기 중인 OS 업데이트가 있습니다.

HardwareInfo

기기 하드웨어에 관한 정보입니다. 온도 기준점과 관련된 필드는 기기 정책에서 hardwareStatusEnabled이 true인 경우에만 사용할 수 있습니다.

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

인치당 도트(dpi)로 표시되는 디스플레이 밀도입니다.

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,
  "iccId": string
}
필드
phoneNumber

string

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

carrierName

string

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

iccId

string

출력 전용입니다. 이 SIM 카드와 연결된 ICCID입니다.

MemoryInfo

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

JSON 표현
{
  "totalRam": string,
  "totalInternalStorage": string
}
필드
totalRam

string (int64 format)

기기의 총 RAM(단위: 바이트)입니다.

totalInternalStorage

string (int64 format)

기기의 총 내부 저장용량(단위: 바이트)입니다.

MemoryEvent

메모리 및 스토리지 측정과 관련된 이벤트입니다.

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

JSON 표현
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
필드
eventType

enum (MemoryEventType)

이벤트 종류

createTime

string (Timestamp format)

이벤트 생성 시간입니다.

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.commonCriteriaModeEnabledtrue인 경우에만 사용할 수 있습니다.

JSON 표현
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
필드
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

공통 기준 모드의 사용 설정 여부입니다.

policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

출력 전용입니다. 정책 서명 확인 상태입니다.

CommonCriteriaModeStatus

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

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

PolicySignatureVerificationStatus

정책 서명 확인 상태입니다.

열거형
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED 지정되지 않았습니다. 인증 상태가 보고되지 않았습니다. statusReportingSettings.commonCriteriaModeEnabled가 false인 경우에만 설정됩니다.
POLICY_SIGNATURE_VERIFICATION_DISABLED commonCriteriaMode가 false로 설정되어 있으므로 기기에서 정책 서명 인증이 사용 중지됩니다.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED 정책 서명 확인에 성공했습니다.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED 정책 서명 확인이 지원되지 않습니다(예: 기기가 정책 서명 확인을 지원하지 않는 CloudDPC 버전으로 등록됨).
POLICY_SIGNATURE_VERIFICATION_FAILED 정책 서명 확인에 실패했습니다. 정책이 적용되지 않았습니다.

DpcMigrationInfo

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

JSON 표현
{
  "previousDpc": string,
  "additionalData": string
}
필드
previousDpc

string

출력 전용입니다. 이 기기가 다른 DPC에서 이전된 경우 패키지 이름입니다. 그렇지 않으면 채워지지 않습니다.

additionalData

string

출력 전용입니다. 이 기기가 다른 DPC에서 이전된 경우 이전 토큰의 additionalData 필드가 여기에 채워집니다.

메서드

delete

기기를 삭제합니다.

get

기기를 가져옵니다.

issueCommand

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

list

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

patch

기기를 업데이트합니다.