REST Resource: enterprises.policies

리소스: 정책

정책 리소스는 관리 기기와 기기에 설치된 앱의 동작을 관리하는 설정 그룹을 나타냅니다.

JSON 표현 
{
  "name": string,
  "version": string,
  "applications": [
    {
      object (ApplicationPolicy)
    }
  ],
  "maximumTimeToLock": string,
  "screenCaptureDisabled": boolean,
  "cameraDisabled": boolean,
  "keyguardDisabledFeatures": [
    enum (KeyguardDisabledFeature)
  ],
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "persistentPreferredActivities": [
    {
      object (PersistentPreferredActivity)
    }
  ],
  "openNetworkConfiguration": {
    object
  },
  "systemUpdate": {
    object (SystemUpdate)
  },
  "accountTypesWithManagementDisabled": [
    string
  ],
  "addUserDisabled": boolean,
  "adjustVolumeDisabled": boolean,
  "factoryResetDisabled": boolean,
  "installAppsDisabled": boolean,
  "mountPhysicalMediaDisabled": boolean,
  "modifyAccountsDisabled": boolean,
  "safeBootDisabled": boolean,
  "uninstallAppsDisabled": boolean,
  "statusBarDisabled": boolean,
  "keyguardDisabled": boolean,
  "minimumApiLevel": integer,
  "statusReportingSettings": {
    object (StatusReportingSettings)
  },
  "bluetoothContactSharingDisabled": boolean,
  "shortSupportMessage": {
    object (UserFacingMessage)
  },
  "longSupportMessage": {
    object (UserFacingMessage)
  },
  "passwordRequirements": {
    object (PasswordRequirements)
  },
  "wifiConfigsLockdownEnabled": boolean,
  "bluetoothConfigDisabled": boolean,
  "cellBroadcastsConfigDisabled": boolean,
  "credentialsConfigDisabled": boolean,
  "mobileNetworksConfigDisabled": boolean,
  "tetheringConfigDisabled": boolean,
  "vpnConfigDisabled": boolean,
  "wifiConfigDisabled": boolean,
  "createWindowsDisabled": boolean,
  "networkResetDisabled": boolean,
  "outgoingBeamDisabled": boolean,
  "outgoingCallsDisabled": boolean,
  "removeUserDisabled": boolean,
  "shareLocationDisabled": boolean,
  "smsDisabled": boolean,
  "unmuteMicrophoneDisabled": boolean,
  "usbFileTransferDisabled": boolean,
  "ensureVerifyAppsEnabled": boolean,
  "permittedInputMethods": {
    object (PackageNameList)
  },
  "stayOnPluggedModes": [
    enum (BatteryPluggedMode)
  ],
  "recommendedGlobalProxy": {
    object (ProxyInfo)
  },
  "setUserIconDisabled": boolean,
  "setWallpaperDisabled": boolean,
  "choosePrivateKeyRules": [
    {
      object (ChoosePrivateKeyRule)
    }
  ],
  "alwaysOnVpnPackage": {
    object (AlwaysOnVpnPackage)
  },
  "frpAdminEmails": [
    string
  ],
  "deviceOwnerLockScreenInfo": {
    object (UserFacingMessage)
  },
  "dataRoamingDisabled": boolean,
  "locationMode": enum (LocationMode),
  "networkEscapeHatchEnabled": boolean,
  "bluetoothDisabled": boolean,
  "complianceRules": [
    {
      object (ComplianceRule)
    }
  ],
  "blockApplicationsEnabled": boolean,
  "installUnknownSourcesAllowed": boolean,
  "debuggingFeaturesAllowed": boolean,
  "funDisabled": boolean,
  "autoTimeRequired": boolean,
  "permittedAccessibilityServices": {
    object (PackageNameList)
  },
  "appAutoUpdatePolicy": enum (AppAutoUpdatePolicy),
  "kioskCustomLauncherEnabled": boolean,
  "androidDevicePolicyTracks": [
    enum (AppTrack)
  ],
  "skipFirstUseHintsEnabled": boolean,
  "privateKeySelectionEnabled": boolean,
  "encryptionPolicy": enum (EncryptionPolicy),
  "usbMassStorageEnabled": boolean,
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "playStoreMode": enum (PlayStoreMode),
  "setupActions": [
    {
      object (SetupAction)
    }
  ],
  "passwordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "policyEnforcementRules": [
    {
      object (PolicyEnforcementRule)
    }
  ],
  "kioskCustomization": {
    object (KioskCustomization)
  },
  "advancedSecurityOverrides": {
    object (AdvancedSecurityOverrides)
  },
  "personalUsagePolicies": {
    object (PersonalUsagePolicies)
  },
  "autoDateAndTimeZone": enum (AutoDateAndTimeZone),
  "oncCertificateProviders": [
    {
      object (OncCertificateProvider)
    }
  ],
  "crossProfilePolicies": {
    object (CrossProfilePolicies)
  },
  "preferentialNetworkService": enum (PreferentialNetworkService),
  "usageLog": {
    object (UsageLog)
  },
  "cameraAccess": enum (CameraAccess),
  "microphoneAccess": enum (MicrophoneAccess),
  "deviceConnectivityManagement": {
    object (DeviceConnectivityManagement)
  },
  "deviceRadioState": {
    object (DeviceRadioState)
  },
  "credentialProviderPolicyDefault": enum (CredentialProviderPolicyDefault),
  "printingPolicy": enum (PrintingPolicy),
  "displaySettings": {
    object (DisplaySettings)
  },
  "assistContentPolicy": enum (AssistContentPolicy),
  "workAccountSetupConfig": {
    object (WorkAccountSetupConfig)
  },
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "enterpriseDisplayNameVisibility": enum (EnterpriseDisplayNameVisibility),
  "appFunctions": enum (AppFunctions)
}
필드
name

string

enterprises/{enterpriseId}/policies/{policyId} 형식의 정책 이름입니다.
version

string (int64 format)

정책의 버전입니다. 읽기 전용 필드입니다. 정책이 업데이트될 때마다 버전이 증가합니다.
applications[]

object (ApplicationPolicy)

앱에 적용된 정책입니다. 여기에는 최대 3,000개의 요소가 포함될 수 있습니다.
maximumTimeToLock

string (int64 format)

기기가 잠길 때까지의 사용자 활동 최대 시간(밀리초)입니다. 값이 0이면 제한이 없음을 의미합니다.
screenCaptureDisabled

boolean

화면 캡처가 사용 중지되었는지 여부입니다.
cameraDisabled
(deprecated)

boolean

cameraAccess이 CAMERA_ACCESS_UNSPECIFIED 이외의 값으로 설정된 경우 아무런 효과가 없습니다. 그렇지 않으면 이 필드는 카메라가 사용 중지되는지 여부를 제어합니다. true이면 모든 카메라가 사용 중지되고, 그렇지 않으면 카메라를 사용할 수 있습니다. 완전 관리형 기기의 경우 이 필드는 기기의 모든 앱에 적용됩니다. 직장 프로필의 경우 이 필드는 직장 프로필의 앱에만 적용되며 직장 프로필 외부 앱의 카메라 액세스에는 영향을 미치지 않습니다.
keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

위젯과 같은 키가드 맞춤설정이 사용 중지되었습니다.
defaultPermissionPolicy

enum (PermissionPolicy)

런타임 권한 요청의 기본 권한 정책입니다.
persistentPreferredActivities[]

object (PersistentPreferredActivity)

기본 인텐트 핸들러 활동입니다.
openNetworkConfiguration

object (Struct format)

기기의 네트워크 구성입니다. 자세한 내용은 네트워크 구성을 참고하세요.
systemUpdate

object (SystemUpdate)

OS 업데이트가 적용되는 방식을 제어하는 시스템 업데이트 정책입니다. 업데이트 유형이 WINDOWED인 경우 업데이트 기간이 Play 앱 업데이트에도 자동으로 적용됩니다.

참고: Google Play 시스템 업데이트 (Mainline 업데이트라고도 함)는 자동으로 다운로드되며 설치하려면 기기를 재부팅해야 합니다. 자세한 내용은 시스템 업데이트 관리의 Mainline 섹션을 참고하세요.
accountTypesWithManagementDisabled[]

string

사용자가 관리할 수 없는 계정 유형입니다.
addUserDisabled

boolean

새 사용자 및 프로필 추가가 사용 중지되었는지 여부입니다. managementMode이 DEVICE_OWNER인 기기의 경우 이 필드는 무시되며 사용자는 사용자를 추가하거나 삭제할 수 없습니다.
adjustVolumeDisabled

boolean

마스터 볼륨 조절이 사용 중지되었는지 여부입니다. 기기도 음소거합니다. 이 설정은 완전 관리형 기기에만 적용됩니다.
factoryResetDisabled

boolean

설정에서 초기화가 사용 중지되었는지 여부입니다.
installAppsDisabled

boolean

사용자의 앱 설치가 사용 중지되었는지 여부입니다.
mountPhysicalMediaDisabled

boolean

실제 외부 미디어를 마운트하는 사용자가 사용 중지되었는지 여부입니다.
modifyAccountsDisabled

boolean

계정 추가 또는 삭제가 사용 중지되었는지 여부입니다.
safeBootDisabled
(deprecated)

boolean

기기를 안전 부팅으로 재부팅하는 것이 사용 중지되었는지 여부입니다.
uninstallAppsDisabled

boolean

사용자의 애플리케이션 제거가 사용 중지되었는지 여부입니다. 이렇게 하면 applications을 사용하여 삭제된 앱을 포함한 앱이 제거되지 않습니다.
statusBarDisabled
(deprecated)

boolean

상태 표시줄이 사용 중지되었는지 여부입니다. 이렇게 하면 전체 화면 모드에서 나갈 수 있는 알림, 빠른 설정, 기타 화면 오버레이가 사용 중지됩니다. DEPRECATED. 키오스크 기기에서 상태 표시줄을 사용 중지하려면 InstallType KIOSK 또는 kioskCustomLauncherEnabled를 사용합니다.
keyguardDisabled

boolean

true인 경우 기본 및/또는 보조 디스플레이의 잠금 화면이 사용 중지됩니다. 이 정책은 전용 기기 관리 모드에서만 지원됩니다.
minimumApiLevel

integer

허용되는 최소 Android API 수준입니다.
statusReportingSettings

object (StatusReportingSettings)

상태 보고 설정
bluetoothContactSharingDisabled

boolean

블루투스 연락처 공유가 사용 중지되었는지 여부입니다.
shortSupportMessage

object (UserFacingMessage)

관리자가 기능을 사용 중지한 설정 화면에 사용자에게 표시되는 메시지입니다. 메시지가 200자를 초과하면 잘릴 수 있습니다.
longSupportMessage

object (UserFacingMessage)

기기 관리자 설정 화면에 사용자에게 표시되는 메시지입니다.
passwordRequirements
(deprecated)

object (PasswordRequirements)

비밀번호 요구사항 passwordRequirements.require_password_unlock 필드는 설정하면 안 됩니다. 지원 중단됨 - passwordPolicies를 사용하세요.

참고:

여기서는 복잡성 기반 PasswordQuality 값(COMPLEXITY_LOW, COMPLEXITY_MEDIUM, COMPLEXITY_HIGH)을 사용할 수 없습니다. 여기에서는 unifiedLockSettings을 사용할 수 없습니다.
wifiConfigsLockdownEnabled
(deprecated)

boolean

이 기능은 지원 중단되었습니다.
bluetoothConfigDisabled

boolean

블루투스 구성이 사용 중지되었는지 여부입니다.
cellBroadcastsConfigDisabled

boolean

셀 브로드캐스트 구성이 사용 중지되었는지 여부입니다.
credentialsConfigDisabled

boolean

사용자 인증 정보 구성이 사용 중지되었는지 여부입니다.
mobileNetworksConfigDisabled

boolean

모바일 네트워크 구성이 사용 중지되었는지 여부입니다.
tetheringConfigDisabled
(deprecated)

boolean

테더링 및 휴대용 핫스팟 구성이 사용 중지되었는지 여부입니다. tetheringSettings이 TETHERING_SETTINGS_UNSPECIFIED 이외의 값으로 설정되면 이 설정이 무시됩니다.
vpnConfigDisabled

boolean

VPN 구성이 사용 중지되었는지 여부입니다.
wifiConfigDisabled
(deprecated)

boolean

Wi-Fi 네트워크 구성이 사용 중지되었는지 여부입니다. 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다. 완전 관리형 기기의 경우 이 값을 true로 설정하면 구성된 모든 네트워크가 삭제되고 openNetworkConfiguration를 사용하여 구성된 네트워크만 유지됩니다. 회사 소유 기기의 직장 프로필의 경우 기존에 구성된 네트워크는 영향을 받지 않으며 사용자는 Wi-Fi 네트워크를 추가, 삭제 또는 수정할 수 없습니다. configureWifi이 CONFIGURE_WIFI_UNSPECIFIED 이외의 값으로 설정되면 이 설정이 무시됩니다. 참고: 부팅 시 네트워크 연결을 할 수 없고 Wi-Fi 구성이 사용 중지된 경우 기기 정책을 새로고침하기 위해 네트워크 비상구가 표시됩니다 (networkEscapeHatchEnabled 참고).
createWindowsDisabled

boolean

앱 창 외 창 생성이 사용 중지되었는지 여부
networkResetDisabled

boolean

네트워크 설정 재설정이 사용 중지되었는지 여부입니다.
outgoingBeamDisabled

boolean

NFC를 사용하여 앱에서 데이터를 전송하는 기능이 사용 중지되었는지 여부입니다.
outgoingCallsDisabled

boolean

발신 통화가 사용 중지되었는지 여부입니다.
removeUserDisabled

boolean

다른 사용자 삭제가 사용 중지되었는지 여부입니다.
shareLocationDisabled

boolean

위치 공유가 사용 중지되었는지 여부입니다. shareLocationDisabled는 완전 관리형 기기와 개인 소유 직장 프로필 모두에서 지원됩니다.
smsDisabled

boolean

SMS 메시지 전송 및 수신이 사용 중지되었는지 여부입니다.
unmuteMicrophoneDisabled
(deprecated)

boolean

microphoneAccess이 MICROPHONE_ACCESS_UNSPECIFIED 이외의 값으로 설정된 경우 아무런 효과가 없습니다. 그렇지 않으면 이 필드는 마이크가 사용 중지되는지 여부를 제어합니다. true이면 모든 마이크가 사용 중지되고, 그렇지 않으면 마이크를 사용할 수 있습니다. 이 기능은 완전 관리형 기기에서만 사용할 수 있습니다.
usbFileTransferDisabled
(deprecated)

boolean

USB를 통한 파일 전송이 사용 중지되었는지 여부입니다. 이 기능은 회사 소유 기기에서만 지원됩니다.
ensureVerifyAppsEnabled
(deprecated)

boolean

앱 인증이 강제 사용 설정되었는지 여부입니다.
permittedInputMethods

object (PackageNameList)

있는 경우 이 목록의 패키지에서 제공하는 입력 방법만 허용됩니다. 이 필드가 있지만 목록이 비어 있으면 시스템 입력 방법만 허용됩니다.
stayOnPluggedModes[]

enum (BatteryPluggedMode)

기기가 켜져 있는 배터리 플러그인 모드입니다. 이 설정을 사용할 때는 기기가 켜져 있는 동안 자동으로 잠기지 않도록 maximumTimeToLock를 지우는 것이 좋습니다.
recommendedGlobalProxy

object (ProxyInfo)

네트워크 독립적인 전역 HTTP 프록시입니다. 일반적으로 프록시는 openNetworkConfiguration에서 네트워크별로 구성해야 합니다. 하지만 일반적인 내부 필터링과 같은 비정상적인 구성의 경우 전역 HTTP 프록시가 유용할 수 있습니다. 프록시에 액세스할 수 없으면 네트워크 액세스가 중단될 수 있습니다. 전역 프록시는 권장사항일 뿐이며 일부 앱에서는 이를 무시할 수 있습니다.
setUserIconDisabled

boolean

사용자 아이콘 변경이 사용 중지되었는지 여부입니다. 이 설정은 완전 관리형 기기에만 적용됩니다.
setWallpaperDisabled

boolean

배경화면 변경이 사용 중지되었는지 여부입니다.
choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

비공개 키에 대한 앱의 액세스를 결정하는 규칙입니다. 자세한 내용은 ChoosePrivateKeyRule을 참조하세요. 애플리케이션에 CERT_SELECTION 위임 범위가 있는 경우 비워 두어야 합니다.
alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

연결 유지 VPN 연결 구성입니다. 이 설정의 수정을 방지하려면 vpnConfigDisabled와 함께 사용하세요.
frpAdminEmails[]

string

초기화 보호를 위한 기기 관리자의 이메일 주소입니다. 기기가 초기화되면 이러한 관리자 중 한 명이 Google 계정 이메일과 비밀번호로 로그인하여 기기를 잠금 해제해야 합니다. 관리자가 지정되지 않으면 기기에서 초기화 보호 기능을 제공하지 않습니다.
deviceOwnerLockScreenInfo

object (UserFacingMessage)

잠금 화면에 표시할 기기 소유자 정보입니다.
dataRoamingDisabled

boolean

로밍 데이터 서비스가 사용 중지되었는지 여부입니다.
locationMode

enum (LocationMode)

위치 감지가 사용 설정된 정도입니다.
networkEscapeHatchEnabled

boolean

네트워크 비상구가 사용 설정되어 있는지 여부입니다. 부팅 시 네트워크 연결을 설정할 수 없는 경우 이스케이프 해치는 사용자에게 기기 정책을 새로고침하기 위해 일시적으로 네트워크에 연결하라는 메시지를 표시합니다. 정책을 적용한 후 임시 네트워크가 삭제되고 기기가 계속 부팅됩니다. 이렇게 하면 마지막 정책에 적합한 네트워크가 없고 기기가 잠금 작업 모드의 앱으로 부팅되거나 사용자가 기기 설정에 액세스할 수 없는 경우 네트워크에 연결할 수 없게 되는 것을 방지할 수 있습니다.

참고: 특정 상황에서는 wifiConfigDisabled을 true로 설정하면 이 설정이 재정의됩니다. 자세한 내용은 wifiConfigDisabled를 참고하세요. configureWifi을 DISALLOW_CONFIGURING_WIFI로 설정하면 특정 상황에서 이 설정이 재정의됩니다. 자세한 내용은 DISALLOW_CONFIGURING_WIFI를 참고하세요.
bluetoothDisabled

boolean

블루투스가 사용 중지되었는지 여부입니다. bluetoothConfigDisabled는 사용자가 우회할 수 있으므로 이 설정을 사용하는 것이 좋습니다.bluetoothConfigDisabled
complianceRules[]
(deprecated)

object (ComplianceRule)

기기가 정책을 준수하지 않을 때 취해야 하는 완화 조치를 선언하는 규칙입니다. 여러 규칙의 조건이 충족되면 규칙의 모든 완화 조치가 취해집니다. 최대 100개의 규칙을 만들 수 있습니다. 대신 정책 시행 규칙을 사용하세요.
blockApplicationsEnabled
(deprecated)

boolean

applications에 구성된 애플리케이션 외의 애플리케이션이 설치되지 않도록 차단되는지 여부입니다. 설정하면 이전 정책에 따라 설치되었지만 더 이상 정책에 표시되지 않는 애플리케이션이 자동으로 제거됩니다.
installUnknownSourcesAllowed
(deprecated)

boolean

이 필드는 아무 영향도 미치지 않습니다.
debuggingFeaturesAllowed
(deprecated)

boolean

사용자가 디버깅 기능을 사용 설정할 수 있는지 여부입니다.
funDisabled

boolean

사용자가 재미를 느낄 수 있는지 여부입니다. 설정의 이스터 에그 게임을 사용 중지할지 여부를 제어합니다.
autoTimeRequired
(deprecated)

boolean

