MCP Tools Reference: Android Device Management MCP Server

도구: list_devices

지정된 기업의 기기를 나열합니다. 상위 필드에 엔터프라이즈 ID (예: enterprises/{enterpriseId})가 필요합니다.

다음 샘플은 curl를 사용하여 list_devices MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

지정된 기업의 기기를 나열하도록 요청합니다.

ListDevicesRequest

JSON 표현 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
필드
parent

string

enterprises/{enterpriseId} 형식의 기업 이름입니다.
pageSize

integer

요청된 페이지 크기입니다. 지정하지 않으면 최대 10개의 기기가 반환됩니다. 최댓값은 100이며, 100을 초과하는 값은 100으로 변환됩니다. 한도는 시간이 지남에 따라 변경될 수 있습니다.
pageToken

string

서버에서 반환하는 결과 페이지를 식별하는 토큰입니다.

출력 스키마

특정 기업의 기기를 나열하는 요청에 대한 응답입니다.

ListDevicesResponse

JSON 표현 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
필드
devices[]

object (Device)

기기 목록입니다.
nextPageToken

string

결과가 더 있는 경우 결과의 다음 페이지를 검색하는 토큰입니다.

기기

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
필드
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)

기기 등록 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
lastStatusReportTime

string (Timestamp format)

기기에서 상태 보고서를 마지막으로 보낸 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

지원 중단되었습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
lastPolicySyncTime

string (Timestamp format)

기기가 정책을 마지막으로 가져온 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
policyName

string

기기에 적용된 정책의 이름입니다(enterprises/{enterpriseId}/policies/{policyId} 형식). 지정하지 않으면 기기 사용자의 policy_name이 적용됩니다. 이 필드는 패치 요청으로 수정할 수 있습니다. 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)

기기에 설치된 앱에 대한 보고서입니다. 이 정보는 기기 정책에서 application_reports_enabled이 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에 지정된 요구사항과 약간 다를 수 있기 때문에 존재합니다.
  • 이 필드는 비밀번호 규정 준수에 관한 정보를 제공하지 않습니다. 규정 미준수 정보는 nonComplianceDetails를 참고하세요.
  • NonComplianceDetail.fieldPath는 이 필드가 아닌 passwordPolicies에 따라 설정됩니다.
dpcMigrationInfo

object (DpcMigrationInfo)

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

object (DefaultApplicationInfo)

출력 전용입니다. DefaultApplicationType의 기본 애플리케이션 정보입니다. 이 정보는 기기의 정책에서 defaultApplicationInfoReportingEnabled이 true인 경우에만 제공됩니다. Android 16 이상에서 사용할 수 있습니다.

모든 앱 유형이 완전 관리형 기기에서 보고됩니다. DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING, DEFAULT_DIALER 유형은 직장 프로필이 있는 회사 소유 기기와 개인 소유 기기의 직장 프로필에 대해 보고됩니다. DEFAULT_WALLET는 직장 프로필이 있는 회사 소유 기기에도 보고되지만 직장 프로필 정보만 포함됩니다.

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

중첩 필드가 있는 설정의 경우 특정 중첩 필드가 정책을 준수하지 않으면 위반 필드의 전체 경로가 지정됩니다. 경로는 정책 JSON 필드가 JavaScript에서 참조되는 방식과 동일한 방식으로 형식이 지정됩니다. 즉, 1) 객체 유형 필드의 경우 필드 이름 뒤에 점이 오고 그 뒤에 하위 필드 이름이 옵니다. 2) 배열 유형 필드의 경우 필드 이름 뒤에 대괄호로 묶인 배열 색인이 표시됩니다. 예를 들어 세 번째 애플리케이션의 externalData 필드에 있는 url 필드에 문제가 있음을 나타내려면 경로는 applications[2].externalData.url가 됩니다.
currentValue

value (Value format)

정책 설정을 적용할 수 없는 경우 기기의 현재 설정 값입니다.
installationFailureReason

enum (InstallationFailureReason)

package_name가 설정되고 비준수 이유가 APP_NOT_INSTALLED 또는 APP_NOT_UPDATED인 경우 앱을 설치하거나 업데이트할 수 없는 자세한 이유입니다.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

기기가 설정에 따르지 않는 정책별 이유입니다.
specificNonComplianceContext

object (SpecificNonComplianceContext)

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

값

JSON 표현 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 값의 종류입니다. kind은 다음 중 하나여야 합니다.
nullValue

null

null 값을 나타냅니다.
numberValue

number

double 값을 나타냅니다.
stringValue

string

문자열 값을 나타냅니다.
boolValue

boolean

불리언 값을 나타냅니다.
structValue

object (Struct format)

구조화된 값을 나타냅니다.
listValue

array (ListValue format)

반복되는 Value을 나타냅니다.

구조체

JSON 표현 
{
  "fields": {
    string: value,
    ...
  }
}
필드
fields

