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를 호출할 때 허용되는 값은 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가 적용됩니다. 이 필드는 패치 요청으로 수정할 수 있습니다. 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에 명시된 요구사항과 약간 다를 수 있습니다.
  • 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 파이낸싱을 통해 '잠긴' 기기입니다. 제공합니다. 이는 기기가 '잠금 해제'될 때까지 기기 기능을 제한하는 특정 정책 설정이 적용되었음을 의미합니다. 제공합니다. 기기는 파이낸싱 상담사가 재정의한 정책을 제외한 정책 설정을 계속 적용합니다. 기기가 '잠긴' 경우 상태는 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

정책 설정의 이름입니다. 최상위 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의 필드가 설정되지 않았습니다. 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 ONC Wi-Fi 설정은 기기에서 실행 중인 Android 버전의 API 레벨에서 지원되지 않습니다. 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_UNKNOWNUP_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 data < 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.commonCriteriaModeEnabledtrue인 경우에만 사용할 수 있습니다.

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

기기를 업데이트합니다.