자동 시간이 필요한지 여부입니다. 자동 시간이 필요한 경우 사용자가 날짜와 시간을 수동으로 설정할 수 없습니다. autoDateAndTimeZone이 설정된 경우 이 필드는 무시됩니다.
permittedAccessibilityServices

object (PackageNameList)

허용된 접근성 서비스를 지정합니다. 필드가 설정되지 않은 경우 모든 접근성 서비스를 사용할 수 있습니다. 필드가 설정된 경우 이 목록의 접근성 서비스와 시스템의 기본 제공 접근성 서비스만 사용할 수 있습니다. 특히 필드가 비어 있는 경우 시스템의 내장 접근성 서비스만 사용할 수 있습니다. 이 설정은 완전 관리형 기기와 직장 프로필에서 설정할 수 있습니다. 직장 프로필에 적용하면 개인 프로필과 직장 프로필 모두에 영향을 미칩니다.
appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

권장되는 대안: 앱별로 설정되는 autoUpdateMode는 업데이트 빈도에 관해 더 큰 유연성을 제공합니다.

autoUpdateMode이 AUTO_UPDATE_POSTPONED 또는 AUTO_UPDATE_HIGH_PRIORITY로 설정된 경우 이 필드는 효과가 없습니다.

앱 자동 업데이트 정책으로, 자동 앱 업데이트가 적용될 수 있는 시점을 제어합니다.
kioskCustomLauncherEnabled

boolean

키오스크 맞춤 런처가 사용 설정되어 있는지 여부입니다. 이렇게 하면 홈 화면이 applications 설정을 통해 설치된 앱으로 기기를 잠그는 런처로 대체됩니다. 앱은 단일 페이지에 알파벳순으로 표시됩니다. kioskCustomization을 사용하여 키오스크 기기 동작을 추가로 구성합니다.
androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

이 설정은 지원되지 않습니다. 모든 값이 무시됩니다.
skipFirstUseHintsEnabled

boolean

첫 사용 시 힌트를 건너뛰는 플래그 엔터프라이즈 관리자는 앱의 시스템 추천을 사용 설정하여 첫 번째 시작 시 사용자 튜토리얼 및 기타 소개 힌트를 건너뛸 수 있습니다.
privateKeySelectionEnabled

boolean

ChoosePrivateKeyRules에 일치하는 규칙이 없는 경우 사용자가 비공개 키 별칭을 선택할 수 있도록 기기에 UI를 표시할 수 있습니다. Android P 미만 기기의 경우 이 설정을 사용하면 엔터프라이즈 키가 취약해질 수 있습니다. 애플리케이션에 CERT_SELECTION 위임 범위가 있으면 이 값은 아무런 영향을 미치지 않습니다.
encryptionPolicy

enum (EncryptionPolicy)

암호화 사용 설정 여부
usbMassStorageEnabled
(deprecated)

boolean

USB 저장소가 사용 설정되어 있는지 여부입니다. 지원 중단되었습니다.
permissionGrants[]

object (PermissionGrant)

모든 앱에 대한 명시적 권한 또는 그룹 부여 또는 거부입니다. 이러한 값은 defaultPermissionPolicy를 재정의합니다.
playStoreMode

enum (PlayStoreMode)

이 모드는 Play 스토어에서 사용자에게 제공되는 앱과 정책에서 앱이 삭제될 때 기기에서 발생하는 동작을 관리합니다.
setupActions[]

object (SetupAction)

설정 과정에서 취할 작업입니다. 작업은 최대 하나만 지정할 수 있습니다.
passwordPolicies[]

object (PasswordRequirements)

비밀번호 요구사항 정책입니다. 정책에서 passwordScope 필드를 설정하여 직장 프로필 또는 완전 관리형 기기에 대해 다른 정책을 설정할 수 있습니다.
policyEnforcementRules[]

object (PolicyEnforcementRule)

특정 정책을 기기에 적용할 수 없는 경우의 동작을 정의하는 규칙
kioskCustomization

object (KioskCustomization)

키오스크 모드에서 기기의 동작을 제어하는 설정입니다. 키오스크 모드를 사용 설정하려면 kioskCustomLauncherEnabled을 true로 설정하거나 installType KIOSK로 정책에서 앱을 지정합니다.
advancedSecurityOverrides

object (AdvancedSecurityOverrides)

고급 보안 설정 대부분의 경우 이러한 설정을 지정할 필요가 없습니다.
personalUsagePolicies

object (PersonalUsagePolicies)

회사 소유 기기에서 개인 사용을 관리하는 정책입니다.
autoDateAndTimeZone

enum (AutoDateAndTimeZone)

회사 소유 기기에서 날짜, 시간, 시간대 자동 설정이 사용 설정되었는지 여부 이 값이 설정되면 autoTimeRequired이 무시됩니다.
oncCertificateProviders[]

object (OncCertificateProvider)

이 기능은 정식 버전이 아닙니다.
crossProfilePolicies

object (CrossProfilePolicies)

기기에 적용된 교차 프로필 정책입니다.
preferentialNetworkService

enum (PreferentialNetworkService)

직장 프로필 또는 완전 관리형 기기에서 우선 네트워크 서비스가 사용 설정되는지 여부를 제어합니다. 예를 들어 조직은 직원 기기의 모든 업무 데이터가 엔터프라이즈 전용 네트워크 서비스를 통해 전송된다는 이동통신사와의 계약을 체결할 수 있습니다. 지원되는 우선 설정 네트워크 서비스의 예는 5G 네트워크의 엔터프라이즈 슬라이스입니다. Android 13 이상을 실행하는 기기에서 preferentialNetworkServiceSettings 또는 ApplicationPolicy.preferentialNetworkId이 설정된 경우 이 정책은 아무런 영향을 미치지 않습니다.
usageLog

object (UsageLog)

기기 활동 로깅 구성입니다.
cameraAccess

enum (CameraAccess)

카메라 사용 여부와 사용자가 카메라 액세스 전환 버튼에 액세스할 수 있는지 여부를 제어합니다.
microphoneAccess

enum (MicrophoneAccess)

마이크 사용 여부와 사용자가 마이크 액세스 전환 버튼에 액세스할 수 있는지 여부를 제어합니다. 이는 완전 관리형 기기에만 적용됩니다.
deviceConnectivityManagement

object (DeviceConnectivityManagement)

Wi-Fi, USB 데이터 액세스, 키보드/마우스 연결 등 기기 연결 제어를 다룹니다.
deviceRadioState

object (DeviceRadioState)

Wi-Fi, 블루투스 등 무선 상태 제어를 다룹니다.
credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Android 14 이상에서 사용자 인증 정보 제공업체로 작동할 수 있는 앱을 제어합니다. 이러한 앱은 사용자 인증 정보를 저장합니다. 자세한 내용은 이 페이지와 이 페이지를 참고하세요. credentialProviderPolicy도 참고하세요.
printingPolicy

enum (PrintingPolicy)

선택사항입니다. 인쇄 허용 여부를 제어합니다. 이 기능은 Android 9 이상을 실행하는 기기에서 지원됩니다. .
displaySettings

object (DisplaySettings)

선택사항입니다. 디스플레이 설정 컨트롤입니다.
assistContentPolicy

enum (AssistContentPolicy)

선택사항입니다. AssistContent를 어시스턴트 앱과 같은 권한이 있는 앱에 전송할 수 있는지 제어합니다. AssistContent에는 스크린샷과 패키지 이름과 같은 앱 정보가 포함됩니다. 이 기능은 Android 15 이상에서 지원됩니다.
workAccountSetupConfig

object (WorkAccountSetupConfig)

선택사항입니다. Google 인증 계정이 필요한지 여부와 같은 직장 계정 설정 구성을 제어합니다.
wipeDataFlags[]

enum (WipeDataFlag)

선택사항입니다. 기기 또는 프로필 삭제가 어떤 이유 (예: 규정 미준수)로 인해 트리거될 때 삭제되는 데이터를 나타내는 플래그를 삭제합니다. enterprises.devices.delete 메서드에는 적용되지 않습니다. . 이 목록에는 중복 항목이 없어야 합니다.
enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

선택사항입니다. enterpriseDisplayName이 기기에 표시되는지 여부를 제어합니다 (예: 회사 소유 기기의 잠금 화면 메시지).
appFunctions

enum (AppFunctions)

선택사항입니다. 완전 관리형 기기의 앱 또는 직장 프로필이 있는 기기의 직장 프로필에 있는 앱이 앱 기능을 노출하도록 허용할지 여부를 제어합니다.

ApplicationPolicy

개별 앱에 대한 정책입니다. 참고: installAppsDisabled이 사용 설정된 경우 이 정책을 사용하여 특정 기기에서 애플리케이션의 사용 가능 여부를 변경할 수 없습니다. 정책별로 지정할 수 있는 최대 애플리케이션 수는 3,000개입니다.

JSON 표현 
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId)
}
필드
packageName

string

앱의 패키지 이름입니다. 예를 들어 YouTube 앱의 경우 com.google.android.youtube입니다.
installType

enum (InstallType)

실행할 설치 유형입니다.
lockTaskAllowed
(deprecated)

boolean

앱이 전체 화면 모드로 자체적으로 잠글 수 있는지 여부입니다. DEPRECATED. InstallType KIOSK 또는 kioskCustomLauncherEnabled를 사용하여 전용 기기를 구성합니다.
defaultPermissionPolicy

enum (PermissionPolicy)

앱에서 요청한 모든 권한의 기본 정책입니다. 지정된 경우 모든 앱에 적용되는 정책 수준 defaultPermissionPolicy을 재정의합니다. 모든 앱에 적용되는 permissionGrants를 재정의하지 않습니다.
permissionGrants[]

object (PermissionGrant)

앱에 대한 명시적 권한 부여 또는 거부입니다. 이러한 값은 모든 앱에 적용되는 defaultPermissionPolicy 및 permissionGrants를 재정의합니다.
managedConfiguration

object (Struct format)

앱에 적용된 관리 구성입니다. 구성 형식은 앱에서 지원하는 ManagedProperty 값에 따라 결정됩니다. 관리 구성의 각 필드 이름은 ManagedProperty의 key 필드와 일치해야 합니다. 필드 값은 ManagedProperty의 type과 호환되어야 합니다.

typeJSON 값
BOOLtrue 또는 false
STRING문자열
INTEGER숫자
CHOICE문자열
MULTISELECT문자열 배열
HIDDEN문자열
BUNDLE_ARRAY객체 배열
disabled

boolean

앱이 사용 중지되었는지 여부입니다. 사용 중지해도 앱 데이터는 보존됩니다.
minimumVersionCode

integer

기기에서 실행되는 앱의 최소 버전입니다. 설정된 경우 기기에서 앱을 최소한 이 버전 코드로 업데이트하려고 시도합니다. 앱이 최신 상태가 아닌 경우 기기에는 nonComplianceReason이 APP_NOT_UPDATED로 설정된 NonComplianceDetail이 포함됩니다. 앱이 이미 이 값보다 크거나 같은 버전 코드로 Google Play에 게시되어 있어야 합니다. 정책당 최대 20개의 앱이 최소 버전 코드를 지정할 수 있습니다.
delegatedScopes[]

enum (DelegatedScope)

Android Device Policy에서 앱에 위임된 범위입니다. 이러한 권한은 적용된 애플리케이션에 추가 권한을 제공합니다.
managedConfigurationTemplate

object (ManagedConfigurationTemplate)

관리 구성 iframe에서 저장된 앱의 관리 구성 템플릿입니다. managedConfiguration이 설정된 경우 이 필드는 무시됩니다.
accessibleTrackIds[]

string

기업에 속한 기기가 액세스할 수 있는 앱의 트랙 ID 목록입니다. 목록에 트랙 ID가 여러 개 포함된 경우 기기는 액세스 가능한 모든 트랙 중 최신 버전을 수신합니다. 목록에 트랙 ID가 포함되지 않은 경우 기기는 앱의 프로덕션 트랙에만 액세스할 수 있습니다. 각 트랙에 대한 자세한 내용은 AppTrackInfo를 참고하세요.
connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

사용자 동의에 따라 앱이 기기의 직장 및 개인 프로필 간에 자체적으로 통신할 수 있는지 여부를 제어합니다.
autoUpdateMode

enum (AutoUpdateMode)

앱의 자동 업데이트 모드를 제어합니다.
extensionConfig

object (ExtensionConfig)

이 앱을 오프라인에서 Android 기기 정책과 상호작용할 수 있는 확장 프로그램 앱으로 사용 설정하는 구성입니다.

이 필드는 최대 하나의 앱에 설정할 수 있습니다.

기기에 있는 앱의 서명 키 인증서 지문이 signingKeyFingerprintsSha256의 항목 중 하나와 일치하거나 Play 스토어에서 가져온 서명 키 인증서 지문과 일치해야 앱이 Android Device Policy와 통신할 수 있습니다. 앱이 Play 스토어에 없고 signingKeyFingerprintsSha256가 설정되지 않은 경우 INVALID_VALUE가 있는 NonComplianceDetail가 보고됩니다.
alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

VPN이 연결되지 않고 alwaysOnVpnPackage.lockdownEnabled이 사용 설정된 경우 앱의 네트워킹이 허용되는지 여부를 지정합니다. VPN_LOCKDOWN_ENFORCED로 설정하면 앱의 네트워킹이 허용되지 않고 VPN_LOCKDOWN_EXEMPTION로 설정하면 앱의 네트워킹이 허용됩니다. Android 10 이상을 실행하는 기기에서만 지원됩니다. 기기에서 이를 지원하지 않으면 기기에는 nonComplianceReason이 API_LEVEL로 설정된 NonComplianceDetail와 fieldPath가 포함됩니다. 앱에 적용되지 않는 경우 기기에는 nonComplianceReason이 UNSUPPORTED로 설정된 NonComplianceDetail과 fieldPath가 포함됩니다. fieldPath는 applications[i].alwaysOnVpnLockdownExemption로 설정됩니다. 여기서 i은 applications 정책의 패키지 색인입니다.
workProfileWidgets

enum (WorkProfileWidgets)

직장 프로필에 설치된 앱이 홈 화면에 위젯을 추가할 수 있는지 여부를 지정합니다.
credentialProviderPolicy

enum (CredentialProviderPolicy)

선택사항입니다. 앱이 Android 14 이상에서 사용자 인증 정보 제공자 역할을 할 수 있는지 여부입니다.
installConstraint[]

object (InstallConstraint)

선택사항입니다. 앱 설치에 관한 제약 조건입니다. 최대 하나의 InstallConstraint을 지정할 수 있습니다. 여러 제약 조건은 거부됩니다.
installPriority

integer

선택사항입니다. installType이 다음으로 설정된 앱 중에서

이는 설치의 상대적 우선순위를 제어합니다. 값 0 (기본값)은 이 앱이 다른 앱보다 우선순위가 없음을 의미합니다. 1~10,000 사이의 값의 경우 값이 작을수록 우선순위가 높습니다. 0~10,000 범위(포함)를 벗어나는 값은 거부됩니다.
userControlSettings

enum (UserControlSettings)

선택사항입니다. 앱에 사용자 제어가 허용되는지 지정합니다. 사용자 제어에는 강제 종료 및 앱 데이터 삭제와 같은 사용자 작업이 포함됩니다. 특정 유형의 앱은 특별한 처리가 적용됩니다. 자세한 내용은 USER_CONTROL_SETTINGS_UNSPECIFIED 및 USER_CONTROL_ALLOWED를 참고하세요.
preferentialNetworkId

enum (PreferentialNetworkId)

선택사항입니다. 애플리케이션이 사용하는 우선 네트워크의 ID입니다. preferentialNetworkServiceConfigs에 지정된 네트워크 ID의 구성이 있어야 합니다. PREFERENTIAL_NETWORK_ID_UNSPECIFIED로 설정하면 애플리케이션이 defaultPreferentialNetworkId에 지정된 기본 네트워크 ID를 사용합니다. 이 기본값에서 제외된 앱 목록은 defaultPreferentialNetworkId 문서를 참고하세요. 이는 Android 13 이상의 직장 프로필과 완전 관리형 기기에 적용됩니다.

InstallType

앱에 실행할 설치 유형입니다. setupAction이 앱을 참조하는 경우 installType이 REQUIRED_FOR_SETUP로 설정되어 있어야 합니다. 그렇지 않으면 설정이 실패합니다.

열거형
INSTALL_TYPE_UNSPECIFIED 지정되지 않음. 기본값은 AVAILABLE입니다.
PREINSTALLED 앱이 자동으로 설치되며 사용자가 삭제할 수 있습니다.
FORCE_INSTALLED 앱은 설정된 유지관리 기간과 관계없이 자동으로 설치되며 사용자가 삭제할 수 없습니다.
BLOCKED 앱이 차단되어 설치할 수 없습니다. 이전 정책에서 앱이 설치된 경우 제거됩니다. 또한 인스턴트 앱 기능도 차단됩니다.
AVAILABLE 앱을 설치할 수 있습니다.
REQUIRED_FOR_SETUP 앱이 자동으로 설치되며 사용자가 삭제할 수 없습니다. 설치가 완료될 때까지 설정이 완료되지 않습니다.
KIOSK 앱이 키오스크 모드에 자동으로 설치됩니다. 선호하는 홈 인텐트로 설정되고 잠금 작업 모드에 대해 허용 목록에 추가됩니다. 앱이 설치될 때까지 기기 설정이 완료되지 않습니다. 설치 후에는 사용자가 앱을 삭제할 수 없습니다. 정책당 하나의 앱에만 이 installType를 설정할 수 있습니다. 정책에 이 값이 있으면 상태 표시줄이 자동으로 사용 중지됩니다.

PermissionPolicy

앱에 대한 권한 요청을 승인하기 위한 정책입니다.

열거형
PERMISSION_POLICY_UNSPECIFIED 정책이 지정되지 않았습니다. 어느 수준에서든지 권한에 지정된 정책이 없으면 기본적으로 PROMPT 동작이 사용됩니다.
PROMPT 사용자에게 권한을 부여하도록 요청합니다.
GRANT

권한을 자동으로 부여합니다.

Android 12 이상에서는 READ_SMS 및 다음 센서 관련 권한이 완전 관리 기기에만 부여될 수 있습니다.
DENY 권한을 자동으로 거부합니다.

PermissionGrant

Android 권한 및 부여 상태의 구성입니다.

JSON 표현 
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
필드
permission

string

Android 권한 또는 그룹(예: android.permission.READ_CALENDAR 또는 android.permission_group.CALENDAR)
policy

enum (PermissionPolicy)

권한을 부여하는 정책입니다.

DelegatedScope

다른 패키지가 Android 기기 정책에서 획득할 수 있는 위임 범위입니다. 이러한 권한은 적용된 애플리케이션에 추가 권한을 제공합니다.