map (key: string, value: value (Value format))

동적으로 입력된 값의 순서가 지정되지 않은 맵입니다.

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

FieldsEntry

JSON 표현 
{
  "key": string,
  "value": value
}
필드
key

string
value

value (Value format)

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

SpecificNonComplianceContext

JSON 표현 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
필드
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을 참고하세요.
defaultApplicationContext

object (DefaultApplicationContext)

출력 전용입니다. 기본 애플리케이션 설정과 관련된 정책 위반에 대한 추가 컨텍스트입니다. DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE를 참조하세요.

OncWifiContext

JSON 표현 
{
  "wifiGuid": string
}
필드
wifiGuid

string

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

PasswordPoliciesContext

JSON 표현 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
필드
passwordPolicyScope

enum (PasswordPolicyScope)

규정을 준수하지 않는 비밀번호의 범위입니다.

DefaultApplicationContext

JSON 표현 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
필드
defaultApplicationScope

enum (DefaultApplicationScope)

출력 전용입니다. 정책을 준수하지 않는 기본 애플리케이션 설정의 범위입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

UserFacingMessage

JSON 표현 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
필드
localizedMessages

map (key: string, value: string)

<locale, message> 쌍이 포함된 맵입니다. 여기서 locale은 en-US, es-ES, fr과 같은 형식이 올바른 BCP 47 언어 코드입니다.

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

string

현지화된 메시지가 지정되지 않았거나 사용자의 언어가 현지화된 메시지와 일치하지 않는 경우 표시되는 기본 메시지입니다. 현지화된 메시지가 제공되는 경우 기본 메시지를 제공해야 합니다.

LocalizedMessagesEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

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)

빌드 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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도 아님).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

HardwareInfo

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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
필드
brand

string

기기의 브랜드입니다. 예를 들면 Google입니다.
hardware

string

하드웨어 이름입니다. 예를 들면 Angler입니다.
deviceBasebandVersion

string

베이스밴드 버전입니다. 예를 들면 MDM9625_104662.22.05.34p입니다.
manufacturer

string

제조업체 예를 들면 Motorola입니다.
serialNumber

string

기기 일련번호입니다. 하지만 Android 12 이상을 실행하는 개인 소유 기기의 경우 이는 enterpriseSpecificId과 동일합니다.
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 이상을 실행하는 기기에서 직장 프로필이 있는 개인 소유 기기에서 사용할 수 있습니다.
euiccChipInfo[]

object (EuiccChipInfo)

출력 전용입니다. eUICC 칩과 관련된 정보입니다.

EuiccChipInfo

JSON 표현 
{
  "eid": string
}
필드
eid

string

출력 전용입니다. 기기의 각 eUICC 칩에 대해 eUICC 칩을 식별하는 삽입된 ID 문서 (EID)입니다. 이 기능은 Android 13 이상을 실행하는 회사 소유 기기에서 사용할 수 있습니다.

디스플레이

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

인치당 도트 수로 표현된 디스플레이 밀도입니다.

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)

이벤트 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
lastUpdateTime

string (Timestamp format)

앱 상태가 가장 최근에 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

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

JSON 표현 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
필드
phoneNumber

string

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

string

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

string

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

enum (ActivationState)

출력 전용입니다. 기기의 SIM 카드 활성화 상태입니다. eSIM에만 적용됩니다. 이 기능은 API 수준 35 이상의 모든 기기에서 지원됩니다. 이는 실제 SIM과 API 수준 35 미만의 기기의 경우 항상 ACTIVATION_STATE_UNSPECIFIED입니다.
configMode

enum (ConfigMode)

출력 전용입니다. 기기의 SIM 카드 구성 모드입니다. eSIM에만 적용됩니다. 이 기능은 API 수준 35 이상의 모든 기기에서 지원됩니다. 이는 실제 SIM과 API 수준 35 미만의 기기의 경우 항상 CONFIG_MODE_UNSPECIFIED입니다.

MemoryInfo

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

string (int64 format)

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

string (int64 format)

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

MemoryEvent

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

enum (MemoryEventType)

이벤트 종류
createTime

string (Timestamp format)

이벤트 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
byteCount

string (int64 format)

미디어의 여유 바이트 수 또는 EXTERNAL_STORAGE_DETECTED의 경우 스토리지 미디어의 총 용량(바이트)입니다.

PowerManagementEvent

JSON 표현 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
필드
eventType

enum (PowerManagementEventType)

이벤트 종류
createTime

string (Timestamp format)

이벤트 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
batteryLevel

number

BATTERY_LEVEL_COLLECTED 이벤트의 경우 배터리 잔량(백분율)입니다.

HardwareStatus

JSON 표현 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
필드
createTime

string (Timestamp format)

측정이 이루어진 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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 프로텍트 인증이 적용되는지 여부입니다.

사용자

JSON 표현 
{
  "accountIdentifier": string
}
필드
accountIdentifier