열거형
DELEGATED_SCOPE_UNSPECIFIED 위임 범위가 지정되지 않았습니다.
CERT_INSTALL 인증서 설치 및 관리에 대한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
MANAGED_CONFIGURATIONS 관리 구성 관리에 대한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
BLOCK_UNINSTALL 제거 차단에 대한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
PERMISSION_GRANT 권한 정책 및 권한 부여 상태에 대한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
PACKAGE_ACCESS 패키지 액세스 상태에 대한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
ENABLE_SYSTEM_APP 시스템 앱을 사용 설정하기 위한 액세스 권한을 부여합니다. 이 범위는 여러 애플리케이션에 위임할 수 있습니다.
NETWORK_ACTIVITY_LOGS 네트워크 활동 로그에 대한 액세스 권한을 부여합니다. 위임된 애플리케이션이 setNetworkLoggingEnabled, isNetworkLoggingEnabled, retrieveNetworkLogs 메서드를 호출하도록 허용합니다. 이 범위는 최대 하나의 애플리케이션에 위임할 수 있습니다. Android 10 이상을 실행하는 완전 관리 기기에서 지원됩니다. Android 12 이상의 직장 프로필에서 지원됩니다. 위임이 지원되고 설정된 경우 NETWORK_ACTIVITY_LOGS가 무시됩니다.
SECURITY_LOGS 보안 로그에 대한 액세스 권한을 부여합니다. 위임된 애플리케이션이 setSecurityLoggingEnabled, isSecurityLoggingEnabled, retrieveSecurityLogs, retrievePreRebootSecurityLogs 메서드를 호출할 수 있습니다. 이 범위는 최대 하나의 애플리케이션에 위임할 수 있습니다. Android 12 이상에서 완전 관리형 기기 및 직장 프로필이 있는 회사 소유 기기에서 지원됩니다. 위임이 지원되고 설정된 경우 SECURITY_LOGS가 무시됩니다.
CERT_SELECTION 요청 앱을 대신하여 KeyChain 인증서 선택에 대한 액세스 권한을 부여합니다. 권한이 부여되면 위임된 애플리케이션이 DelegatedAdminReceiver#onChoosePrivateKeyAlias를 수신하기 시작합니다. 위임된 애플리케이션이 grantKeyPairToApp 및 revokeKeyPairFromApp 메서드를 호출하도록 허용합니다. 이 범위는 최대 하나의 애플리케이션에 위임할 수 있습니다. 인증서 선택이 애플리케이션에 위임된 경우 choosePrivateKeyRules은 비어 있어야 하며 privateKeySelectionEnabled은 영향을 미치지 않습니다.

ManagedConfigurationTemplate

관리 구성 iframe에서 저장된 앱의 관리 구성 템플릿입니다.

JSON 표현 
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
필드
templateId

string

관리 구성 템플릿의 ID입니다.
configurationVariables

map (key: string, value: string)

선택사항입니다. 구성에 정의된 <키, 값> 구성 변수가 포함된 맵입니다.

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

ConnectedWorkAndPersonalApp

사용자 동의에 따라 앱이 프로필 간에 자체적으로 통신할 수 있는지 제어합니다.

열거형
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED 지정되지 않음. 기본값은 CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED입니다.
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED 기본값입니다. 앱이 프로필 간에 통신하는 것을 방지합니다.
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED 사용자 동의를 받은 후 앱이 프로필 간에 통신하도록 허용합니다.

AutoUpdateMode

앱의 자동 업데이트 모드를 제어합니다. 기기 사용자가 기기 설정을 수동으로 변경하면 AutoUpdateMode가 우선하므로 이러한 선택사항은 무시됩니다.

열거형
AUTO_UPDATE_MODE_UNSPECIFIED 지정되지 않음. 기본값은 AUTO_UPDATE_DEFAULT입니다.
AUTO_UPDATE_DEFAULT

기본 업데이트 모드입니다.

앱은 사용자에게 미치는 영향을 최소화하기 위해 낮은 우선순위로 자동 업데이트됩니다.

다음 제약 조건이 모두 충족되면 앱이 업데이트됩니다.

  • 기기가 적극적으로 사용되지 않습니다.
  • 기기가 무제한 네트워크에 연결되어 있습니다.
  • 기기가 충전 중입니다.
  • 업데이트할 앱이 포그라운드에서 실행되고 있지 않음

개발자가 게시한 후 24시간 이내에 기기에 새 업데이트에 대한 알림이 전송되며, 다음번에 위 제약 조건이 충족되었을 때 앱이 업데이트됩니다.
AUTO_UPDATE_POSTPONED

앱의 최신 버전이 출시된 후 최대 90일 동안 앱이 자동으로 업데이트되지 않습니다.

앱의 최신 버전이 출시된 후 90일이 지나면 사용 가능한 최신 버전이 낮은 우선순위로 자동 설치됩니다 (AUTO_UPDATE_DEFAULT 참고). 앱이 업데이트된 후에는 앱의 또 다른 최신 버전이 출시된 후 90일 동안 다시 자동 업데이트되지 않습니다.

사용자는 언제든지 Play 스토어에서 앱을 수동으로 업데이트할 수 있습니다.
AUTO_UPDATE_HIGH_PRIORITY

앱이 최대한 빨리 업데이트됩니다. 제약 조건이 적용되지 않습니다.

새 업데이트가 제공되면 기기에 최대한 빨리 알림이 전송됩니다.

참고: Android 생태계 전반에 걸쳐 대규모로 배포된 앱의 업데이트는 최대 24시간이 걸릴 수 있습니다.

ExtensionConfig

앱을 오프라인에서 Android Device Policy와 상호작용할 수 있는 확장 프로그램 앱으로 사용 설정하는 구성 Android 버전 11 이상에서는 확장 프로그램 앱이 배터리 제한에서 제외되므로 제한된 앱 대기 버킷에 배치되지 않습니다. 확장 프로그램 앱은 사용자가 데이터를 삭제하거나 애플리케이션을 강제 종료하는 것으로부터도 보호됩니다. 단, 관리자는 Android 11 이상의 경우 필요한 경우 확장 프로그램 앱에서 clear app data command를 계속 사용할 수 있습니다.

JSON 표현 
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
필드
signingKeyFingerprintsSha256[]

string

확장 프로그램 앱의 서명 키 인증서의 16진수 인코딩된 SHA-256 해시입니다. 64자리의 16진수 문자열 표현만 유효합니다.

서명 키 인증서 디지털 지문은 항상 Play 스토어에서 가져오며 이 필드는 추가 서명 키 인증서 디지털 지문을 제공하는 데 사용됩니다. 하지만 애플리케이션이 Play 스토어에서 제공되지 않는 경우 이 필드를 설정해야 합니다. Play 스토어에서 애플리케이션을 사용할 수 없는 경우 이 필드가 설정되지 않으면 INVALID_VALUE이 있는 NonComplianceDetail가 보고됩니다.

기기의 확장 프로그램 앱의 서명 키 인증서 지문이 Play 스토어에서 가져온 서명 키 인증서 지문 중 하나와 일치하거나 이 필드에 제공된 지문과 일치해야 앱이 Android 기기 정책과 통신할 수 있습니다.

프로덕션 사용 사례에서는 이 값을 비워 두는 것이 좋습니다.
notificationReceiver

string

확장 프로그램 앱에 로컬 명령 상태 업데이트를 알리는 Android 기기 정책의 수신기 서비스 클래스의 정규화된 클래스 이름입니다. 서비스는 확장 프로그램 앱의 AndroidManifest.xml에서 내보내야 하며 NotificationReceiverService를 확장해야 합니다 (자세한 내용은 AMAPI SDK와 통합 가이드 참고).

AlwaysOnVpnLockdownExemption

앱이 alwaysOnVpnPackage.lockdownEnabled 설정에서 제외되는지 여부를 제어합니다.

열거형
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED 지정되지 않음. 기본값은 VPN_LOCKDOWN_ENFORCED입니다.
VPN_LOCKDOWN_ENFORCED 앱은 VPN 상시 사용 설정 잠금 설정을 준수합니다.
VPN_LOCKDOWN_EXEMPTION 앱이 VPN 상시 사용 설정 잠금 설정에서 제외됩니다.

WorkProfileWidgets

직장 프로필 애플리케이션이 홈 화면에 위젯을 추가하도록 허용할지 여부를 제어합니다.

열거형
WORK_PROFILE_WIDGETS_UNSPECIFIED 지정되지 않음. 기본값은 workProfileWidgetsDefault입니다.
WORK_PROFILE_WIDGETS_ALLOWED 직장 프로필 위젯은 허용됩니다. 즉, 애플리케이션이 홈 화면에 위젯을 추가할 수 있습니다.
WORK_PROFILE_WIDGETS_DISALLOWED 직장 프로필 위젯은 허용되지 않습니다. 즉, 애플리케이션이 홈 화면에 위젯을 추가할 수 없습니다.

CredentialProviderPolicy

앱이 Android 14 이상에서 사용자 인증 정보 제공자 역할을 할 수 있는지 여부입니다.

열거형
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED 지정되지 않음. 이 동작은 credentialProviderPolicyDefault에 의해 관리됩니다.
CREDENTIAL_PROVIDER_ALLOWED 앱이 사용자 인증 정보 제공자 역할을 할 수 있습니다.

InstallConstraint

InstallType이 다음으로 설정된 앱 중에서

이는 앱 설치에 대한 제한사항 집합을 정의합니다. 필드 중 하나 이상을 설정해야 합니다. 여러 필드가 설정된 경우 앱을 설치하려면 모든 제약 조건을 충족해야 합니다.

JSON 표현 
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
필드
networkTypeConstraint

enum (NetworkTypeConstraint)

선택사항입니다. 네트워크 유형 제약 조건입니다.
chargingConstraint

enum (ChargingConstraint)

선택사항입니다. 충전 제약 조건입니다.
deviceIdleConstraint

enum (DeviceIdleConstraint)

선택사항입니다. 기기 유휴 상태 제약 조건입니다.

NetworkTypeConstraint

네트워크 유형 제약 조건입니다.

열거형
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED 지정되지 않음. 기본값은 INSTALL_ON_ANY_NETWORK입니다.
INSTALL_ON_ANY_NETWORK 활성 네트워크 (Wi-Fi, 모바일 등)
INSTALL_ONLY_ON_UNMETERED_NETWORK 무제한 네트워크 (예: Wi-Fi)

ChargingConstraint

충전 제약 조건입니다.

열거형
CHARGING_CONSTRAINT_UNSPECIFIED 지정되지 않음. 기본값은 CHARGING_NOT_REQUIRED입니다.
CHARGING_NOT_REQUIRED 기기가 충전 중일 필요는 없습니다.
INSTALL_ONLY_WHEN_CHARGING 기기가 충전 중이어야 합니다.

DeviceIdleConstraint

기기 유휴 상태 제약 조건입니다.

열거형
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED 지정되지 않음. 기본값은 DEVICE_IDLE_NOT_REQUIRED입니다.
DEVICE_IDLE_NOT_REQUIRED 기기가 유휴 상태일 필요는 없습니다. 사용자가 기기와 상호작용하는 동안 앱을 설치할 수 있습니다.
INSTALL_ONLY_WHEN_DEVICE_IDLE 기기가 유휴 상태여야 합니다.

UserControlSettings

특정 앱에 사용자 제어가 허용되는지 지정합니다. 사용자 제어에는 강제 종료 및 앱 데이터 삭제와 같은 사용자 작업이 포함됩니다.

열거형
USER_CONTROL_SETTINGS_UNSPECIFIED

앱의 기본 동작을 사용하여 사용자 제어가 허용되는지 또는 허용되지 않는지 확인합니다. 사용자 제어는 대부분의 앱에서 기본적으로 허용되지만 다음 유형의 앱에서는 허용되지 않습니다.

  • 확장 프로그램 앱 (자세한 내용은 extensionConfig 참고)
  • 키오스크 앱 (자세한 내용은 KIOSK 설치 유형 참고)
  • 기타 중요한 시스템 앱
USER_CONTROL_ALLOWED 앱에 사용자 제어가 허용됩니다. 키오스크 앱은 이를 사용하여 사용자 제어를 허용할 수 있습니다. 확장 프로그램 앱 (자세한 내용은 extensionConfig 참고)의 경우 이 값이 설정되어 있어도 사용자 제어가 허용되지 않습니다. 키오스크 앱 (자세한 내용은 KIOSK 설치 유형 참고)의 경우 이 값을 사용하여 사용자 제어를 허용할 수 있습니다.
USER_CONTROL_DISALLOWED 앱에 사용자 제어가 허용되지 않습니다. Android 11 이상에서 지원됩니다. Android 버전이 11 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다.

PreferentialNetworkId

우선 네트워크 식별자입니다.

열거형
PREFERENTIAL_NETWORK_ID_UNSPECIFIED 이 값이 유효한지 여부와 그 의미는 사용되는 위치에 따라 다르며, 이는 관련 필드에 문서화되어 있습니다.
NO_PREFERENTIAL_NETWORK 애플리케이션이 우선 네트워크를 사용하지 않습니다.
PREFERENTIAL_NETWORK_ID_ONE 우선 네트워크 식별자 1입니다.
PREFERENTIAL_NETWORK_ID_TWO 우선 네트워크 식별자 2입니다.
PREFERENTIAL_NETWORK_ID_THREE 우선 네트워크 식별자 3입니다.
PREFERENTIAL_NETWORK_ID_FOUR 우선 네트워크 식별자 4.
PREFERENTIAL_NETWORK_ID_FIVE 우선 네트워크 식별자 5.

KeyguardDisabledFeature

사용 중지할 수 있는 Keyguard (잠금 화면) 기능

열거형
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED 이 값은 무시됩니다.
CAMERA 보안 키가드 화면 (예: PIN)에서 카메라를 사용 중지합니다.
NOTIFICATIONS 보안 키가드 화면에 모든 알림을 표시하는 것을 사용 중지
UNREDACTED_NOTIFICATIONS 보안 키가드 화면에서 수정되지 않은 알림을 사용 중지합니다.
TRUST_AGENTS 보안 Keyguard 화면에서 신뢰할 수 있는 에이전트 상태를 무시합니다.
DISABLE_FINGERPRINT 보안 키가드 화면에서 지문 센서 사용 중지
DISABLE_REMOTE_INPUT Android 6 이하를 실행하는 기기에서 보안 키가드 화면의 알림에 텍스트 입력을 사용 중지합니다. Android 7 이상에는 영향을 미치지 않습니다.
FACE 보안 키가드 화면에서 얼굴 인증을 사용 중지합니다.
IRIS 보안 키가드 화면에서 홍채 인증을 사용 중지합니다.
BIOMETRICS 보안 키가드 화면에서 모든 생체 인식 인증을 사용 중지합니다.
SHORTCUTS Android 14 이상에서 보안 키가드 화면의 모든 바로가기 사용 중지
ALL_FEATURES 현재 및 향후 모든 키가드 맞춤설정을 사용 중지합니다.

PersistentPreferredActivity

특정 인텐트 필터와 일치하는 인텐트를 처리하는 기본 활동입니다. 참고: 키오스크를 설정하려면 영구 기본 활동을 사용하는 대신 InstallType을 KIOSK로 사용하세요.

JSON 표현 
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
필드
receiverActivity

string

기본 인텐트 핸들러여야 하는 활동입니다. Android 구성요소 이름(예: com.android.enterprise.app/.MainActivity)이어야 합니다. 또는 값이 앱의 패키지 이름일 수 있으며, 이 경우 Android 기기 정책은 인텐트를 처리할 앱에서 적절한 활동을 선택합니다.
actions[]

string

필터에서 일치시킬 인텐트 작업입니다. 필터에 작업이 포함된 경우 인텐트의 작업이 일치하려면 해당 값 중 하나여야 합니다. 작업이 포함되지 않으면 인텐트 작업이 무시됩니다.
categories[]

string

필터에서 일치시킬 인텐트 카테고리입니다. 인텐트에는 필요한 카테고리가 포함되며, 일치하려면 이 카테고리가 모두 필터에 포함되어야 합니다. 즉, 인텐트에 해당 카테고리가 지정되지 않은 경우 필터에 카테고리를 추가해도 매칭에 영향을 미치지 않습니다.

SystemUpdate

시스템 업데이트 관리 구성

참고: Google Play 시스템 업데이트 (Mainline 업데이트라고도 함)는 자동으로 다운로드되지만 설치하려면 기기를 재부팅해야 합니다. 자세한 내용은 시스템 업데이트 관리의 Mainline 섹션을 참고하세요.

JSON 표현 
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
필드
type

enum (SystemUpdateType)

구성할 시스템 업데이트 유형입니다.
startMinutes

integer

유형이 WINDOWED인 경우 유지보수 기간의 시작 시간입니다. 기기의 현지 시간으로 자정 후 경과된 시간(분)으로 측정됩니다. 이 값은 0~1439 사이여야 합니다(0 및 1439 포함).
endMinutes

integer

유형이 WINDOWED인 경우 유지보수 기간의 종료 시간입니다. 기기의 현지 시간으로 자정 후 경과된 시간(분)으로 측정됩니다. 이 값은 0~1439 사이여야 합니다(0 및 1439 포함). 이 값이 startMinutes보다 작으면 유지보수 기간이 자정을 포함합니다. 지정된 유지보수 기간이 30분 미만이면 실제 기간은 시작 시간에서 30분으로 연장됩니다.
freezePeriods[]

object (FreezePeriod)

기기에서 실행되는 OS 버전을 고정하기 위해 무선 업데이트 (OTA) 시스템 업데이트가 연기되는 연간 반복 기간입니다. 기기가 무기한으로 정지되지 않도록 각 정지 기간은 최소 60일 간격으로 구분해야 합니다.

SystemUpdateType

시스템 업데이트 구성의 유형입니다.

열거형
SYSTEM_UPDATE_TYPE_UNSPECIFIED 기기의 기본 업데이트 동작을 따릅니다. 일반적으로 사용자가 시스템 업데이트를 수락해야 합니다.
AUTOMATIC 업데이트가 제공되면 즉시 자동으로 설치됩니다.
WINDOWED

일일 유지보수 기간 내에 자동으로 설치 또한 이 설정은 기간 내에 Play 앱이 업데이트되도록 구성합니다. 이는 포그라운드에 영구적으로 고정된 앱이 Play에 의해 업데이트될 수 있는 유일한 방법이므로 키오스크 기기에 적극 권장됩니다.

앱에 대해 autoUpdateMode이 AUTO_UPDATE_HIGH_PRIORITY로 설정된 경우 해당 앱의 유지보수 기간은 무시되며 유지보수 기간 외에도 최대한 빨리 업데이트됩니다.
POSTPONE 자동 설치를 최대 30일까지 연기합니다. 이 정책은 보안 업데이트 (예: 월별 보안 패치)에 영향을 미치지 않습니다.

FreezePeriod

시스템 고정 기간입니다. 기기의 시계가 정지 기간 내에 있으면 보안 패치를 포함한 모든 수신 시스템 업데이트가 차단되고 설치되지 않습니다.

설정된 정지 기간이 지난 경우 기기에 일반적인 정책 동작 (자동, 기간 설정 또는 연기됨)이 적용됩니다.

윤년은 고정 기간 계산에서 무시됩니다. 특히 다음 사항에 유의하세요.

  • 2월 29일이 고정 기간의 시작일 또는 종료일로 설정된 경우 고정 기간은 2월 28일에 시작되거나 종료됩니다.
  • 기기의 시스템 시계가 2월 29일로 표시되면 2월 28일로 처리됩니다.
  • 고정 기간의 일수 또는 두 고정 기간 사이의 시간을 계산할 때 2월 29일은 무시되며 일수로 계산되지 않습니다.

참고: 고정 기간이 적용되려면 정의된 정책을 지정해야 하므로 SystemUpdateType를 SYSTEM_UPDATE_TYPE_UNSPECIFIED로 지정할 수 없습니다.

JSON 표현 
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
필드
startDate

object (Date)

고정 기간의 시작일 (해당 날짜 포함)입니다. 참고: day 및 month를 설정해야 합니다. year은 사용되지 않으므로 설정하면 안 됩니다. 예를 들면 {"month": 1,"date": 30}입니다.
endDate

object (Date)

고정 기간의 종료일 (해당 날짜 포함)입니다. 시작일로부터 90일 이내여야 합니다. 종료일이 시작일보다 빠른 경우 고정 기간은 연말을 포함하는 것으로 간주됩니다. 참고: day 및 month를 설정해야 합니다. year은 사용되지 않으므로 설정하면 안 됩니다. 예를 들면 {"month": 1,"date": 30}입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

StatusReportingSettings

상태 보고서의 동작을 제어하는 설정입니다.

JSON 표현 
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean
}
필드
applicationReportsEnabled

boolean

앱 보고서가 사용 설정되어 있는지 여부입니다.
deviceSettingsEnabled

boolean

기기 설정 보고가 사용 설정되어 있는지 여부입니다.
softwareInfoEnabled

boolean

소프트웨어 정보 보고가 사용 설정되어 있는지 여부입니다.
memoryInfoEnabled

boolean

메모리 이벤트 보고가 사용 설정되어 있는지 여부입니다.
networkInfoEnabled

boolean

네트워크 정보 보고가 사용 설정되어 있는지 여부입니다.
displayInfoEnabled

boolean

디스플레이 보고가 사용 설정되어 있는지 여부입니다. 직장 프로필이 있는 개인 소유 기기에는 보고서 데이터를 사용할 수 없습니다.
powerManagementEventsEnabled

boolean

전원 관리 이벤트 보고가 사용 설정되어 있는지 여부입니다. 직장 프로필이 있는 개인 소유 기기에는 보고서 데이터를 사용할 수 없습니다.
hardwareStatusEnabled

boolean

하드웨어 상태 보고가 사용 설정되어 있는지 여부입니다. 직장 프로필이 있는 개인 소유 기기에는 보고서 데이터를 사용할 수 없습니다.
systemPropertiesEnabled

boolean

시스템 속성 보고가 사용 설정되어 있는지 여부입니다.
applicationReportingSettings

object (ApplicationReportingSettings)

애플리케이션 보고 설정입니다. applicationReportsEnabled가 true인 경우에만 적용됩니다.
commonCriteriaModeEnabled

boolean

Common Criteria Mode 보고가 사용 설정되어 있는지 여부입니다. 이 기능은 회사 소유 기기에서만 지원됩니다.

ApplicationReportingSettings

애플리케이션 보고서의 동작을 제어하는 설정입니다.

JSON 표현 
{
  "includeRemovedApps": boolean
}
필드
includeRemovedApps

boolean

삭제된 앱이 애플리케이션 보고서에 포함되는지 여부입니다.

PackageNameList

패키지 이름 목록입니다.

JSON 표현 
{
  "packageNames": [
    string
  ]
}
필드
packageNames[]

string

패키지 이름 목록입니다.

BatteryPluggedMode

배터리 연결 모드

열거형
BATTERY_PLUGGED_MODE_UNSPECIFIED 이 값은 무시됩니다.
AC 전원 공급 장치는 AC 충전기입니다.
USB 전원 공급 장치가 USB 포트입니다.
WIRELESS 전원 공급 장치가 무선입니다.

ProxyInfo

HTTP 프록시의 구성 정보입니다. 직접 프록시의 경우 host, port, excludedHosts 필드를 설정합니다. PAC 스크립트 프록시의 경우 pacUri 필드를 설정합니다.

JSON 표현 
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
필드
host

string

직접 프록시의 호스트입니다.
port

integer

직접 프록시의 포트입니다.
excludedHosts[]

string

직접 프록시의 경우 프록시가 우회되는 호스트입니다. 호스트 이름에는 *.example.com과 같은 와일드 카드가 포함될 수 있습니다.
pacUri

string

프록시를 구성하는 데 사용되는 PAC 스크립트의 URI입니다.

ChoosePrivateKeyRule

비공개 키에 대한 앱의 액세스를 제어합니다. 이 규칙은 Android 기기 정책이 지정된 앱에 부여하는 비공개 키를 결정합니다(있는 경우). 액세스 권한은 앱이 KeyChain.choosePrivateKeyAlias(또는 오버로드)를 호출하여 지정된 URL의 비공개 키 별칭을 요청할 때 또는 Android 11 이상의 URL 비특정 규칙(즉, urlPattern가 설정되지 않았거나 빈 문자열 또는 .*로 설정된 경우)에 대해 직접 부여되므로 앱이 먼저 KeyChain.choosePrivateKeyAlias를 호출하지 않고 KeyChain.getPrivateKey를 호출할 수 있습니다.

둘 이상의 choosePrivateKeyRules가 일치하는 경우 앱이 KeyChain.choosePrivateKeyAlias를 호출하면 일치하는 마지막 규칙이 반환할 키 별칭을 정의합니다.

JSON 표현 
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
필드
urlPattern

string

요청 URL과 일치하는 URL 패턴입니다. 설정하지 않거나 비어 있으면 모든 URL과 일치합니다. java.util.regex.Pattern의 정규 표현식 구문을 사용합니다.
packageNames[]

string

이 규칙이 적용되는 패키지 이름입니다. 각 앱의 서명 인증서 해시가 Play에서 제공한 해시와 비교하여 확인됩니다. 패키지 이름이 지정되지 않은 경우 별칭은 KeyChain.choosePrivateKeyAlias 또는 오버로드를 호출하는 모든 앱에 제공됩니다 (Android 11 이상에서도 KeyChain.choosePrivateKeyAlias을 호출하지 않고는 제공되지 않음). 여기에 지정된 패키지와 동일한 Android UID를 가진 앱은 KeyChain.choosePrivateKeyAlias를 호출할 때 액세스 권한이 있습니다.
privateKeyAlias

string

사용할 비공개 키의 별칭입니다.

AlwaysOnVpnPackage

연결 유지 VPN 연결 구성입니다.

JSON 표현 
{
  "packageName": string,
  "lockdownEnabled": boolean
}
필드
packageName

string

VPN 앱의 패키지 이름입니다.
lockdownEnabled

boolean

VPN이 연결되지 않은 경우 네트워킹을 허용하지 않습니다.

LocationMode

직장 프로필 및 완전 관리형 기기에서 사용 설정된 위치 감지 정도입니다.

열거형
LOCATION_MODE_UNSPECIFIED 기본값은 LOCATION_USER_CHOICE입니다.
HIGH_ACCURACY

Android 8 이하에서는 GPS, 네트워크, 기타 센서를 비롯한 모든 위치 감지 방법이 사용 설정됩니다. Android 9 이상에서는 LOCATION_ENFORCED와 동일합니다.
SENSORS_ONLY

Android 8 이하에서는 GPS와 기타 센서만 사용 설정됩니다. Android 9 이상에서는 LOCATION_ENFORCED와 동일합니다.
BATTERY_SAVING

Android 8 이하에서는 네트워크 위치 제공자만 사용 설정됩니다. Android 9 이상에서는 LOCATION_ENFORCED와 동일합니다.
OFF

Android 8 이하에서는 위치 설정과 정확도가 사용 중지됩니다. Android 9 이상에서는 LOCATION_DISABLED와 동일합니다.
LOCATION_USER_CHOICE 기기에서 위치 설정이 제한되지 않습니다. 특정 동작이 설정되거나 적용되지 않습니다.
LOCATION_ENFORCED 기기에서 위치 설정을 사용 설정합니다.
LOCATION_DISABLED 기기에서 위치 설정을 사용 중지합니다.

ComplianceRule

기기가 정책을 준수하지 않을 때 취해야 하는 완화 조치를 선언하는 규칙입니다. 모든 규칙에는 항상 Device 리소스에 대해 policyCompliant을 false로 설정하고 기기가 정책을 준수하지 않음을 나타내는 메시지를 기기에 표시하는 암시적 완화 조치가 있습니다. 규칙의 필드 값에 따라 다른 완화 조치를 선택적으로 취할 수도 있습니다.

JSON 표현 
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

  // Union field condition can be only one of the following:
  "nonComplianceDetailCondition": {
    object (NonComplianceDetailCondition)
  },
  "apiLevelCondition": {
    object (ApiLevelCondition)
  }
  // End of list of possible types for union field condition.
}
필드
disableApps

boolean

true로 설정하면 기기가 효과적으로 사용 중지되지만 앱 데이터는 보존되도록 앱을 사용 중지하는 완화 조치가 규칙에 포함됩니다. 기기에서 잠긴 작업 모드로 앱을 실행하는 경우 앱이 종료되고 규정 미준수 이유를 보여주는 UI가 표시됩니다.
packageNamesToDisable[]

string

설정된 경우 규칙에는 목록에 지정된 앱을 사용 중지하는 완화 조치가 포함되지만 앱 데이터는 보존됩니다.
통합 필드 condition. 조건이 충족되면 규칙에 정의된 완화 조치를 트리거합니다. 조건 중 정확히 하나를 설정해야 합니다. condition은 다음 중 하나여야 합니다.
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

기기에 일치하는 NonComplianceDetail이 하나라도 있으면 충족되는 조건입니다.
apiLevelCondition

object (ApiLevelCondition)

기기의 Android 프레임워크 API 수준이 최소 요구사항을 충족하지 않는 경우 충족되는 조건입니다.

NonComplianceDetailCondition

기기에 일치하는 NonComplianceDetail이 하나라도 있으면 충족되는 규정 준수 규칙 조건입니다. NonComplianceDetailCondition 내에 설정된 모든 필드가 해당 NonComplianceDetail 필드와 일치하면 NonComplianceDetail가 NonComplianceDetailCondition와 일치합니다.

JSON 표현 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
필드
settingName

string

정책 설정의 이름입니다. 최상위 Policy 필드의 JSON 필드 이름입니다. 설정되지 않은 경우 이 조건은 모든 설정 이름과 일치합니다.
nonComplianceReason

enum (NonComplianceReason)

기기가 설정에 따르지 않는 이유입니다. 설정되지 않은 경우 이 조건은 모든 이유와 일치합니다.
packageName

string

정책을 준수하지 않는 앱의 패키지 이름입니다. 설정하지 않으면 이 조건은 모든 패키지 이름과 일치합니다.

ApiLevelCondition

기기의 Android 프레임워크 API 수준이 최소 요구사항을 충족하지 않는 경우 충족되는 규정 준수 규칙 조건입니다. 정책당 이러한 유형의 조건이 있는 규칙은 하나만 있을 수 있습니다.

JSON 표현 
{
  "minApiLevel": integer
}
필드
minApiLevel

integer

원하는 최소 Android 프레임워크 API 수준입니다. 기기가 최소 요구사항을 충족하지 않으면 이 조건이 충족됩니다. 0보다 커야 합니다.

AppAutoUpdatePolicy

권장되는 대안: 앱별로 설정되는 autoUpdateMode는 업데이트 빈도에 관해 더 큰 유연성을 제공합니다.

autoUpdateMode이 AUTO_UPDATE_POSTPONED 또는 AUTO_UPDATE_HIGH_PRIORITY로 설정된 경우 이 필드는 효과가 없습니다.

앱 자동 업데이트가 적용될 수 있는 시점을 제어하는 앱 자동 업데이트 정책입니다.

열거형
APP_AUTO_UPDATE_POLICY_UNSPECIFIED 자동 업데이트 정책이 설정되어 있지 않습니다. CHOICE_TO_THE_USER와 같습니다.
CHOICE_TO_THE_USER 사용자가 자동 업데이트를 제어할 수 있습니다.
NEVER 앱이 자동으로 업데이트되지 않습니다.
WIFI_ONLY 앱은 Wi-Fi를 통해서만 자동 업데이트됩니다.
ALWAYS 앱이 언제든지 자동 업데이트됩니다. 데이터 요금이 부과될 수 있습니다.

AppTrack

Google Play 앱 출시 트랙입니다.

열거형
APP_TRACK_UNSPECIFIED 이 값은 무시됩니다.
PRODUCTION 최신 안정화 버전을 제공하는 프로덕션 트랙
BETA 최신 베타 버전을 제공하는 베타 트랙입니다.

EncryptionPolicy

암호화 유형

열거형
ENCRYPTION_POLICY_UNSPECIFIED 이 값은 무시됩니다.즉, 암호화가 필요하지 않습니다.
ENABLED_WITHOUT_PASSWORD 암호화는 필요하지만 부팅에 비밀번호는 필요하지 않음
ENABLED_WITH_PASSWORD 부팅에 비밀번호가 필요한 암호화 필요

PlayStoreMode

Play 스토어 모드 정책의 가능한 값입니다.

열거형
PLAY_STORE_MODE_UNSPECIFIED 지정되지 않음. 기본값은 WHITELIST입니다.
WHITELIST 정책에 포함된 앱만 사용할 수 있으며 정책에 포함되지 않은 앱은 기기에서 자동으로 제거됩니다.
BLACKLIST 모든 앱을 사용할 수 있으며 기기에 있으면 안 되는 앱은 applications 정책에서 명시적으로 '차단됨'으로 표시해야 합니다.

SetupAction

설정 중에 실행된 작업입니다.

JSON 표현 
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

  // Union field action can be only one of the following:
  "launchApp": {
    object (LaunchAppAction)
  }
  // End of list of possible types for union field action.
}
필드
title

object (UserFacingMessage)

이 작업의 제목입니다.
description

object (UserFacingMessage)

이 작업에 대한 설명입니다.
통합 필드 action. 설정 중에 실행할 작업입니다. action은 다음 중 하나여야 합니다.
launchApp

object (LaunchAppAction)

앱을 실행하는 작업입니다. 앱은 키가 com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION인 추가 항목이 포함된 인텐트로 실행되며, 이는 설정 작업 흐름임을 나타내는 불리언 값 true로 설정됩니다. SetupAction가 앱을 참조하는 경우 애플리케이션 정책의 해당 installType이 REQUIRED_FOR_SETUP로 설정되어야 합니다. 그렇지 않으면 설정이 실패합니다.

LaunchAppAction

앱을 실행하는 작업입니다.

JSON 표현 
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
필드
통합 필드 launch. 실행할 실행 작업에 대한 설명입니다. launch은 다음 중 하나여야 합니다.
packageName

string

실행할 앱의 패키지 이름

PolicyEnforcementRule

기기 또는 직장 프로필이 settingName에 지정된 정책을 준수하지 않는 경우 취할 조치를 정의하는 규칙입니다. 일치하는 시행 규칙이 여러 개이거나 트리거된 시행 규칙이 여러 개인 경우 가장 심각한 조치가 취해지도록 병합됩니다. 하지만 트리거된 모든 규칙은 계속 추적됩니다. 여기에는 초기 트리거 시간과 모든 관련 규정 위반 세부정보가 포함됩니다. 가장 심각한 시정 조치 규칙이 충족되는 경우 다음으로 적절한 조치가 적용됩니다.

JSON 표현 
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

  // Union field trigger can be only one of the following:
  "settingName": string
  // End of list of possible types for union field trigger.
}
필드
blockAction

object (BlockAction)

회사 소유 기기 또는 직장 프로필의 앱과 데이터에 대한 액세스를 차단하는 작업입니다. 이 작업은 규정 준수 문제를 해결하는 방법에 관한 정보가 포함된 사용자 대상 알림도 트리거합니다 (가능한 경우). 참고: wipeAction도 지정해야 합니다.
wipeAction

object (WipeAction)

회사 소유 기기를 재설정하거나 직장 프로필을 삭제하는 작업입니다. 참고: blockAction도 지정해야 합니다.
통합 필드 trigger. 이 규칙을 트리거하는 조건입니다. trigger은 다음 중 하나여야 합니다.
settingName

string

시행할 최상위 정책입니다. 예를 들면 applications 또는 passwordPolicies입니다.

BlockAction

완전 관리형 기기 또는 직장 프로필에서 앱과 데이터에 대한 액세스를 차단하는 작업입니다. 이 작업은 또한 기기 또는 직장 프로필이 규정 준수 문제를 수정하는 방법에 관한 정보가 포함된 사용자 대상 알림을 표시하도록 트리거합니다 (가능한 경우). 참고: wipeAction도 지정해야 합니다.

JSON 표현 
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
필드
blockAfterDays

integer

기기 또는 직장 프로필이 차단되기 전까지 정책을 준수하지 않는 기간(일)입니다. 액세스를 즉시 차단하려면 0으로 설정합니다. blockAfterDays은(는) wipeAfterDays보다 작아야 합니다.
blockScope

enum (BlockScope)

이 BlockAction의 범위를 지정합니다. 회사 소유 기기에만 적용됩니다.

BlockScope

BlockAction의 범위를 지정합니다. 회사 소유 기기에만 적용됩니다.

열거형
BLOCK_SCOPE_UNSPECIFIED 지정되지 않음. 기본값은 BLOCK_SCOPE_WORK_PROFILE입니다.
BLOCK_SCOPE_WORK_PROFILE 차단 작업은 직장 프로필의 앱에만 적용됩니다. 개인 프로필의 앱은 영향을 받지 않습니다.
BLOCK_SCOPE_DEVICE 차단 작업은 개인 프로필의 앱을 포함한 전체 기기에 적용됩니다.

WipeAction

회사 소유 기기를 재설정하거나 직장 프로필을 삭제하는 작업입니다. 참고: blockAction도 지정해야 합니다.

JSON 표현 
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
필드
wipeAfterDays

integer

기기 또는 직장 프로필이 초기화되기 전까지 정책이 미준수 상태로 유지되는 일수입니다. wipeAfterDays은 blockAfterDays보다 커야 합니다.
preserveFrp

boolean

초기화 보호 데이터가 기기에 보존되는지 여부입니다. 이 설정은 직장 프로필에는 적용되지 않습니다.

KioskCustomization

키오스크 모드에서 기기의 동작을 제어하는 설정입니다. 키오스크 모드를 사용 설정하려면 kioskCustomLauncherEnabled을 true로 설정하거나 installType KIOSK로 정책에서 앱을 지정합니다.

JSON 표현 
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
필드
powerButtonActions

enum (PowerButtonActions)

사용자가 전원 버튼을 길게 누를 때 키오스크 모드에서 기기의 동작을 설정합니다.
systemErrorWarnings

enum (SystemErrorWarnings)

비정상 종료되거나 응답하지 않는 앱의 시스템 오류 대화상자가 키오스크 모드에서 차단되는지 여부를 지정합니다. 차단되면 사용자가 UI에서 '앱 닫기' 옵션을 선택한 것처럼 시스템에서 앱을 강제 종료합니다.
systemNavigation

enum (SystemNavigation)

키오스크 모드에서 사용 설정된 탐색 기능 (예: 홈, 개요 버튼)을 지정합니다.
statusBar

enum (StatusBar)

키오스크 모드에서 시스템 정보와 알림이 사용 중지되는지 여부를 지정합니다.
deviceSettings

enum (DeviceSettings)

키오스크 모드에서 설정 앱이 허용되는지 여부를 지정합니다.

PowerButtonActions

사용자가 전원 버튼을 길게 누를 때 키오스크 모드에서 기기의 동작을 설정합니다.

열거형
POWER_BUTTON_ACTIONS_UNSPECIFIED 지정되지 않은 경우 기본값은 POWER_BUTTON_AVAILABLE입니다.
POWER_BUTTON_AVAILABLE 사용자가 키오스크 모드에서 기기의 전원 버튼을 길게 누르면 전원 메뉴 (예: 전원 끄기, 다시 시작)가 표시됩니다.
POWER_BUTTON_BLOCKED 사용자가 키오스크 모드에서 기기의 전원 버튼을 길게 누르면 전원 메뉴 (예: 전원 끄기, 다시 시작)가 표시되지 않습니다. 참고: 이로 인해 사용자가 기기를 끌 수 없을 수 있습니다.

SystemErrorWarnings

비정상 종료되거나 응답하지 않는 앱의 시스템 오류 대화상자가 키오스크 모드에서 차단되는지 여부를 지정합니다.

열거형
SYSTEM_ERROR_WARNINGS_UNSPECIFIED 지정되지 않은 경우 기본값은 ERROR_AND_WARNINGS_MUTED입니다.
ERROR_AND_WARNINGS_ENABLED 비정상 종료 및 앱 응답 없음 (ANR)과 같은 모든 시스템 오류 대화상자가 표시됩니다.
ERROR_AND_WARNINGS_MUTED 비정상 종료 및 앱 응답 없음 (ANR)과 같은 모든 시스템 오류 대화상자가 차단됩니다. 차단되면 시스템은 사용자가 UI에서 앱을 닫는 것처럼 앱을 강제 종료합니다.

SystemNavigation

키오스크 모드에서 사용 설정된 탐색 기능 (예: 홈, 개요 버튼)을 지정합니다.