string

이 사용자에 대해 생성한 고유 식별자입니다(예: user342 또는 asset#44418). 이 필드는 사용자가 생성될 때 설정해야 하며 업데이트할 수 없습니다. 이 필드에는 개인 식별 정보 (PII)를 포함해서는 안 됩니다. 이 식별자는 1, 024자(영문 기준) 이하여야 합니다. 그렇지 않으면 업데이트 정책 요청이 실패합니다.

SystemPropertiesEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

SecurityPosture

JSON 표현 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
필드
devicePosture

enum (DevicePosture)

기기의 보안 상황 값입니다.
postureDetails[]

object (PostureDetail)

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

PostureDetail

JSON 표현 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
필드
securityRisk

enum (SecurityRisk)

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

object (UserFacingMessage)

이 보안 위험을 완화하고 기기의 보안 태세를 개선하기 위한 관리자 대상 권장사항

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

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

enum (PolicySignatureVerificationStatus)

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

PasswordRequirements

JSON 표현 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
필드
passwordMinimumLength

integer

허용되는 최소 비밀번호 길이입니다. 값이 0이면 제한이 없음을 의미합니다. password_quality가 NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC 또는 COMPLEX인 경우에만 적용됩니다.
passwordMinimumLetters

integer

비밀번호에 필요한 최소 문자 수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordMinimumLowerCase

integer

비밀번호에 필요한 최소 소문자 수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordMinimumNonLetter

integer

비밀번호에 필요한 비문자 (숫자 또는 기호)의 최소 개수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordMinimumNumeric

integer

비밀번호에 필요한 최소 숫자 수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordMinimumSymbols

integer

비밀번호에 필요한 최소 기호 수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordMinimumUpperCase

integer

비밀번호에 필요한 최소 대문자 수입니다. password_quality이 COMPLEX인 경우에만 적용됩니다.
passwordQuality

enum (PasswordQuality)

필수 비밀번호 품질입니다.
passwordHistoryLength

integer

비밀번호 기록의 길이입니다. 이 필드를 설정하면 사용자는 기록에 있는 비밀번호와 동일한 새 비밀번호를 입력할 수 없습니다. 값이 0이면 제한이 없음을 의미합니다.
maximumFailedPasswordsForWipe

integer

기기가 초기화되기 전에 입력할 수 있는 잘못된 기기 잠금 해제 비밀번호의 수입니다. 값이 0이면 제한이 없음을 의미합니다.
passwordExpirationTimeout

string (Duration format)

비밀번호 만료 시간 제한입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
passwordScope

enum (PasswordPolicyScope)

비밀번호 요구사항이 적용되는 범위입니다.
requirePasswordUnlock

enum (RequirePasswordUnlock)

강력한 형태의 인증 (비밀번호, PIN, 패턴)을 사용하여 기기 또는 직장 프로필을 잠금 해제한 후 다른 인증 방법 (예: 지문, 신뢰할 수 있는 에이전트, 얼굴)을 사용하여 잠금 해제할 수 있는 시간입니다. 지정된 기간이 지나면 강력한 형태의 인증만 사용하여 기기 또는 직장 프로필을 잠금 해제할 수 있습니다.
unifiedLockSettings

enum (UnifiedLockSettings)

직장 프로필이 있는 Android 9 이상을 실행하는 기기에서 기기와 직장 프로필에 통합 잠금이 허용되는지 제어합니다. password_scope이 SCOPE_PROFILE으로 설정된 경우에만 설정할 수 있습니다. 그렇지 않으면 정책이 거부됩니다. 사용자가 별도의 직장 앱 잠금을 설정하지 않았고 이 필드가 REQUIRE_SEPARATE_WORK_LOCK로 설정된 경우 nonComplianceReason이 USER_ACTION로 설정된 NonComplianceDetail이 보고됩니다.

기간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

시간 범위의 부호가 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 범위는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년에서 계산됩니다.
nanos

integer

시간 범위의 나노초 단위로 된 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표현됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 부호가 같아야 합니다. -999,999,999~+999,999,999(포함) 사이여야 합니다.

DpcMigrationInfo

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

string

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

string

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

DefaultApplicationInfo

JSON 표현 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
필드
defaultApplicationType

enum (DefaultApplicationType)

출력 전용입니다. 기본 애플리케이션 유형입니다.
packageName

string

출력 전용입니다. 현재 기본 애플리케이션의 패키지 이름입니다.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

출력 전용입니다. 기본 애플리케이션 설정 시도의 세부정보입니다. defaultApplications에 나열된 순서와 동일합니다.

DefaultApplicationSettingAttempt

JSON 표현 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
필드
packageName

string

출력 전용입니다. 시도된 애플리케이션의 패키지 이름입니다.
attemptOutcome

enum (AttemptOutcome)

출력 전용입니다. 앱을 기본값으로 설정한 결과입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