열거형
SYSTEM_NAVIGATION_UNSPECIFIED 지정되지 않은 경우 기본값은 NAVIGATION_DISABLED입니다.
NAVIGATION_ENABLED 홈 및 개요 버튼이 사용 설정되어 있습니다.
NAVIGATION_DISABLED 홈 및 개요 버튼에 액세스할 수 없습니다.
HOME_BUTTON_ONLY 홈 버튼만 사용 설정됩니다.

StatusBar

키오스크 모드에서 시스템 정보와 알림이 사용 중지되는지 여부를 지정합니다.

열거형
STATUS_BAR_UNSPECIFIED 지정되지 않은 경우 기본값은 INFO_AND_NOTIFICATIONS_DISABLED입니다.
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

키오스크 모드에서는 시스템 정보와 알림이 상태 표시줄에 표시됩니다.

참고: 이 정책이 적용되려면 kioskCustomization.systemNavigation을 사용하여 기기의 홈 버튼을 사용 설정해야 합니다.
NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED 키오스크 모드에서는 시스템 정보와 알림이 사용 중지됩니다.
SYSTEM_INFO_ONLY 상태 표시줄에 시스템 정보만 표시됩니다.

DeviceSettings

사용자가 키오스크 모드에서 기기의 설정 앱에 액세스할 수 있는지 여부를 지정합니다.

열거형
DEVICE_SETTINGS_UNSPECIFIED 지정되지 않은 경우 기본값은 SETTINGS_ACCESS_ALLOWED입니다.
SETTINGS_ACCESS_ALLOWED 키오스크 모드에서는 설정 앱에 대한 액세스가 허용됩니다.
SETTINGS_ACCESS_BLOCKED 키오스크 모드에서는 설정 앱에 액세스할 수 없습니다.

AdvancedSecurityOverrides

고급 보안 설정 대부분의 경우 이러한 설정을 지정할 필요가 없습니다.

JSON 표현 
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy),
  "contentProtectionPolicy": enum (ContentProtectionPolicy)
}
필드
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

기기에서 시행되는 신뢰할 수 없는 앱 (알 수 없는 출처의 앱) 정책입니다. installUnknownSourcesAllowed (deprecated). 대체
googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Google Play 프로텍트 인증이 적용되는지 여부입니다. ensureVerifyAppsEnabled를 바꿉니다 (지원 중단됨).
developerSettings

enum (DeveloperSettings)

개발자 설정(개발자 옵션 및 안전 모드)에 대한 액세스를 제어합니다. safeBootDisabled (지원 중단됨) 및 debuggingFeaturesAllowed (지원 중단됨)를 바꿉니다.
commonCriteriaMode

enum (CommonCriteriaMode)

공통 기준 모드(정보 기술 보안 평가를 위한 공통 기준(CC)에 정의된 보안 표준)를 제어합니다. 공통 기준 모드를 사용 설정하면 기기의 특정 보안 구성요소가 강화됩니다. 자세한 내용은 CommonCriteriaMode를 참고하세요.

경고: 공통 기준 모드는 일반적으로 국가 안보 시스템 및 기타 매우 민감한 조직에서 사용되는 IT 제품에만 필요한 엄격한 보안 모델을 적용합니다. 표준 기기 사용에 영향을 줄 수 있습니다. 필요한 경우에만 사용 설정됩니다. 이전에 사용 설정된 후 공통 기준 모드가 사용 중지되면 사용자가 구성한 모든 Wi-Fi 네트워크가 손실될 수 있으며 사용자 입력이 필요한 엔터프라이즈 구성 Wi-Fi 네트워크를 재구성해야 할 수 있습니다.
personalAppsThatCanReadWorkNotifications[]

string

NotificationListenerService를 사용하여 직장 프로필 알림을 읽을 수 있는 개인 앱 기본적으로 시스템 앱을 제외한 개인 앱은 직장 알림을 읽을 수 없습니다. 목록의 각 값은 패키지 이름이어야 합니다.
mtePolicy

enum (MtePolicy)

선택사항입니다. 기기의 Memory Tagging Extension (MTE)을 제어합니다. MTE 정책 변경사항을 적용하려면 기기를 재부팅해야 합니다.
contentProtectionPolicy

enum (ContentProtectionPolicy)

선택사항입니다. 사기성 앱을 검사하는 콘텐츠 보호 기능의 사용 설정 여부를 제어합니다. 이 기능은 Android 15 이상에서 지원됩니다.

UntrustedAppsPolicy

기기에서 시행되는 신뢰할 수 없는 앱 (알 수 없는 출처의 앱) 정책입니다. installUnknownSourcesAllowed (deprecated). 대체

열거형
UNTRUSTED_APPS_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 DISALLOW_INSTALL입니다.
DISALLOW_INSTALL 기본값입니다. 전체 기기에서 신뢰할 수 없는 앱 설치를 허용하지 않습니다.
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY 직장 프로필이 있는 기기의 경우 기기의 개인 프로필에만 신뢰할 수 없는 앱 설치를 허용합니다.
ALLOW_INSTALL_DEVICE_WIDE 전체 기기에서 신뢰할 수 없는 앱 설치를 허용합니다.

GooglePlayProtectVerifyApps

Google Play 프로텍트 인증이 적용되는지 여부입니다. ensureVerifyAppsEnabled를 바꿉니다 (지원 중단됨).

열거형
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED 지정되지 않음. 기본값은 VERIFY_APPS_ENFORCED입니다.
VERIFY_APPS_ENFORCED 기본값입니다. 앱 인증을 강제 사용 설정합니다.
VERIFY_APPS_USER_CHOICE 사용자가 앱 인증을 사용 설정할지 선택할 수 있도록 허용합니다.

DeveloperSettings

개발자 설정(개발자 옵션 및 안전 모드)에 대한 액세스를 제어합니다. safeBootDisabled (지원 중단됨) 및 debuggingFeaturesAllowed (지원 중단됨)를 바꿉니다.

열거형
DEVELOPER_SETTINGS_UNSPECIFIED 지정되지 않음. 기본값은 DEVELOPER_SETTINGS_DISABLED입니다.
DEVELOPER_SETTINGS_DISABLED 기본값입니다. 모든 개발자 설정을 사용 중지하고 사용자가 설정에 액세스하지 못하도록 합니다.
DEVELOPER_SETTINGS_ALLOWED 모든 개발자 설정을 허용합니다. 사용자가 설정에 액세스하고 선택적으로 구성할 수 있습니다.

CommonCriteriaMode

공통 기준 모드(정보 기술 보안 평가를 위한 공통 기준(CC)에 정의된 보안 표준)를 제어합니다. 공통 기준 모드를 사용 설정하면 다음을 비롯한 기기의 특정 보안 구성요소가 강화됩니다.

  1. 블루투스 장기 키의 AES-GCM 암호화
  2. Wi-Fi 구성 저장소
  3. AM API 대상 호스트에 연결하려면 TLSv1.2를 사용해야 하는 추가 네트워크 인증서 유효성 검사
  4. 암호화 정책 무결성 검사 정책 무결성 확인 상태를 가져오려면 statusReportingSettings.commonCriteriaModeEnabled를 true로 설정하는 것이 좋습니다. 정책 서명 확인이 실패하면 기기에 정책이 적용되지 않고 commonCriteriaModeInfo.policy_signature_verification_status이 POLICY_SIGNATURE_VERIFICATION_FAILED로 설정됩니다.

공통 기준 모드는 Android 11 이상을 실행하는 회사 소유 기기에서만 지원됩니다.

경고: 공통 기준 모드는 일반적으로 국가 안보 시스템 및 기타 매우 민감한 조직에서 사용되는 IT 제품에만 필요한 엄격한 보안 모델을 적용합니다. 표준 기기 사용에 영향을 줄 수 있습니다. 필요한 경우에만 사용 설정됩니다. 이전에 사용 설정된 후 공통 기준 모드가 사용 중지되면 사용자가 구성한 모든 Wi-Fi 네트워크가 손실될 수 있으며 사용자 입력이 필요한 엔터프라이즈 구성 Wi-Fi 네트워크를 재구성해야 할 수 있습니다.

열거형
COMMON_CRITERIA_MODE_UNSPECIFIED 지정되지 않음. 기본값은 COMMON_CRITERIA_MODE_DISABLED입니다.
COMMON_CRITERIA_MODE_DISABLED 기본값입니다. 공통 기준 모드를 사용 중지합니다.
COMMON_CRITERIA_MODE_ENABLED 공통 기준 모드를 사용 설정합니다.

MtePolicy

기기의 Memory Tagging Extension (MTE)을 제어합니다.

열거형
MTE_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 MTE_USER_CHOICE입니다.
MTE_USER_CHOICE 기기에서 이를 지원하는 경우 사용자는 기기에서 MTE를 사용 설정하거나 사용 중지할 수 있습니다.
MTE_ENFORCED

기기에서 MTE가 사용 설정되어 있으며 사용자는 이 설정을 변경할 수 없습니다. 이 설정은 완전 관리형 기기와 회사 소유 기기의 직장 프로필에서 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail는 다른 관리 모드에 대해 보고됩니다. 기기에서 MTE를 지원하지 않는 경우 DEVICE_INCOMPATIBLE이 있는 NonComplianceDetail이 보고됩니다.

Android 14 이상에서 지원됩니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
MTE_DISABLED

기기에서 MTE가 사용 중지되어 있으며 사용자가 이 설정을 변경할 수 없습니다. 이는 완전 관리형 기기에만 적용됩니다. 다른 경우에는 MANAGEMENT_MODE이 포함된 NonComplianceDetail가 보고됩니다. 기기에서 MTE를 지원하지 않는 경우 DEVICE_INCOMPATIBLE이 있는 NonComplianceDetail이 보고됩니다.

Android 14 이상에서 지원됩니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

ContentProtectionPolicy

사기성 앱을 검사하는 콘텐츠 보호 기능의 사용 설정 여부를 제어합니다. 이 기능은 Android 15 이상에서 지원됩니다.

열거형
CONTENT_PROTECTION_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 CONTENT_PROTECTION_DISABLED입니다.
CONTENT_PROTECTION_DISABLED 콘텐츠 보호가 사용 중지되어 있으며 사용자가 이를 변경할 수 없습니다.
CONTENT_PROTECTION_ENFORCED

콘텐츠 보호가 사용 설정되어 있으며 사용자가 이를 변경할 수 없습니다.

Android 15 이상에서 지원됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
CONTENT_PROTECTION_USER_CHOICE

콘텐츠 보호는 정책에 의해 제어되지 않습니다. 사용자는 콘텐츠 보호 동작을 선택할 수 있습니다.

Android 15 이상에서 지원됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

PersonalUsagePolicies

직장 프로필이 있는 회사 소유 기기의 개인 사용을 관리하는 정책입니다.

JSON 표현 
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ],
  "privateSpacePolicy": enum (PrivateSpacePolicy),
  "bluetoothSharing": enum (BluetoothSharing)
}
필드
cameraDisabled

boolean

true인 경우 개인 프로필에서 카메라가 사용 중지됩니다.
screenCaptureDisabled

boolean

true인 경우 모든 사용자에 대해 화면 캡처가 사용 중지됩니다.
accountTypesWithManagementDisabled[]

string

사용자가 관리할 수 없는 계정 유형입니다.
maxDaysWithWorkOff

integer

직장 프로필을 사용 중지할 수 있는 기간을 제어합니다. 최소 기간은 3일 이상이어야 합니다. 기타 세부정보는 다음과 같습니다.

  • 기간이 0으로 설정되면 기능이 사용 중지됩니다.
  • 기간이 최소 기간보다 작은 값으로 설정되면 기능에서 오류를 반환합니다.
참고: 긴 오프타임 동안 개인 프로필이 정지되지 않도록 하려면 이 매개변수를 큰 값으로 일시적으로 설정하면 됩니다.
personalPlayStoreMode

enum (PlayStoreMode)

personalApplications와 함께 사용하여 개인 프로필의 앱이 허용되거나 차단되는 방식을 제어합니다.
personalApplications[]

object (PersonalApplicationPolicy)

개인 프로필의 애플리케이션에 적용된 정책입니다.
privateSpacePolicy

enum (PrivateSpacePolicy)

선택사항입니다. 기기에서 비공개 스페이스가 허용되는지 여부를 제어합니다.
bluetoothSharing

enum (BluetoothSharing)

선택사항입니다. 블루투스 공유가 허용되는지 여부입니다.

PlayStoreMode

personalApplications와 함께 사용하여 개인 프로필의 앱이 허용되거나 차단되는 방식을 제어합니다.

열거형
PLAY_STORE_MODE_UNSPECIFIED 지정되지 않음. 기본값은 BLOCKLIST입니다.
BLACKLIST

personalApplications에서 installType이 BLOCKED인 앱을 제외한 모든 Play 스토어 앱은 개인 프로필에 설치할 수 있습니다.
BLOCKLIST personalApplications에서 installType이 BLOCKED인 앱을 제외한 모든 Play 스토어 앱은 개인 프로필에 설치할 수 있습니다.
ALLOWLIST installType이 AVAILABLE로 설정된 personalApplications에 명시적으로 지정된 앱만 개인 프로필에 설치할 수 있습니다.

PersonalApplicationPolicy

직장 프로필이 있는 회사 소유 기기의 개인 프로필에 있는 앱에 대한 정책입니다.

JSON 표현 
{
  "packageName": string,
  "installType": enum (InstallType)
}
필드
packageName

string

애플리케이션의 패키지 이름입니다.
installType

enum (InstallType)

실행할 설치 유형입니다.

InstallType

개인 프로필 애플리케이션이 가질 수 있는 설치 동작 유형입니다.

열거형
INSTALL_TYPE_UNSPECIFIED 지정되지 않음. 기본값은 AVAILABLE입니다.
BLOCKED 앱이 차단되어 개인 프로필에 설치할 수 없습니다. 앱이 이전에 기기에 설치된 경우 제거됩니다.
AVAILABLE 개인 프로필에 앱을 설치할 수 있습니다.

PrivateSpacePolicy

기기에서 비공개 스페이스를 허용할지 여부를 제어합니다.

열거형
PRIVATE_SPACE_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 PRIVATE_SPACE_ALLOWED입니다.
PRIVATE_SPACE_ALLOWED 사용자는 비공개 스페이스 프로필을 만들 수 있습니다.
PRIVATE_SPACE_DISALLOWED 사용자는 비공개 스페이스 프로필을 만들 수 없습니다. 직장 프로필이 있는 회사 소유 기기에서만 지원됩니다. 주의: 기존 비공개 스페이스가 삭제됩니다.

BluetoothSharing

직장 프로필이 있는 회사 소유 기기의 개인 프로필에서 블루투스 공유가 허용되는지 여부입니다.

열거형
BLUETOOTH_SHARING_UNSPECIFIED 지정되지 않음. 기본값은 BLUETOOTH_SHARING_ALLOWED입니다.
BLUETOOTH_SHARING_ALLOWED

개인 프로필에서 블루투스 공유가 허용됩니다.

Android 8 이상에서 지원됩니다. 개인 기기에 설정된 경우 MANAGEMENT_MODE이 있는 NonComplianceDetail이 보고됩니다.
BLUETOOTH_SHARING_DISALLOWED

개인 프로필에서는 블루투스 공유가 허용되지 않습니다.

Android 8 이상에서 지원됩니다. Android 버전이 8 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다. 개인 기기에 설정된 경우 MANAGEMENT_MODE이 있는 NonComplianceDetail이 보고됩니다.

AutoDateAndTimeZone

회사 소유 기기에서 날짜, 시간, 시간대 자동 설정이 사용 설정되었는지 여부

열거형
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED 지정되지 않음. 기본값은 AUTO_DATE_AND_TIME_ZONE_USER_CHOICE입니다.
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE 날짜, 시간, 시간대 자동 설정은 사용자가 선택합니다.
AUTO_DATE_AND_TIME_ZONE_ENFORCED 기기에서 자동 날짜, 시간, 시간대를 강제 적용합니다.

OncCertificateProvider

이 기능은 정식 버전이 아닙니다.

JSON 표현 
{
  "certificateReferences": [
    string
  ],

  // Union field endpoint can be only one of the following:
  "contentProviderEndpoint": {
    object (ContentProviderEndpoint)
  }
  // End of list of possible types for union field endpoint.
}
필드
certificateReferences[]

string

이 기능은 정식 버전이 아닙니다.

통합 필드 endpoint.

이 기능은 정식 버전이 아닙니다. endpoint는 다음 중 하나여야 합니다.
contentProviderEndpoint

object (ContentProviderEndpoint)

이 기능은 정식 버전이 아닙니다.

ContentProviderEndpoint

이 기능은 정식 버전이 아닙니다.

JSON 표현 
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
필드
uri

string

이 기능은 정식 버전이 아닙니다.
packageName

string

이 기능은 정식 버전이 아닙니다.
signingCertsSha256[]

string

필수 항목입니다. 이 기능은 정식 버전이 아닙니다.

CrossProfilePolicies

개인 프로필에서 액세스할 수 있는 직장 프로필의 데이터와 그 반대의 경우를 제어합니다. 기기에 직장 프로필이 없는 경우 MANAGEMENT_MODE이 있는 NonComplianceDetail이 보고됩니다.

JSON 표현 
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "crossProfileAppFunctions": enum (CrossProfileAppFunctions),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
필드
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

개인 앱이 직장 프로필에 저장된 연락처에 액세스할 수 있는지 여부입니다.

exemptionsToShowWorkContactsInPersonalProfile을 참고하세요.
crossProfileCopyPaste

enum (CrossProfileCopyPaste)

한 프로필 (개인 또는 직장)에서 복사한 텍스트를 다른 프로필에 붙여넣을 수 있는지 여부입니다.
crossProfileDataSharing

enum (CrossProfileDataSharing)

한 프로필 (개인 또는 직장)의 데이터를 다른 프로필의 앱과 공유할 수 있는지 여부 인텐트를 통한 간단한 데이터 공유를 구체적으로 제어합니다. 연락처 검색, 복사/붙여넣기, 연결된 직장 및 개인 앱과 같은 기타 교차 프로필 커뮤니케이션 채널의 관리는 별도로 구성됩니다.
workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

직장 프로필 위젯의 기본 동작을 지정합니다. 정책에서 특정 애플리케이션에 workProfileWidgets를 지정하지 않으면 여기에 지정된 값에 따라 동작합니다.
crossProfileAppFunctions

enum (CrossProfileAppFunctions)

선택사항입니다. 개인 프로필 앱이 직장 프로필의 앱에서 노출된 앱 기능을 호출할 수 있는지 여부를 제어합니다.
exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

ShowWorkContactsInPersonalProfile 설정에서 제외된 앱 목록입니다. 이 값을 설정하려면 ShowWorkContactsInPersonalProfile을 다음 값 중 하나로 설정해야 합니다.

Android 14 이상에서 지원됩니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

ShowWorkContactsInPersonalProfile

개인 앱이 연락처 검색 및 수신 전화를 포함한 직장 프로필 연락처에 액세스할 수 있는지 여부

참고: 개인 앱에서 직장 연락처에 액세스하면 허용된 앱의 동작에 따라 연락처가 다른 앱과 공유되거나 다른 앱으로 전송될 수 있으므로 동일한 앱에 유지된다고 보장할 수 없습니다.

열거형
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

지정되지 않음. 기본값은 SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED입니다.

이 값이 설정된 경우 exemptionsToShowWorkContactsInPersonalProfile은 설정하면 안 됩니다.
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED

개인 앱이 직장 프로필 연락처에 액세스하고 직장 연락처를 조회하는 것을 방지합니다.

이 설정이 지정되면 exemptionsToShowWorkContactsInPersonalProfile에 지정된 개인 앱이 허용 목록에 추가되어 직장 프로필 연락처에 직접 액세스할 수 있습니다.

Android 7.0 이상에서 지원됩니다. Android 버전이 7.0 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

기본값입니다. 개인 프로필의 앱이 연락처 검색 및 수신 전화를 비롯한 직장 프로필 연락처에 액세스하도록 허용합니다.

이 설정이 지정되면 exemptionsToShowWorkContactsInPersonalProfile에 지정된 개인 앱이 차단 목록에 추가되어 직장 프로필 연락처에 직접 액세스할 수 없습니다.

Android 7.0 이상에서 지원됩니다. Android 버전이 7.0 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

OEM 기본 다이얼러, 메시지, 연락처 앱을 제외한 대부분의 개인 앱이 연락처 검색 및 수신 전화를 비롯한 직장 프로필 연락처에 액세스하지 못하도록 합니다. 사용자가 구성한 다이얼러, 메시지, 주소록 앱이나 기타 시스템 또는 Play 설치 앱은 직장 연락처를 직접 쿼리할 수 없습니다.

이 값이 설정되면 exemptionsToShowWorkContactsInPersonalProfile에 지정된 개인 앱이 허용 목록에 추가되어 직장 프로필 연락처에 액세스할 수 있습니다.

Android 14 이상에서 지원됩니다. Android 버전이 14 미만인 기기에서 이 값이 설정되면 동작이 SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED로 대체되고 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

CrossProfileCopyPaste

한 프로필 (개인 또는 직장)에서 복사한 텍스트를 다른 프로필에 붙여넣을 수 있는지 여부입니다.

열거형
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED 지정되지 않음. 기본값은 COPY_FROM_WORK_TO_PERSONAL_DISALLOWED입니다.
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED 기본값입니다. 사용자가 직장 프로필에서 복사한 텍스트를 개인 프로필에 붙여넣지 못하도록 합니다. 개인 프로필에서 복사한 텍스트는 직장 프로필에 붙여넣을 수 있으며, 직장 프로필에서 복사한 텍스트는 직장 프로필에 붙여넣을 수 있습니다.
CROSS_PROFILE_COPY_PASTE_ALLOWED 한 프로필에서 복사한 텍스트를 다른 프로필에 붙여넣을 수 있습니다.

CrossProfileDataSharing

한 프로필 (개인 또는 직장)의 데이터를 다른 프로필의 앱과 공유할 수 있는지 여부 인텐트를 통한 간단한 데이터 공유를 구체적으로 제어합니다. 여기에는 웹브라우저 열기, 지도 열기, 콘텐츠 공유, 문서 열기 등의 작업이 포함됩니다. 연락처 검색, 복사/붙여넣기, 연결된 직장 및 개인 앱과 같은 기타 교차 프로필 통신 채널의 관리는 별도로 구성됩니다.

열거형
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED 지정되지 않음. 기본값은 DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED입니다.
CROSS_PROFILE_DATA_SHARING_DISALLOWED 개인 프로필에서 직장 프로필로, 직장 프로필에서 개인 프로필로 데이터가 공유되지 않도록 합니다.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED 기본값입니다. 사용자가 직장 프로필의 데이터를 개인 프로필의 앱에 공유하지 못하도록 합니다. 개인 데이터를 직장 앱과 공유할 수 있습니다.
CROSS_PROFILE_DATA_SHARING_ALLOWED 한 프로필의 데이터를 다른 프로필과 공유할 수 있습니다.

WorkProfileWidgetsDefault

앱별 정책이 정의되지 않은 경우 직장 프로필 애플리케이션이 홈 화면에 위젯을 추가하도록 허용할지 제어합니다. 그렇지 않으면 앱별 정책이 이 정책보다 우선합니다.

열거형
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED 지정되지 않음. 기본값은 WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED입니다.
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED 직장 프로필 위젯은 기본적으로 허용됩니다. 즉, 정책에서 애플리케이션의 workProfileWidgets을 WORK_PROFILE_WIDGETS_DISALLOWED로 지정하지 않으면 홈 화면에 위젯을 추가할 수 있습니다.
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED 직장 프로필 위젯은 기본적으로 허용되지 않습니다. 즉, 정책에서 애플리케이션의 workProfileWidgets을 WORK_PROFILE_WIDGETS_ALLOWED로 지정하지 않으면 홈 화면에 위젯을 추가할 수 없습니다.

CrossProfileAppFunctions

개인 프로필 앱이 직장 프로필의 앱에서 노출된 앱 기능을 호출할 수 있는지 여부를 제어합니다.

열거형
CROSS_PROFILE_APP_FUNCTIONS_UNSPECIFIED 지정되지 않음. appFunctions이 APP_FUNCTIONS_ALLOWED로 설정된 경우 기본값은 CROSS_PROFILE_APP_FUNCTIONS_ALLOWED입니다. appFunctions이 APP_FUNCTIONS_DISALLOWED로 설정된 경우 기본값은 CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED입니다.
CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED 개인 프로필 앱은 직장 프로필의 앱에서 노출된 앱 기능을 호출할 수 없습니다.
CROSS_PROFILE_APP_FUNCTIONS_ALLOWED 개인 프로필 앱은 직장 프로필의 앱에서 노출된 앱 기능을 호출할 수 있습니다. 이 값이 설정된 경우 appFunctions을 APP_FUNCTIONS_DISALLOWED로 설정하면 안 됩니다. 그렇지 않으면 정책이 거부됩니다.

PreferentialNetworkService

직장 프로필 또는 완전 관리형 기기에서 우선 네트워크 서비스가 사용 설정되는지 여부를 제어합니다. 자세한 내용은 preferentialNetworkService을 참조하세요.

열거형
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED 지정되지 않음. 기본값은 PREFERENTIAL_NETWORK_SERVICES_DISABLED입니다.
PREFERENTIAL_NETWORK_SERVICE_DISABLED 직장 프로필에서 우선 설정 네트워크 서비스가 사용 중지되어 있습니다.
PREFERENTIAL_NETWORK_SERVICE_ENABLED 직장 프로필에서 우선 설정 네트워크 서비스가 사용 설정되어 있습니다. 이 설정은 Android 12 이상을 실행하는 기기의 직장 프로필에서만 지원됩니다. Android 13부터 완전 관리형 기기도 지원됩니다.

UsageLog

기기에서 수집되고 Pub/Sub 알림을 통해 보고되는 기기 활동 로그의 유형을 제어합니다.

JSON 표현 
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
필드
enabledLogTypes[]

enum (LogType)

사용 설정된 로그 유형을 지정합니다. 사용량 로깅이 사용 설정되면 사용자에게 기기 내 메시지가 전송됩니다.
uploadOnCellularAllowed[]

enum (LogType)

사용 설정된 로그 유형 중 모바일 데이터를 통해 업로드할 수 있는 유형을 지정합니다. 기기가 Wi-Fi에 연결되면 기본적으로 로그가 업로드 대기열에 추가됩니다.

LogType

기기에서 보고되는 기기 활동 로그의 유형입니다.

열거형
LOG_TYPE_UNSPECIFIED 이 값은 사용되지 않습니다.
SECURITY_LOGS 기기 비밀번호를 잘못 입력하거나 이동식 저장소가 마운트되는 등 온디바이스 보안 이벤트의 로깅을 사용 설정합니다. 로깅된 보안 이벤트에 대한 전체 설명은 UsageLogEvent를 참고하세요. Android 7 이상에서 완전 관리 기기에 지원됩니다. Android 12 이상에서 직장 프로필이 있는 회사 소유 기기에서 지원되며, 직장 프로필의 보안 이벤트만 로깅됩니다. 위임된 애플리케이션 범위 SECURITY_LOGS로 재정의할 수 있음
NETWORK_ACTIVITY_LOGS DNS 조회 및 TCP 연결과 같은 기기 내 네트워크 이벤트의 로깅을 사용 설정합니다. 로깅된 네트워크 이벤트에 대한 전체 설명은 UsageLogEvent를 참고하세요. Android 8 이상에서 완전 관리 기기에 지원됩니다. Android 12 이상에서 직장 프로필이 있는 회사 소유 기기에서 지원되며, 직장 프로필의 네트워크 이벤트만 로깅됩니다. 위임된 애플리케이션 범위 NETWORK_ACTIVITY_LOGS로 재정의할 수 있음

CameraAccess

카메라 사용 여부와 사용자가 카메라 액세스 전환 버튼에 액세스할 수 있는지 여부를 제어합니다. 카메라 액세스 전환 버튼은 Android 12 이상에 있습니다. 일반적으로 카메라를 사용 중지할 수 있는 기능은 완전 관리형 기기에서는 기기 전체에 적용되고 직장 프로필이 있는 기기에서는 직장 프로필 내에만 적용됩니다. 카메라 액세스 전환 버튼을 사용 중지할 수 있는 기능은 완전 관리 기기에만 적용되며, 이 경우 기기 전체에 적용됩니다. 자세한 내용은 enum 값을 참고하세요.

열거형
CAMERA_ACCESS_UNSPECIFIED cameraDisabled이 true이면 CAMERA_ACCESS_DISABLED와 동일합니다. 그렇지 않으면 CAMERA_ACCESS_USER_CHOICE와 동일합니다.
CAMERA_ACCESS_USER_CHOICE cameraDisabled 필드는 무시됩니다. 이는 기본 기기 동작입니다. 기기의 모든 카메라를 사용할 수 있습니다. Android 12 이상에서는 사용자가 카메라 액세스 전환 버튼을 사용할 수 있습니다.
CAMERA_ACCESS_DISABLED

cameraDisabled 필드는 무시됩니다. 기기의 모든 카메라가 사용 중지됩니다 (완전 관리형 기기의 경우 기기 전체에 적용되고 직장 프로필의 경우 직장 프로필에만 적용됨).

Android 12 이상에서는 카메라 액세스 전환에 명시적인 제한이 없습니다. 완전 관리 기기에서는 모든 카메라가 사용 중지되어 있으므로 카메라 액세스 전환이 적용되지 않습니다. 직장 프로필이 있는 기기에서 이 전환 버튼은 직장 프로필의 앱에는 영향을 미치지 않지만 직장 프로필 외부의 앱에는 영향을 미칩니다.
CAMERA_ACCESS_ENFORCED cameraDisabled 필드는 무시됩니다. 기기의 모든 카메라를 사용할 수 있습니다. Android 12 이상을 실행하는 완전 관리 기기에서는 사용자가 카메라 액세스 전환 버튼을 사용할 수 없습니다. 완전 관리형이 아니거나 Android 11 이하를 실행하는 기기에서는 CAMERA_ACCESS_USER_CHOICE와 동일합니다.

MicrophoneAccess

완전 관리형 기기에서 마이크 사용 여부와 사용자가 마이크 액세스 전환 버튼에 액세스할 수 있는지 여부를 제어합니다. 이 설정은 완전 관리형이 아닌 기기에는 영향을 미치지 않습니다. 마이크 액세스 전환 버튼은 Android 12 이상에 있습니다.

열거형
MICROPHONE_ACCESS_UNSPECIFIED unmuteMicrophoneDisabled이 true이면 MICROPHONE_ACCESS_DISABLED와 동일합니다. 그렇지 않으면 MICROPHONE_ACCESS_USER_CHOICE와 동일합니다.
MICROPHONE_ACCESS_USER_CHOICE unmuteMicrophoneDisabled 필드는 무시됩니다. 이는 기본 기기 동작입니다. 기기의 마이크를 사용할 수 있습니다. Android 12 이상에서는 사용자가 마이크 액세스 전환 버튼을 사용할 수 있습니다.
MICROPHONE_ACCESS_DISABLED

unmuteMicrophoneDisabled 필드는 무시됩니다. 기기의 마이크가 사용 중지되어 있습니다 (완전 관리형 기기의 경우 기기 전체에 적용됨).

마이크가 사용 중지되어 있으므로 마이크 액세스 전환 버튼은 아무런 영향을 미치지 않습니다.
MICROPHONE_ACCESS_ENFORCED unmuteMicrophoneDisabled 필드는 무시됩니다. 기기의 마이크를 사용할 수 있습니다. Android 12 이상을 실행하는 기기에서는 사용자가 마이크 액세스 전환 버튼을 사용할 수 없습니다. Android 11 이하를 실행하는 기기에서는 MICROPHONE_ACCESS_USER_CHOICE와 동일합니다.

DeviceConnectivityManagement

Wi-Fi, USB 데이터 액세스, 키보드/마우스 연결 등 기기 연결 제어를 다룹니다.

JSON 표현 
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings),
  "wifiSsidPolicy": {
    object (WifiSsidPolicy)
  },
  "wifiRoamingPolicy": {
    object (WifiRoamingPolicy)
  },
  "bluetoothSharing": enum (BluetoothSharing),
  "preferentialNetworkServiceSettings": {
    object (PreferentialNetworkServiceSettings)
  },
  "apnPolicy": {
    object (ApnPolicy)
  }
}
필드
usbDataAccess

enum (UsbDataAccess)

USB를 통해 전송할 수 있는 파일 또는 데이터를 제어합니다. 회사 소유 기기에서만 지원됩니다.
configureWifi

enum (ConfigureWifi)

Wi-Fi 구성 권한을 제어합니다. 설정된 옵션에 따라 사용자는 Wi-Fi 네트워크를 구성할 때 완전한 제어 권한을 갖거나 제한된 제어 권한을 갖거나 제어 권한이 없습니다.
wifiDirectSettings

enum (WifiDirectSettings)

Wi-Fi Direct 설정 구성 및 사용을 제어합니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다.
tetheringSettings

enum (TetheringSettings)

테더링 설정을 제어합니다. 설정된 값에 따라 사용자가 다양한 형태의 테더링을 부분적으로 또는 완전히 사용할 수 없습니다.
wifiSsidPolicy

object (WifiSsidPolicy)

기기가 연결할 수 있는 Wi-Fi SSID에 대한 제한사항입니다. 이는 기기에서 구성할 수 있는 네트워크에는 영향을 미치지 않습니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다.
wifiRoamingPolicy

object (WifiRoamingPolicy)

선택사항입니다. Wi-Fi 로밍 정책입니다.
bluetoothSharing

enum (BluetoothSharing)

선택사항입니다. 블루투스 공유 허용 여부를 제어합니다.
preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

선택사항입니다. 우선 설정 네트워크 서비스 구성입니다. 이 필드를 설정하면 preferentialNetworkService이 재정의됩니다. 이 설정은 Android 13 이상의 직장 프로필과 완전 관리형 기기 모두에서 설정할 수 있습니다. 자세한 내용은 5G 네트워크 슬라이싱 가이드를 참고하세요.
apnPolicy

object (ApnPolicy)

선택사항입니다. 액세스 포인트 네임 (APN) 정책입니다. 액세스 포인트 네임 (APN) 구성으로, 기기의 다른 APN을 재정의할 수 있습니다. 자세한 내용은 OVERRIDE_APNS_ENABLED 및 overrideApns을 참고하세요.

UsbDataAccess

USB를 통해 전송할 수 있는 파일 또는 데이터를 제어합니다. 충전 기능에는 영향을 미치지 않습니다. 회사 소유 기기에서만 지원됩니다.

열거형
USB_DATA_ACCESS_UNSPECIFIED 지정되지 않음. 기본값은 DISALLOW_USB_FILE_TRANSFER입니다.
ALLOW_USB_DATA_TRANSFER 모든 유형의 USB 데이터 전송이 허용됩니다. usbFileTransferDisabled은 무시됩니다.
DISALLOW_USB_FILE_TRANSFER USB를 통한 파일 전송이 허용되지 않습니다. 마우스 및 키보드 연결과 같은 다른 유형의 USB 데이터 연결은 허용됩니다. usbFileTransferDisabled은 무시됩니다.
DISALLOW_USB_DATA_TRANSFER 설정하면 모든 유형의 USB 데이터 전송이 금지됩니다. Android 12 이상을 실행하고 USB HAL 1.3 이상이 적용된 기기에서 지원됩니다. 설정이 지원되지 않으면 DISALLOW_USB_FILE_TRANSFER이 설정됩니다. Android 버전이 12 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다. 기기에 USB HAL 1.3 이상이 없는 경우 DEVICE_INCOMPATIBLE이 있는 NonComplianceDetail이 보고됩니다. usbFileTransferDisabled은 무시됩니다.

ConfigureWifi

Wi-Fi 구성 권한을 제어합니다. 설정된 옵션에 따라 사용자는 Wi-Fi 네트워크를 구성할 때 완전한 제어 권한을 갖거나 제한된 제어 권한을 갖거나 제어 권한이 없습니다.

열거형
CONFIGURE_WIFI_UNSPECIFIED 지정되지 않음. wifiConfigDisabled이 true로 설정되지 않는 한 기본값은 ALLOW_CONFIGURING_WIFI입니다. wifiConfigDisabled이 true로 설정되면 DISALLOW_CONFIGURING_WIFI와 동일합니다.
ALLOW_CONFIGURING_WIFI 사용자가 Wi-Fi를 구성할 수 있습니다. wifiConfigDisabled은 무시됩니다.
DISALLOW_ADD_WIFI_CONFIG 새 Wi-Fi 구성을 추가하는 것은 허용되지 않습니다. 사용자는 이미 구성된 네트워크 간에만 전환할 수 있습니다. Android 13 이상, 완전 관리형 기기, 회사 소유 기기의 직장 프로필에서 지원됩니다. 설정이 지원되지 않으면 ALLOW_CONFIGURING_WIFI이 설정됩니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. wifiConfigDisabled은 무시됩니다.
DISALLOW_CONFIGURING_WIFI Wi-Fi 네트워크 구성을 허용하지 않습니다. 이 값이 설정되면 wifiConfigDisabled 설정이 무시됩니다. 지원되는 모든 API 수준에서 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다. 완전 관리 기기의 경우 이 설정을 사용하면 구성된 모든 네트워크가 삭제되고 openNetworkConfiguration 정책을 사용하여 구성된 네트워크만 유지됩니다. 회사 소유 기기의 직장 프로필의 경우 기존에 구성된 네트워크는 영향을 받지 않으며 사용자는 Wi-Fi 네트워크를 추가, 삭제 또는 수정할 수 없습니다. 참고: 부팅 시 네트워크 연결을 할 수 없고 Wi-Fi 구성이 사용 중지된 경우 기기 정책을 새로고침하기 위해 네트워크 비상구가 표시됩니다 (networkEscapeHatchEnabled 참고).

WifiDirectSettings

Wi-Fi Direct 설정을 제어합니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다.

열거형
WIFI_DIRECT_SETTINGS_UNSPECIFIED 지정되지 않음. 기본값은 ALLOW_WIFI_DIRECT입니다.
ALLOW_WIFI_DIRECT 사용자가 Wi-Fi Direct를 사용할 수 있습니다.
DISALLOW_WIFI_DIRECT 사용자가 Wi-Fi Direct를 사용할 수 없습니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

TetheringSettings

사용자가 Wi-Fi 테더링, 블루투스 테더링 등 다양한 형태의 테더링을 사용할 수 있는 정도를 제어합니다.

열거형
TETHERING_SETTINGS_UNSPECIFIED 지정되지 않음. tetheringConfigDisabled이 true로 설정되지 않는 한 기본값은 ALLOW_ALL_TETHERING입니다. tetheringConfigDisabled이 true로 설정되면 DISALLOW_ALL_TETHERING와 동일합니다.
ALLOW_ALL_TETHERING 모든 형태의 테더링을 구성하고 사용할 수 있습니다. tetheringConfigDisabled은 무시됩니다.
DISALLOW_WIFI_TETHERING 사용자가 Wi-Fi 테더링을 사용하지 못하도록 합니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다. 설정이 지원되지 않으면 ALLOW_ALL_TETHERING이 설정됩니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. tetheringConfigDisabled은 무시됩니다.
DISALLOW_ALL_TETHERING 모든 형태의 테더링을 허용하지 않습니다. 지원되는 모든 Android 버전에서 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다. tetheringConfigDisabled 설정은 무시됩니다.

WifiSsidPolicy

기기가 연결할 수 있는 Wi-Fi SSID에 대한 제한사항입니다. 이는 기기에서 구성할 수 있는 네트워크에는 영향을 미치지 않습니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다.

JSON 표현 
{
  "wifiSsidPolicyType": enum (WifiSsidPolicyType),
  "wifiSsids": [
    {
      object (WifiSsid)
    }
  ]
}
필드
wifiSsidPolicyType

enum (WifiSsidPolicyType)

적용할 Wi-Fi SSID 정책의 유형입니다.
wifiSsids[]

object (WifiSsid)

선택사항입니다. 정책에 적용해야 하는 Wi-Fi SSID 목록입니다. WifiSsidPolicyType이 WIFI_SSID_ALLOWLIST로 설정된 경우 이 필드는 비워둘 수 없습니다. 비어 있지 않은 목록으로 설정된 경우 Android 버전이 13 미만이면 API_LEVEL이 포함된 NonComplianceDetail 세부정보가 보고되고 회사 소유가 아닌 기기의 경우 MANAGEMENT_MODE이 포함된 NonComplianceDetail이 보고됩니다.

WifiSsidPolicyType

기기에 적용할 수 있는 Wi-Fi SSID 정책 유형입니다.

열거형
WIFI_SSID_POLICY_TYPE_UNSPECIFIED 기본값은 WIFI_SSID_DENYLIST입니다. wifiSsids은 설정하면 안 됩니다. 기기가 연결할 수 있는 SSID에는 제한이 없습니다.
WIFI_SSID_DENYLIST 기기가 SSID가 wifiSsids에 있는 Wi-Fi 네트워크에는 연결할 수 없지만 다른 네트워크에는 연결할 수 있습니다.
WIFI_SSID_ALLOWLIST 기기는 wifiSsids의 SSID에만 Wi-Fi 연결을 설정할 수 있습니다. wifiSsids은 비워 둘 수 없습니다. 기기를 다른 Wi-Fi 네트워크에 연결할 수 없습니다.

WifiSsid

Wi-Fi SSID를 나타냅니다.

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

string

필수 항목입니다. 문자열로 표시된 Wi-Fi SSID입니다.

WifiRoamingPolicy

Wi-Fi 로밍 정책입니다.

JSON 표현 
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
필드
wifiRoamingSettings[]

object (WifiRoamingSetting)

선택사항입니다. Wi-Fi 로밍 설정 이 목록에 제공된 SSID는 고유해야 합니다. 그렇지 않으면 정책이 거부됩니다.

WifiRoamingSetting

Wi-Fi 로밍 설정입니다.

JSON 표현 
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
필드
wifiSsid

string

필수 항목입니다. Wi-Fi 네트워크의 SSID입니다.
wifiRoamingMode

enum (WifiRoamingMode)

필수 항목입니다. 지정된 SSID의 Wi-Fi 로밍 모드입니다.

WifiRoamingMode

Wi-Fi 로밍 모드입니다.

열거형
WIFI_ROAMING_MODE_UNSPECIFIED 지정되지 않음. 기본값은 WIFI_ROAMING_DEFAULT입니다.
WIFI_ROAMING_DISABLED Wi-Fi 로밍이 사용 중지되어 있습니다. Android 15 이상에서 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail는 다른 관리 모드에 대해 보고됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
WIFI_ROAMING_DEFAULT 기기의 기본 Wi-Fi 로밍 모드입니다.
WIFI_ROAMING_AGGRESSIVE Wi-Fi 로밍을 더 빠르게 허용하는 적극적인 로밍 모드 Android 15 이상에서 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail는 다른 관리 모드에 대해 보고됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. 기기가 적극적인 로밍 모드를 지원하지 않으면 DEVICE_INCOMPATIBLE이 있는 NonComplianceDetail가 보고됩니다.

BluetoothSharing

블루투스 공유 허용 여부를 제어합니다.

열거형
BLUETOOTH_SHARING_UNSPECIFIED 지정되지 않음. 직장 프로필에서는 BLUETOOTH_SHARING_DISALLOWED, 완전 관리형 기기에서는 BLUETOOTH_SHARING_ALLOWED이 기본값입니다.
BLUETOOTH_SHARING_ALLOWED

블루투스 공유가 허용됩니다.

Android 8 이상에서 지원됩니다. Android 버전이 8 미만인 경우 API_LEVEL이 있는 NonComplianceDetail이 직장 프로필에 보고됩니다.
BLUETOOTH_SHARING_DISALLOWED

블루투스 공유가 허용되지 않습니다.

Android 8 이상에서 지원됩니다. Android 버전이 8 미만인 경우 완전 관리형 기기에서 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다.

PreferentialNetworkServiceSettings

우선 설정 네트워크 서비스 설정입니다.

JSON 표현 
{
  "preferentialNetworkServiceConfigs": [
    {
      object (PreferentialNetworkServiceConfig)
    }
  ],
  "defaultPreferentialNetworkId": enum (PreferentialNetworkId)
}
필드
preferentialNetworkServiceConfigs[]

object (PreferentialNetworkServiceConfig)

필수 항목입니다. 여러 엔터프라이즈 슬라이스를 사용할 수 있도록 하는 우선 네트워크 서비스 구성 동일한 preferentialNetworkId을 사용하는 구성이 여러 개 있으면 안 됩니다. ApplicationPolicy.preferentialNetworkId를 설정하거나 defaultPreferentialNetworkId를 설정하여 구성이 애플리케이션에서 참조되지 않으면 무시됩니다. 4G 네트워크의 기기에서는 우선 네트워크 서비스를 위한 데이터 통화를 설정하기 위해 엔터프라이즈 APN을 추가로 구성해야 합니다. 이러한 APN은 apnPolicy을 사용하여 추가할 수 있습니다.
defaultPreferentialNetworkId

enum (PreferentialNetworkId)

필수 항목입니다. applications에 없는 애플리케이션의 기본 우선 네트워크 ID 또는 ApplicationPolicy.preferentialNetworkId이 PREFERENTIAL_NETWORK_ID_UNSPECIFIED로 설정된 경우 NO_PREFERENTIAL_NETWORK로 설정되지 않은 한 preferentialNetworkServiceConfigs에 지정된 네트워크 ID의 구성이 있어야 합니다. PREFERENTIAL_NETWORK_ID_UNSPECIFIED로 설정하거나 설정하지 않으면 기본값은 NO_PREFERENTIAL_NETWORK입니다. 참고: 기본 우선 네트워크가 잘못 구성된 경우 ApplicationPolicy.preferentialNetworkId가 설정되지 않은 애플리케이션은 인터넷에 액세스할 수 없습니다. 이 설정은 다음 중요 앱에는 적용되지 않습니다.

  • com.google.android.apps.work.clouddpc
  • com.google.android.gms

ApplicationPolicy.preferentialNetworkId을 사용하여 선호 네트워크를 구성할 수 있습니다.

PreferentialNetworkServiceConfig

개별 우선 설정 네트워크 서비스 구성입니다.

JSON 표현 
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
필드
preferentialNetworkId

enum (PreferentialNetworkId)

필수 항목입니다. 우선 네트워크 식별자입니다. NO_PREFERENTIAL_NETWORK 또는 PREFERENTIAL_NETWORK_ID_UNSPECIFIED로 설정하면 안 됩니다. 그렇지 않으면 정책이 거부됩니다.
fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

선택사항입니다. 기기 전체 기본 네트워크로 대체가 허용되는지 여부입니다. 이 값이 FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED로 설정된 경우 nonMatchingNetworks을 NON_MATCHING_NETWORKS_DISALLOWED로 설정하면 안 됩니다. 그렇지 않으면 정책이 거부됩니다. 참고: 5G 슬라이스를 사용할 수 없는 경우 이 값이 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED로 설정되면 애플리케이션이 인터넷에 액세스할 수 없습니다.
nonMatchingNetworks

enum (NonMatchingNetworks)

선택사항입니다. 이 구성이 적용되는 앱이 기본 서비스 이외의 네트워크를 사용하지 못하도록 차단되는지 여부입니다. NON_MATCHING_NETWORKS_DISALLOWED로 설정된 경우 fallbackToDefaultConnection은 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED로 설정해야 합니다.

FallbackToDefaultConnection

기기 전체 기본 네트워크로 대체가 허용되는지 여부입니다. 이 설정은 이 구성의 적용을 받는 앱에 우선 서비스가 없는 경우 기본 네트워크가 있는지 여부를 결정하지만, 앱은 시스템에 요청하여 기본 네트워크가 아닌 다른 네트워크를 사용하도록 명시적으로 결정할 수 있습니다. 이 설정은 앱이 다른 네트워크를 사용하지 못하도록 차단되는지 여부를 결정하지 않습니다. 이 설정은 nonMatchingNetworks를 참고하세요.

열거형
FALLBACK_TO_DEFAULT_CONNECTION_UNSPECIFIED 지정되지 않음. 기본값은 FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED입니다.
FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED 기본 연결로 대체가 허용됩니다. 이 값이 설정된 경우 nonMatchingNetworks을 NON_MATCHING_NETWORKS_DISALLOWED로 설정하면 안 됩니다. 그렇지 않으면 정책이 거부됩니다.
FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED 기본 연결로 대체하는 것은 허용되지 않습니다.

NonMatchingNetworks

이 구성이 적용되는 앱이 기본 서비스 이외의 네트워크를 사용할 수 있는지 여부입니다. 앱은 기기에서 사용 가능한 네트워크 목록을 검사하고 성능, 개인 정보 보호 또는 기타 이유로 여러 네트워크를 동시에 사용하도록 선택할 수 있습니다.

열거형
NON_MATCHING_NETWORKS_UNSPECIFIED 지정되지 않음. 기본값은 NON_MATCHING_NETWORKS_ALLOWED입니다.
NON_MATCHING_NETWORKS_ALLOWED 이 구성이 적용되는 앱은 우선 서비스가 아닌 네트워크를 사용할 수 있습니다.
NON_MATCHING_NETWORKS_DISALLOWED 이 구성이 적용되는 앱은 우선 서비스 이외의 네트워크를 사용할 수 없습니다. Android 14 이상에서 설정할 수 있습니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. 이 값이 설정된 경우 fallbackToDefaultConnection를 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED로 설정해야 합니다. 그렇지 않으면 정책이 거부됩니다.

ApnPolicy

액세스 포인트 네임 (APN) 정책입니다. 액세스 포인트 네임 (APN) 구성으로, 기기의 다른 APN을 재정의할 수 있습니다. 자세한 내용은 OVERRIDE_APNS_ENABLED 및 overrideApns을 참고하세요.

JSON 표현 
{
  "overrideApns": enum (OverrideApns),
  "apnSettings": [
    {
      object (ApnSetting)
    }
  ]
}
필드
overrideApns

enum (OverrideApns)

선택사항입니다. 재정의 APN이 사용 중지되었는지 사용 설정되었는지 여부입니다. 자세한 내용은 DevicePolicyManager.setOverrideApnsEnabled를 참조하세요.
apnSettings[]

object (ApnSetting)

선택사항입니다. 재정의 APN의 APN 설정입니다. 제공된 APN 설정 간에 충돌이 없어야 합니다. 그렇지 않으면 정책이 거부됩니다. 두 ApnSetting의 다음 필드가 모두 일치하면 충돌하는 것으로 간주됩니다. numericOperatorId, apn, proxyAddress, proxyPort, mmsProxyAddress, mmsProxyPort, mmsc, mvnoType, protocol, roamingProtocol 일부 APN 설정으로 인해 INVALID_VALUE을 준수하지 않는 경우 해당 설정은 무시됩니다. 이 설정은 Android 10 이상을 실행하는 완전 관리형 기기에서 설정할 수 있습니다. Android 13 이상의 직장 프로필에서도 설정할 수 있으며 ENTERPRISE APN 유형이 있는 ApnSetting에서만 설정할 수 있습니다. Android 버전이 10 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail는 Android 버전 13 미만의 직장 프로필에 대해 보고됩니다.

OverrideApns

재정의 APN이 사용 중지되었는지 사용 설정되었는지 여부입니다. 자세한 내용은 DevicePolicyManager.setOverrideApnsEnabled를 참조하세요.

열거형
OVERRIDE_APNS_UNSPECIFIED 지정되지 않음. 기본값은 OVERRIDE_APNS_DISABLED입니다.
OVERRIDE_APNS_DISABLED APN 재정의가 사용 중지되었습니다. 구성된 apnSettings는 기기에 저장되지만 사용 중지되어 적용되지 않습니다. 기기의 다른 APN은 계속 사용됩니다.
OVERRIDE_APNS_ENABLED APN 재정의가 사용 설정되었습니다. 재정의된 APN만 사용되고 다른 APN은 무시됩니다. 이 설정은 Android 10 이상의 완전 관리형 기기에서만 설정할 수 있습니다. 직장 프로필의 경우 preferentialNetworkServiceSettings를 통해 재정의 APN이 사용 설정되며 이 값을 설정할 수 없습니다. Android 버전이 10 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.

ApnSetting

이동통신사 데이터 연결의 액세스 포인트 이름 (APN) 구성입니다. APN은 셀룰러 네트워크 기기를 IP 데이터 네트워크에 연결하기 위한 구성을 제공합니다. 이 설정은 이동통신사가 할당할 IP 주소, 적용할 보안 방법, 기기가 비공개 네트워크에 연결되는 방식을 결정하는 데 사용됩니다.

JSON 표현 
{
  "apnTypes": [
    enum (ApnType)
  ],
  "apn": string,
  "displayName": string,
  "alwaysOnSetting": enum (AlwaysOnSetting),
  "authType": enum (AuthType),
  "carrierId": integer,
  "mmsProxyAddress": string,
  "mmsProxyPort": integer,
  "mmsc": string,
  "mtuV4": integer,
  "mtuV6": integer,
  "mvnoType": enum (MvnoType),
  "networkTypes": [
    enum (NetworkType)
  ],
  "username": string,
  "password": string,
  "numericOperatorId": string,
  "protocol": enum (Protocol),
  "roamingProtocol": enum (Protocol),
  "proxyAddress": string,
  "proxyPort": integer
}
필드
apnTypes[]

enum (ApnType)

필수 항목입니다. APN의 사용 카테고리입니다. 이 필드가 비어 있거나 APN_TYPE_UNSPECIFIED 또는 중복이 포함되어 있으면 정책이 거부됩니다. 완전 관리형 기기에서 여러 APN 유형을 설정할 수 있습니다. ENTERPRISE은 직장 프로필에서 허용되는 유일한 APN 유형입니다. 직장 프로필의 다른 값에 대해서는 MANAGEMENT_MODE이 있는 NonComplianceDetail이 보고됩니다. 기기 또는 관리 모드에서 지원되지 않는 APN 유형은 무시됩니다. 이로 인해 목록이 비어 있으면 apnTypes은 필수 필드이므로 APN 설정이 무시됩니다. INVALID_VALUE이 있는 NonComplianceDetail은 기기 또는 관리 모드에서 지원되는 APN 유형이 없는 경우 보고됩니다.
apn

string

필수 항목입니다. APN 이름입니다. 이 필드가 비어 있으면 정책이 거부됩니다.
displayName

string

필수 항목입니다. APN을 설명하는 사람이 읽을 수 있는 이름입니다. 이 필드가 비어 있으면 정책이 거부됩니다.
alwaysOnSetting

enum (AlwaysOnSetting)

선택사항입니다. 이 APN의 경우 CM-IDLE 모드에서 CM-CONNECTED 상태로 전환될 때마다 사용자 평면 리소스를 활성화해야 하는지 여부입니다. 3GPP TS 23.501 섹션 5.6.13을 참고하세요.
authType

enum (AuthType)

선택사항입니다. APN의 인증 유형입니다.
carrierId

integer

선택사항입니다. APN의 이동통신사 ID입니다. 값 0 (기본값)은 설정되지 않음을 의미하며 음수 값은 거부됩니다.
mmsProxyAddress

string

선택사항입니다. APN의 MMS (멀티미디어 메시지 서비스) 프록시 주소입니다. IP 주소 또는 호스트 이름 (URL 아님)일 수 있습니다.
mmsProxyPort

integer

선택사항입니다. APN의 MMS (멀티미디어 메시지 서비스) 프록시 포트입니다. 값 0 (기본값)은 설정되지 않음을 의미하며 음수 값은 거부됩니다.
mmsc

string

선택사항입니다. APN의 MMSC (멀티미디어 메시지 서비스 센터) URI입니다.
mtuV4

integer

선택사항입니다. 이 APN 설정으로 가져온 IPv4 경로의 기본 MTU(최대 전송 단위) 크기(바이트)입니다. 값 0 (기본값)은 설정되지 않음을 의미하며 음수 값은 거부됩니다. Android 13 이상에서 지원됩니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
mtuV6

integer

선택사항입니다. APN이 연결된 IPv6 모바일 인터페이스의 MTU (최대 전송 단위) 크기입니다. 값 0 (기본값)은 설정되지 않음을 의미하며 음수 값은 거부됩니다. Android 13 이상에서 지원됩니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
mvnoType

enum (MvnoType)

선택사항입니다. APN의 MVNO 일치 유형입니다.
networkTypes[]

enum (NetworkType)

선택사항입니다. APN이 사용할 수 있는 무선 기술 (네트워크 유형)입니다. 이 필드에 NETWORK_TYPE_UNSPECIFIED 또는 중복이 포함된 경우 정책이 거부됩니다.
username

string

선택사항입니다. APN의 APN 사용자 이름입니다.
password

string

선택사항입니다. APN의 APN 비밀번호입니다.
numericOperatorId

string

선택사항입니다. APN의 숫자 운영자 ID입니다. 숫자 연산자 ID는 MCC (모바일 국가 코드) + MNC (모바일 네트워크 코드)로 정의됩니다.
protocol

enum (Protocol)

선택사항입니다. 이 APN에 연결하는 데 사용할 프로토콜입니다.
roamingProtocol

enum (Protocol)

선택사항입니다. 기기가 로밍 중일 때 이 APN에 연결하는 데 사용할 프로토콜입니다.
proxyAddress

string

선택사항입니다. APN의 프록시 주소입니다.
proxyPort

integer

선택사항입니다. APN의 프록시 포트입니다. 값 0 (기본값)은 설정되지 않음을 의미하며 음수 값은 거부됩니다.

ApnType

APN의 사용 카테고리입니다.

열거형
APN_TYPE_UNSPECIFIED 지정되지 않음. 이 값은 사용되지 않습니다.
ENTERPRISE 엔터프라이즈 트래픽의 APN 유형입니다. Android 13 이상에서 지원됩니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
BIP BIP (베어러 독립 프로토콜)의 APN 유형입니다. 이 설정은 Android 12 이상의 완전 관리형 기기에서만 설정할 수 있습니다. Android 버전이 12 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
CBS CBS (운송업체 브랜드 서비스)의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
DEFAULT 기본 데이터 트래픽의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
DUN DUN (다이얼업 네트워킹) 트래픽의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
EMERGENCY 긴급 PDN의 APN 유형입니다. IA APN은 아니지만 긴급 전화 상황에서 이동통신사 서비스에 액세스하는 데 사용됩니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
FOTA 무선 업데이트에 사용되는 이동통신사의 FOTA (Firmware Over-the-Air) 포털에 액세스하는 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
HIPRI HiPri (높은 우선순위) 트래픽의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
IA IA (초기 연결) APN의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
IMS IMS (IP 멀티미디어 하위 시스템) 트래픽의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
MCX X가 PTT/동영상/데이터일 수 있는 MCX (미션 크리티컬 서비스)의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
MMS MMS (멀티미디어 메시지 서비스) 트래픽의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
RCS RCS (Rich Communication Services)의 APN 유형입니다. 이 설정은 Android 15 이상의 완전 관리형 기기에서만 설정할 수 있습니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
SUPL SUPL (Secure User Plane Location) 지원 GPS의 APN 유형입니다. 이 설정은 완전 관리형 기기에서만 설정할 수 있습니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
VSIM VSIM (가상 SIM) 서비스의 APN 유형입니다. 이 설정은 Android 12 이상의 완전 관리형 기기에서만 설정할 수 있습니다. Android 버전이 12 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.
XCAP XCAP (XML 구성 액세스 프로토콜) 트래픽의 APN 유형입니다. 이 설정은 Android 11 이상의 완전 관리형 기기에서만 설정할 수 있습니다. Android 버전이 11 미만이면 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다. MANAGEMENT_MODE이 있는 NonComplianceDetail이 직장 프로필에 대해 보고됩니다.

AlwaysOnSetting

이 APN의 경우 CM-IDLE 모드에서 CM-CONNECTED 상태로 전환될 때마다 사용자 평면 리소스를 활성화해야 하는지 여부입니다. 3GPP TS 23.501 섹션 5.6.13을 참고하세요.

열거형
ALWAYS_ON_SETTING_UNSPECIFIED 지정되지 않음. 기본값은 NOT_ALWAYS_ON입니다.
NOT_ALWAYS_ON 이 APN에 의해 가져온 PDU 세션은 항상 사용 설정되어 있으면 안 됩니다.
ALWAYS_ON 이 APN에 의해 실행된 PDU 세션은 항상 사용 설정되어 있어야 합니다. Android 15 이상에서 지원됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

AuthType

APN의 인증 유형입니다.

열거형
AUTH_TYPE_UNSPECIFIED 지정되지 않음. username이 비어 있으면 기본값은 NONE입니다. 그렇지 않으면 기본값은 PAP_OR_CHAP입니다.
NONE 인증이 필요하지 않습니다.
PAP PAP의 인증 유형입니다.
CHAP CHAP의 인증 유형입니다.
PAP_OR_CHAP PAP 또는 CHAP의 인증 유형입니다.

MvnoType

APN의 MVNO 일치 유형입니다.

열거형
MVNO_TYPE_UNSPECIFIED MVNO 유형이 지정되지 않았습니다.
GID 그룹 식별자 수준 1의 MVNO 유형입니다.
ICCID ICCID의 MVNO 유형입니다.
IMSI IMSI의 MVNO 유형입니다.
SPN SPN (서비스 제공업체 이름)의 MVNO 유형입니다.

NetworkType

APN이 사용할 수 있는 무선 기술 (네트워크 유형)입니다.

열거형
NETWORK_TYPE_UNSPECIFIED 지정되지 않음. 이 값은 사용하면 안 됩니다.
EDGE 무선 기술 EDGE
GPRS 무선 기술 GPRS
GSM 무선 기술 GSM
HSDPA 무선 기술 HSDPA
HSPA 라디오 기술 HSPA
HSPAP 라디오 기술 HSPAP
HSUPA 라디오 기술 HSUPA
IWLAN 무선 기술 IWLAN
LTE 무선 기술 LTE
NR 무선 기술 NR (New Radio) 5G
TD_SCDMA 무선 기술 TD_SCDMA
UMTS 라디오 기술 UMTS

프로토콜

APN에 연결하는 데 사용할 프로토콜입니다.

열거형
PROTOCOL_UNSPECIFIED 프로토콜이 지정되지 않았습니다.
IP 인터넷 프로토콜입니다.
IPV4V6 이중 IP 스택 UE 기능을 처리하기 위해 가상 PDP 유형이 도입되었습니다.
IPV6 인터넷 프로토콜 버전 6
NON_IP 비 IP 데이터를 외부 패킷 데이터 네트워크로 전송
PPP 점대점 프로토콜입니다.
UNSTRUCTURED N6를 통해 비정형 데이터를 데이터 네트워크로 전송

DeviceRadioState

기기 라디오 설정 컨트롤

JSON 표현 
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel)
}
필드
wifiState

enum (WifiState)

Wi-Fi의 현재 상태와 사용자가 상태를 변경할 수 있는지 여부를 제어합니다.
airplaneModeState

enum (AirplaneModeState)

사용자가 비행기 모드를 전환할 수 있는지 여부를 제어합니다.
ultraWidebandState

enum (UltraWidebandState)

초광대역 설정의 상태와 사용자가 사용 설정 또는 사용 중지할 수 있는지를 제어합니다.
cellularTwoGState

enum (CellularTwoGState)

사용자가 모바일 2G 설정을 전환할 수 있는지 여부를 제어합니다.
minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

기기가 연결할 수 있는 Wi-Fi 네트워크의 최소 보안 수준입니다.

WifiState

Wi-Fi가 상태로 사용 설정되어 있는지 사용 중지되어 있는지와 사용자가 해당 상태를 변경할 수 있는지를 제어합니다. Android 13 이상을 실행하는 회사 소유 기기에서 지원됩니다.

열거형
WIFI_STATE_UNSPECIFIED 지정되지 않음. 기본값은 WIFI_STATE_USER_CHOICE입니다.
WIFI_STATE_USER_CHOICE 사용자가 Wi-Fi를 사용 설정/중지할 수 있습니다.
WIFI_ENABLED Wi-Fi가 켜져 있고 사용자가 Wi-Fi를 끌 수 없습니다. Android 버전이 13 미만인 경우 API_LEVEL이 있는 NonComplianceDetail가 보고됩니다.
WIFI_DISABLED Wi-Fi가 꺼져 있으며 사용자가 이를 켤 수 없습니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

AirplaneModeState

비행기 모드의 상태와 사용자가 비행기 모드를 사용 설정 또는 사용 중지할 수 있는지를 제어합니다. Android 9 이상에서 지원됩니다. 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다.

열거형
AIRPLANE_MODE_STATE_UNSPECIFIED 지정되지 않음. 기본값은 AIRPLANE_MODE_USER_CHOICE입니다.
AIRPLANE_MODE_USER_CHOICE 사용자가 비행기 모드를 사용 설정 또는 사용 중지할 수 있습니다.
AIRPLANE_MODE_DISABLED 비행기 모드가 사용 중지되어 있습니다. 사용자가 비행기 모드를 사용 설정할 수 없습니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

UltraWidebandState

초광대역 설정의 상태와 사용자가 사용 설정 또는 사용 중지로 전환할 수 있는지를 제어합니다. Android 14 이상에서 지원됩니다. 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다.

열거형
ULTRA_WIDEBAND_STATE_UNSPECIFIED 지정되지 않음. 기본값은 ULTRA_WIDEBAND_USER_CHOICE입니다.
ULTRA_WIDEBAND_USER_CHOICE 사용자는 초광대역을 사용 설정 또는 사용 중지할 수 있습니다.
ULTRA_WIDEBAND_DISABLED 초광대역이 사용 중지되어 있습니다. 사용자는 설정을 통해 초광대역을 전환할 수 없습니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

CellularTwoGState

휴대전화 2G 설정의 상태와 사용자가 사용 설정 또는 사용 중지할 수 있는지를 제어합니다. Android 14 이상에서 지원됩니다. 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다.

열거형
CELLULAR_TWO_G_STATE_UNSPECIFIED 지정되지 않음. 기본값은 CELLULAR_TWO_G_USER_CHOICE입니다.
CELLULAR_TWO_G_USER_CHOICE 사용자가 모바일 2G를 사용 설정 또는 중지할 수 있습니다.
CELLULAR_TWO_G_DISABLED 모바일 2G가 사용 중지되었습니다. 사용자는 설정을 통해 모바일 2G를 사용 설정할 수 없습니다. Android 버전이 14 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

MinimumWifiSecurityLevel

Wi-Fi 네트워크에 연결하는 데 필요한 다양한 최소 Wi-Fi 보안 수준을 정의합니다. Android 13 이상에서 지원됩니다. 완전 관리형 기기 및 회사 소유 기기의 직장 프로필에서 지원됩니다.

열거형
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED 기본값은 OPEN_NETWORK_SECURITY이며, 이는 기기가 모든 유형의 Wi-Fi 네트워크에 연결할 수 있음을 의미합니다.
OPEN_NETWORK_SECURITY 기기가 모든 유형의 Wi-Fi 네트워크에 연결될 수 있습니다.
PERSONAL_NETWORK_SECURITY WEP, WPA2-PSK와 같은 개인 네트워크가 최소 보안 요건입니다. 기기를 개방형 Wi-Fi 네트워크에 연결할 수 없습니다. 이는 OPEN_NETWORK_SECURITY보다 엄격합니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
ENTERPRISE_NETWORK_SECURITY 엔터프라이즈 EAP 네트워크는 최소 요구 보안 수준입니다. 이 보안 수준 미만의 Wi-Fi 네트워크에는 기기를 연결할 수 없습니다. 이는 PERSONAL_NETWORK_SECURITY보다 엄격합니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
ENTERPRISE_BIT192_NETWORK_SECURITY 192비트 엔터프라이즈 네트워크가 요구되는 최소 보안 수준입니다. 이 보안 수준 미만의 Wi-Fi 네트워크에는 기기를 연결할 수 없습니다. 이는 ENTERPRISE_NETWORK_SECURITY보다 엄격합니다. Android 버전이 13 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

CredentialProviderPolicyDefault

Android 14 이상에서 사용자 인증 정보 제공업체로 작동할 수 있는 앱을 제어합니다. 이러한 앱은 사용자 인증 정보를 저장합니다. 자세한 내용은 이 페이지와 이 페이지를 참고하세요. credentialProviderPolicy도 참고하세요.

열거형
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED 지정되지 않음. 기본값은 CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED입니다.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED credentialProviderPolicy가 지정되지 않은 앱은 사용자 인증 정보 제공자로 작동할 수 없습니다.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM credentialProviderPolicy가 지정되지 않은 앱은 OEM 기본 사용자 인증 정보 제공업체를 제외하고 사용자 인증 정보 제공업체로 작동할 수 없습니다. OEM 기본 사용자 인증 정보 제공자는 항상 사용자 인증 정보 제공자 역할을 할 수 있습니다.

PrintingPolicy

인쇄 허용 여부를 제어합니다. 이 기능은 Android 9 이상을 실행하는 기기에서 지원됩니다.

열거형
PRINTING_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 PRINTING_ALLOWED입니다.
PRINTING_DISALLOWED 인쇄가 허용되지 않습니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
PRINTING_ALLOWED 인쇄가 허용됩니다.

DisplaySettings

디스플레이 설정 컨트롤입니다.

JSON 표현 
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
필드
screenBrightnessSettings

object (ScreenBrightnessSettings)

선택사항입니다. 화면 밝기 설정을 제어합니다.
screenTimeoutSettings

object (ScreenTimeoutSettings)

선택사항입니다. 화면 자동 잠금 시간 설정을 제어합니다.

ScreenBrightnessSettings

화면 밝기 설정 제어

JSON 표현 
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
필드
screenBrightnessMode

enum (ScreenBrightnessMode)

선택사항입니다. 화면 밝기 모드를 제어합니다.
screenBrightness

integer

선택사항입니다. 화면 밝기입니다. 1은 가장 낮은 밝기이고 255는 가장 높은 밝기입니다. 값 0 (기본값)은 화면 밝기가 설정되지 않았음을 의미합니다. 다른 값은 거부됩니다. 이를 설정하려면 screenBrightnessMode이 BRIGHTNESS_AUTOMATIC 또는 BRIGHTNESS_FIXED이어야 합니다. 완전 관리형 기기의 Android 9 이상에서 지원됩니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 15 이상의 회사 소유 기기의 직장 프로필에서 지원됩니다.

ScreenBrightnessMode

화면 밝기 모드를 제어합니다.

열거형
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED 지정되지 않음. 기본값은 BRIGHTNESS_USER_CHOICE입니다.
BRIGHTNESS_USER_CHOICE 사용자가 화면 밝기를 구성할 수 있습니다. screenBrightness은 설정하면 안 됩니다.
BRIGHTNESS_AUTOMATIC 화면 밝기 모드는 밝기가 자동으로 조정되며 사용자가 화면 밝기를 구성할 수 없는 자동입니다. screenBrightness는 계속 설정할 수 있으며 밝기가 자동으로 조정되는 동안 고려됩니다. 완전 관리형 기기의 Android 9 이상에서 지원됩니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 15 이상의 회사 소유 기기의 직장 프로필에서 지원됩니다.
BRIGHTNESS_FIXED 화면 밝기 모드가 고정되어 밝기가 screenBrightness로 설정되고 사용자가 화면 밝기를 구성할 수 없습니다. screenBrightness을 설정해야 합니다. 완전 관리형 기기의 Android 9 이상에서 지원됩니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 15 이상의 회사 소유 기기의 직장 프로필에서 지원됩니다.

ScreenTimeoutSettings

화면 자동 잠금 시간 설정을 제어합니다.

JSON 표현 
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
필드
screenTimeoutMode

enum (ScreenTimeoutMode)

선택사항입니다. 사용자가 화면 자동 잠금 시간을 구성할 수 있는지 여부를 제어합니다.
screenTimeout

string (Duration format)

선택사항입니다. 화면 자동 잠금 시간을 제어합니다. 화면 제한 시간은 0보다 커야 합니다. 그렇지 않으면 거부됩니다. 또한 maximumTimeToLock보다 커서는 안 됩니다. 그렇지 않으면 화면 제한 시간이 maximumTimeToLock로 설정되고 INVALID_VALUE 이유와 SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK 특정 이유가 있는 NonComplianceDetail가 보고됩니다. 화면 제한 시간이 특정 하한보다 작으면 하한으로 설정됩니다. 하한은 기기에 따라 다를 수 있습니다. 이 값이 설정된 경우 screenTimeoutMode은 SCREEN_TIMEOUT_ENFORCED이어야 합니다. 완전 관리형 기기의 Android 9 이상에서 지원됩니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 15 이상의 회사 소유 기기의 직장 프로필에서 지원됩니다.

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

ScreenTimeoutMode

사용자가 화면 자동 잠금 시간을 구성할 수 있는지 여부를 제어합니다.

열거형
SCREEN_TIMEOUT_MODE_UNSPECIFIED 지정되지 않음. 기본값은 SCREEN_TIMEOUT_USER_CHOICE입니다.
SCREEN_TIMEOUT_USER_CHOICE 사용자가 화면 제한 시간을 구성할 수 있습니다. screenTimeout은 설정하면 안 됩니다.
SCREEN_TIMEOUT_ENFORCED 화면 제한 시간이 screenTimeout로 설정되어 있으며 사용자가 제한 시간을 구성할 수 없습니다. screenTimeout을 설정해야 합니다. 완전 관리형 기기의 Android 9 이상에서 지원됩니다. Android 버전이 9 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 15 이상의 회사 소유 기기의 직장 프로필에서 지원됩니다.

AssistContentPolicy

AssistContent를 어시스턴트 앱과 같은 권한이 있는 앱에 전송할 수 있는지 제어합니다. AssistContent에는 스크린샷과 패키지 이름과 같은 앱 정보가 포함됩니다. 이 기능은 Android 15 이상에서 지원됩니다.

열거형
ASSIST_CONTENT_POLICY_UNSPECIFIED 지정되지 않음. 기본값은 ASSIST_CONTENT_ALLOWED입니다.
ASSIST_CONTENT_DISALLOWED

지원 콘텐츠가 권한이 있는 앱으로 전송되지 않도록 차단됩니다.

Android 15 이상에서 지원됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.
ASSIST_CONTENT_ALLOWED

지원 콘텐츠는 권한이 있는 앱에 전송할 수 있습니다.

Android 15 이상에서 지원됩니다.

WorkAccountSetupConfig

Google 인증 계정이 필요한지 여부와 같은 직장 계정 설정 구성을 제어합니다.

JSON 표현 
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
필드
authenticationType

enum (AuthenticationType)

선택사항입니다. 기기에서 사용자의 인증 유형입니다.
requiredAccountEmail

string

선택사항입니다. 추가할 특정 Google 직장 계정 이메일 주소입니다. 이 필드는 authenticationType이 GOOGLE_AUTHENTICATED인 경우에만 관련이 있습니다. 기업 계정이어야 하며 소비자 계정은 안 됩니다. 설정되고 Google 인증 계정이 기기에 추가되면 이 필드를 변경해도 아무런 영향을 미치지 않으므로 한 번만 설정하는 것이 좋습니다.

AuthenticationType

기기에서 사용자의 인증 유형입니다.

열거형
AUTHENTICATION_TYPE_UNSPECIFIED 지정되지 않음. 기본값은 AUTHENTICATION_TYPE_NOT_ENFORCED입니다.
AUTHENTICATION_TYPE_NOT_ENFORCED 기기에서 사용자의 인증 상태가 적용되지 않습니다.
GOOGLE_AUTHENTICATED Google 인증 계정으로 기기를 관리해야 합니다.

WipeDataFlag

어떤 이유로든 기기 또는 프로필 초기화가 트리거될 때 삭제되는 데이터를 나타내는 플래그를 삭제합니다. (예: 기기가 정책을 준수하지 않는 경우) enterprises.devices.delete 메서드에는 적용되지 않습니다.

열거형
WIPE_DATA_FLAG_UNSPECIFIED 이 값은 사용하면 안 됩니다.
WIPE_ESIMS 회사 소유 기기의 경우 wipeDataFlags에서 이 설정을 지정하면 어떤 이유로든 초기화가 트리거될 때 기기의 모든 eSIM이 삭제됩니다. 개인 소유 기기에서는 기기의 관리 eSIM만 삭제됩니다. (ADD_ESIM 명령어를 통해 추가된 eSIM) 이 기능은 Android 15 이상을 실행하는 기기에서 지원됩니다. Android 버전이 15 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다.

EnterpriseDisplayNameVisibility

enterpriseDisplayName이 기기에 표시되는지 여부를 제어합니다 (예: 회사 소유 기기의 잠금 화면 메시지).

열거형
ENTERPRISE_DISPLAY_NAME_VISIBILITY_UNSPECIFIED 지정되지 않음. 기기 설정 시 설정된 엔터프라이즈 이름을 기본적으로 표시합니다. 향후에는 기본값이 ENTERPRISE_DISPLAY_NAME_VISIBLE로 설정됩니다.
ENTERPRISE_DISPLAY_NAME_VISIBLE 엔터프라이즈 표시 이름이 기기에 표시됩니다. Android 7 이상의 직장 프로필에서 지원됩니다. Android 8 이상에서 완전 관리 기기에서 지원됩니다. Android 버전이 7 미만이면 API_LEVEL이 있는 NonComplianceDetail이 보고됩니다. Android 7의 완전 관리형 기기에서 MANAGEMENT_MODE이 있는 NonComplianceDetail가 보고됩니다.
ENTERPRISE_DISPLAY_NAME_HIDDEN 엔터프라이즈 표시 이름이 기기에 숨겨집니다.

AppFunctions

완전 관리형 기기의 앱 또는 직장 프로필이 있는 기기의 직장 프로필에 있는 앱이 앱 기능을 노출하도록 허용할지 여부를 제어합니다.

열거형
APP_FUNCTIONS_UNSPECIFIED 지정되지 않음. 기본값은 APP_FUNCTIONS_ALLOWED입니다.
APP_FUNCTIONS_DISALLOWED 완전 관리형 기기의 기기 또는 직장 프로필이 있는 기기의 직장 프로필에 있는 앱은 앱 기능을 노출할 수 없습니다. 이 값이 설정된 경우 crossProfileAppFunctions을 CROSS_PROFILE_APP_FUNCTIONS_ALLOWED로 설정하면 안 됩니다. 그렇지 않으면 정책이 거부됩니다.
APP_FUNCTIONS_ALLOWED 완전 관리형 기기의 기기 또는 직장 프로필이 있는 기기의 직장 프로필에 있는 앱은 앱 기능을 노출할 수 있습니다.

메서드

delete

 정책을 삭제합니다.

get

 정책을 가져옵니다.

list

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

modifyPolicyApplications

 정책에서 애플리케이션을 업데이트하거나 만듭니다.

patch

 정책을 업데이트하거나 생성합니다.

removePolicyApplications

 정책에서 애플리케이션을 삭제합니다.