MCP Tools Reference: Android Device Management MCP Server

Alat: list_policies

Mencantumkan kebijakan untuk perusahaan tertentu. Memerlukan nama resource perusahaan di kolom induk (misalnya, enterprises/{enterpriseId}).

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_policies.

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

Skema Input

Permintaan untuk mencantumkan kebijakan untuk perusahaan tertentu.

ListPoliciesRequest

Representasi JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Kolom
parent

string

Nama perusahaan dalam bentuk enterprises/{enterpriseId}.

pageSize

integer

Ukuran halaman yang diminta. Ukuran halaman sebenarnya dapat ditetapkan ke nilai minimum atau maksimum.

pageToken

string

Token yang mengidentifikasi halaman hasil yang ditampilkan oleh server.

Skema Output

Respons terhadap permintaan untuk mencantumkan kebijakan untuk perusahaan tertentu.

ListPoliciesResponse

Representasi JSON
{
  "policies": [
    {
      object (Policy)
    }
  ],
  "nextPageToken": string
}
Kolom
policies[]

object (Policy)

Daftar kebijakan.

nextPageToken

string

Jika ada lebih banyak hasil, token untuk mengambil halaman hasil berikutnya.

Kebijakan

Representasi 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),
  "defaultApplicationSettings": [
    {
      object (DefaultApplicationSetting)
    }
  ]
}
Kolom
name

string

Nama kebijakan dalam bentuk enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

Versi kebijakan. Kolom ini bersifat hanya baca. Versi akan bertambah setiap kali kebijakan diperbarui.

applications[]

object (ApplicationPolicy)

Kebijakan yang diterapkan ke aplikasi. Array ini dapat memiliki maksimal 3.000 elemen.

maximumTimeToLock

string (int64 format)

Waktu maksimum dalam milidetik untuk aktivitas pengguna hingga perangkat terkunci. Nilai 0 berarti tidak ada batasan.

screenCaptureDisabled

boolean

Apakah screenshot dinonaktifkan.

cameraDisabled
(deprecated)

boolean

Jika camera_access disetel ke nilai selain CAMERA_ACCESS_UNSPECIFIED, hal ini tidak akan berpengaruh. Jika tidak, kolom ini mengontrol apakah kamera dinonaktifkan: Jika benar (true), semua kamera dinonaktifkan, jika tidak, kamera tersedia. Untuk perangkat terkelola sepenuhnya, kolom ini berlaku untuk semua aplikasi di perangkat. Untuk profil kerja, kolom ini hanya berlaku untuk aplikasi di profil kerja, dan akses kamera aplikasi di luar profil kerja tidak terpengaruh.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

Menonaktifkan penyesuaian keyguard, seperti widget.

defaultPermissionPolicy

enum (PermissionPolicy)

Kebijakan izin default untuk permintaan izin runtime.

persistentPreferredActivities[]

object (PersistentPreferredActivity)

Aktivitas handler intent default.

openNetworkConfiguration

object (Struct format)

Konfigurasi jaringan untuk perangkat. Lihat mengonfigurasi jaringan untuk mengetahui informasi selengkapnya.

systemUpdate

object (SystemUpdate)

Kebijakan update sistem, yang mengontrol cara update OS diterapkan. Jika jenis update adalah WINDOWED, jendela update juga akan otomatis diterapkan ke update aplikasi Play.

Catatan: Update sistem Google Play (juga disebut update Utama) akan otomatis didownload dan perangkat harus dimulai ulang untuk menginstalnya. Lihat bagian utama di Mengelola update sistem untuk mengetahui detail selengkapnya.

accountTypesWithManagementDisabled[]

string

Jenis akun yang tidak dapat dikelola oleh pengguna.

addUserDisabled

boolean

Apakah penambahan pengguna dan profil baru dinonaktifkan. Untuk perangkat yang managementMode-nya DEVICE_OWNER, kolom ini diabaikan dan pengguna tidak pernah diizinkan untuk menambahkan atau menghapus pengguna.

adjustVolumeDisabled

boolean

Apakah penyesuaian volume utama dinonaktifkan. Juga membisukan perangkat. Setelan ini hanya berlaku pada perangkat yang terkelola sepenuhnya.

factoryResetDisabled

boolean

Apakah reset ke setelan pabrik dari setelan dinonaktifkan.

installAppsDisabled

boolean

Apakah penginstalan aplikasi oleh pengguna dinonaktifkan.

mountPhysicalMediaDisabled

boolean

Apakah pengguna yang memasang media eksternal fisik dinonaktifkan.

modifyAccountsDisabled

boolean

Apakah menambahkan atau menghapus akun dinonaktifkan.

safeBootDisabled
(deprecated)

boolean

Apakah memulai ulang perangkat ke booting aman dinonaktifkan.

uninstallAppsDisabled

boolean

Apakah peng-uninstalan aplikasi oleh pengguna dinonaktifkan. Tindakan ini mencegah aplikasi di-uninstal, bahkan aplikasi yang dihapus menggunakan applications

statusBarDisabled
(deprecated)

boolean

Apakah status bar dinonaktifkan. Tindakan ini akan menonaktifkan notifikasi, setelan cepat, dan overlay layar lainnya yang memungkinkan keluar dari mode layar penuh. TIDAK DIGUNAKAN LAGI. Untuk menonaktifkan status bar di perangkat kios, gunakan InstallType KIOSK atau kioskCustomLauncherEnabled.

keyguardDisabled

boolean

Jika benar (true), setelan ini akan menonaktifkan Layar Kunci untuk tampilan utama dan/atau sekunder. Kebijakan ini hanya didukung dalam mode pengelolaan perangkat khusus.

minimumApiLevel

integer

Level API Android minimum yang diizinkan.

statusReportingSettings

object (StatusReportingSettings)

Setelan pelaporan status

bluetoothContactSharingDisabled

boolean

Apakah berbagi kontak melalui bluetooth dinonaktifkan.

shortSupportMessage

object (UserFacingMessage)

Pesan yang ditampilkan kepada pengguna di layar setelan di mana pun fungsi telah dinonaktifkan oleh admin. Jika panjang pesan lebih dari 200 karakter, pesan tersebut mungkin akan terpotong.

longSupportMessage

object (UserFacingMessage)

Pesan yang ditampilkan kepada pengguna di layar setelan administrator perangkat.

passwordRequirements
(deprecated)

object (PasswordRequirements)

Persyaratan sandi. Kolom password_requirements.require_password_unlock tidak boleh disetel. TIDAK DIGUNAKAN LAGI - Gunakan passwordPolicies.

Catatan:

Nilai berbasis kompleksitas PasswordQuality, yaitu COMPLEXITY_LOW, COMPLEXITY_MEDIUM, dan COMPLEXITY_HIGH, tidak dapat digunakan di sini. unified_lock_settings tidak dapat digunakan di sini.

wifiConfigsLockdownEnabled
(deprecated)

boolean

Tidak digunakan lagi.

bluetoothConfigDisabled

boolean

Apakah konfigurasi bluetooth dinonaktifkan.

cellBroadcastsConfigDisabled

boolean

Apakah konfigurasi siaran seluler dinonaktifkan.

credentialsConfigDisabled

boolean

Apakah konfigurasi kredensial pengguna dinonaktifkan.

mobileNetworksConfigDisabled

boolean

Apakah konfigurasi jaringan seluler dinonaktifkan.

tetheringConfigDisabled
(deprecated)

boolean

Apakah konfigurasi tethering dan hotspot portabel dinonaktifkan. Jika tetheringSettings ditetapkan ke nilai selain TETHERING_SETTINGS_UNSPECIFIED, setelan ini akan diabaikan.

vpnConfigDisabled

boolean

Apakah konfigurasi VPN dinonaktifkan.

wifiConfigDisabled
(deprecated)

boolean

Apakah konfigurasi jaringan Wi-Fi dinonaktifkan. Didukung di perangkat yang terkelola sepenuhnya dan profil kerja di perangkat milik perusahaan. Untuk perangkat yang dikelola sepenuhnya, menyetelnya ke benar (true) akan menghapus semua jaringan yang dikonfigurasi dan hanya mempertahankan jaringan yang dikonfigurasi menggunakan openNetworkConfiguration. Untuk profil kerja di perangkat milik perusahaan, jaringan yang sudah dikonfigurasi tidak terpengaruh dan pengguna tidak diizinkan untuk menambahkan, menghapus, atau mengubah jaringan Wi-Fi. Jika configureWifi ditetapkan ke nilai selain CONFIGURE_WIFI_UNSPECIFIED, setelan ini akan diabaikan. Catatan: Jika koneksi jaringan tidak dapat dibuat saat waktu booting dan konfigurasi Wi-Fi dinonaktifkan, maka tombol keluar jaringan akan ditampilkan untuk memperbarui kebijakan perangkat (lihat networkEscapeHatchEnabled).

createWindowsDisabled

boolean

Apakah pembuatan jendela selain jendela aplikasi dinonaktifkan.

networkResetDisabled

boolean

Apakah mereset setelan jaringan dinonaktifkan.

outgoingBeamDisabled

boolean

Apakah penggunaan NFC untuk mengirimkan data dari aplikasi dinonaktifkan.

outgoingCallsDisabled

boolean

Apakah panggilan keluar dinonaktifkan.

removeUserDisabled

boolean

Apakah penghapusan pengguna lain dinonaktifkan.

shareLocationDisabled

boolean

Apakah berbagi lokasi dinonaktifkan.

smsDisabled

boolean

Apakah pengiriman dan penerimaan pesan SMS dinonaktifkan.

unmuteMicrophoneDisabled
(deprecated)

boolean

Jika microphone_access disetel ke nilai selain MICROPHONE_ACCESS_UNSPECIFIED, hal ini tidak akan berpengaruh. Jika tidak, kolom ini mengontrol apakah mikrofon dinonaktifkan: Jika benar (true), semua mikrofon dinonaktifkan, jika tidak, mikrofon akan tersedia. Fitur ini hanya tersedia di perangkat yang terkelola sepenuhnya.

usbFileTransferDisabled
(deprecated)

boolean

Apakah transfer file melalui USB dinonaktifkan. Fitur ini hanya didukung di perangkat milik perusahaan.

ensureVerifyAppsEnabled
(deprecated)

boolean

Apakah verifikasi aplikasi diaktifkan secara paksa.

permittedInputMethods

object (PackageNameList)

Jika ada, hanya metode input yang disediakan oleh paket dalam daftar ini yang diizinkan. Jika kolom ini ada, tetapi daftar kosong, hanya metode input sistem yang diizinkan.

stayOnPluggedModes[]

enum (BatteryPluggedMode)

Mode saat baterai dicolokkan yang membuat perangkat tetap aktif. Saat menggunakan setelan ini, sebaiknya hapus maximum_time_to_lock agar perangkat tidak mengunci sendiri saat tetap aktif.

recommendedGlobalProxy

object (ProxyInfo)

Proxy HTTP global yang independen dari jaringan. Biasanya, proxy harus dikonfigurasi per jaringan di open_network_configuration. Namun, untuk konfigurasi yang tidak biasa seperti pemfilteran internal umum, proxy HTTP global mungkin berguna. Jika proxy tidak dapat diakses, akses jaringan mungkin terganggu. Proxy global hanyalah rekomendasi dan beberapa aplikasi mungkin mengabaikannya.

setUserIconDisabled

boolean

Apakah mengubah ikon pengguna dinonaktifkan. Ini hanya berlaku pada perangkat yang menjalankan Android 7 dan yang lebih baru.

setWallpaperDisabled

boolean

Apakah mengubah wallpaper dinonaktifkan.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

Aturan untuk menentukan akses aplikasi ke kunci pribadi. Lihat ChoosePrivateKeyRule untuk detailnya. Kolom ini harus kosong jika ada aplikasi yang memiliki cakupan delegasi CERT_SELECTION.

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

Konfigurasi untuk koneksi VPN yang selalu aktif. Gunakan dengan vpn_config_disabled untuk mencegah modifikasi setelan ini.

frpAdminEmails[]

string

Alamat email administrator perangkat untuk perlindungan reset ke setelan pabrik. Saat perangkat direset ke setelan pabrik, salah satu admin ini harus login dengan email dan sandi Akun Google untuk membuka kunci perangkat. Jika tidak ada admin yang ditentukan, perangkat tidak akan memberikan perlindungan reset ke setelan pabrik.

deviceOwnerLockScreenInfo

object (UserFacingMessage)

Informasi pemilik perangkat yang akan ditampilkan di layar kunci.

dataRoamingDisabled

boolean

Apakah layanan data roaming dinonaktifkan.

locationMode

enum (LocationMode)

Tingkat deteksi lokasi diaktifkan.

networkEscapeHatchEnabled

boolean

Apakah fitur keluar jaringan diaktifkan atau tidak. Jika koneksi jaringan tidak dapat dilakukan saat waktu booting, tombol keluar akan meminta pengguna untuk terhubung ke jaringan sementara guna memuat ulang kebijakan perangkat. Setelah menerapkan kebijakan, jaringan sementara akan dilupakan dan perangkat akan terus melakukan booting. Hal ini mencegah perangkat tidak dapat terhubung ke jaringan jika tidak ada jaringan yang sesuai dalam kebijakan terakhir dan perangkat melakukan booting ke aplikasi dalam mode tugas terkunci, atau pengguna tidak dapat mengakses setelan perangkat.

Catatan: Menyetel wifiConfigDisabled ke benar (true) akan menggantikan setelan ini dalam keadaan tertentu. Lihat wifiConfigDisabled untuk mengetahui detail selengkapnya. Menyetel configureWifi ke DISALLOW_CONFIGURING_WIFI akan menggantikan setelan ini dalam keadaan tertentu. Lihat DISALLOW_CONFIGURING_WIFI untuk mengetahui detail selengkapnya.

bluetoothDisabled

boolean

Apakah bluetooth dinonaktifkan. Lebih baik menggunakan setelan ini daripada bluetooth_config_disabled karena bluetooth_config_disabled dapat dilewati oleh pengguna.

complianceRules[]
(deprecated)

object (ComplianceRule)

Aturan yang menyatakan tindakan mitigasi yang harus diambil saat perangkat tidak mematuhi kebijakannya. Jika kondisi untuk beberapa aturan terpenuhi, semua tindakan mitigasi untuk aturan tersebut akan dilakukan. Maksimum ada 100 aturan. Sebagai gantinya, gunakan aturan penerapan kebijakan.

blockApplicationsEnabled
(deprecated)

boolean

Apakah aplikasi selain yang dikonfigurasi di applications diblokir agar tidak diinstal. Jika disetel, aplikasi yang diinstal berdasarkan kebijakan sebelumnya, tetapi tidak lagi muncul dalam kebijakan, akan otomatis di-uninstal.

installUnknownSourcesAllowed
(deprecated)

boolean

Kolom ini tidak berpengaruh.

debuggingFeaturesAllowed
(deprecated)

boolean

Apakah pengguna diizinkan untuk mengaktifkan fitur proses debug.

funDisabled

boolean

Apakah pengguna diizinkan untuk bersenang-senang. Mengontrol apakah game telur Paskah di Setelan dinonaktifkan.

autoTimeRequired
(deprecated)

boolean

Apakah waktu otomatis diperlukan, yang mencegah pengguna menyetel tanggal dan waktu secara manual. Jika autoDateAndTimeZone ditetapkan, kolom ini akan diabaikan.

permittedAccessibilityServices

object (PackageNameList)

Menentukan layanan aksesibilitas yang diizinkan. Jika kolom tidak disetel, layanan aksesibilitas apa pun dapat digunakan. Jika kolom disetel, hanya layanan aksesibilitas dalam daftar ini dan layanan aksesibilitas bawaan sistem yang dapat digunakan. Khususnya, jika kolom disetel ke kosong, hanya layanan aksesibilitas bawaan sistem yang dapat digunakan. Setelan ini dapat ditetapkan di perangkat terkelola sepenuhnya dan di profil kerja. Jika diterapkan ke profil kerja, setelan ini akan memengaruhi profil pribadi dan profil kerja.

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

Alternatif yang direkomendasikan: autoUpdateMode yang ditetapkan per aplikasi, memberikan fleksibilitas yang lebih besar terkait frekuensi update.

Jika autoUpdateMode ditetapkan ke AUTO_UPDATE_POSTPONED atau AUTO_UPDATE_HIGH_PRIORITY, kolom ini tidak akan berpengaruh.

Kebijakan update otomatis aplikasi, yang mengontrol kapan update aplikasi otomatis dapat diterapkan.

kioskCustomLauncherEnabled

boolean

Apakah peluncur kustom kios diaktifkan. Tindakan ini akan menggantikan layar utama dengan peluncur yang mengunci perangkat ke aplikasi yang diinstal melalui setelan applications. Aplikasi muncul di satu halaman dalam urutan abjad. Gunakan kioskCustomization untuk mengonfigurasi lebih lanjut perilaku perangkat kios.

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

Setelan ini tidak didukung. Nilai apa pun diabaikan.

skipFirstUseHintsEnabled

boolean

Flag untuk melewati petunjuk saat penggunaan pertama. Admin perusahaan dapat mengaktifkan rekomendasi sistem untuk aplikasi agar melewati tutorial pengguna dan petunjuk pengantar lainnya saat pertama kali dimulai.

privateKeySelectionEnabled

boolean

Memungkinkan menampilkan UI di perangkat agar pengguna dapat memilih alias kunci pribadi jika tidak ada aturan yang cocok di ChoosePrivateKeyRules. Untuk perangkat di bawah Android P, menyetel ini dapat membuat kunci perusahaan rentan. Nilai ini tidak akan berpengaruh jika ada aplikasi yang memiliki cakupan delegasi CERT_SELECTION.

encryptionPolicy

enum (EncryptionPolicy)

Apakah enkripsi diaktifkan

usbMassStorageEnabled
(deprecated)

boolean

Apakah penyimpanan USB diaktifkan. Tidak digunakan lagi.

permissionGrants[]

object (PermissionGrant)

Pemberian atau penolakan izin atau grup eksplisit untuk semua aplikasi. Nilai ini menggantikan default_permission_policy.

playStoreMode

enum (PlayStoreMode)

Mode ini mengontrol aplikasi mana yang tersedia untuk pengguna di Play Store dan perilaku di perangkat saat aplikasi dihapus dari kebijakan.

setupActions[]

object (SetupAction)

Tindakan yang harus dilakukan selama proses penyiapan. Maksimal satu tindakan yang dapat ditentukan.

passwordPolicies[]

object (PasswordRequirements)

Kebijakan persyaratan sandi. Kebijakan yang berbeda dapat ditetapkan untuk profil kerja atau perangkat terkelola sepenuhnya dengan menyetel kolom password_scope dalam kebijakan.

policyEnforcementRules[]

object (PolicyEnforcementRule)

Aturan yang menentukan perilaku saat kebijakan tertentu tidak dapat diterapkan di perangkat

kioskCustomization

object (KioskCustomization)

Setelan yang mengontrol perilaku perangkat dalam mode kios. Untuk mengaktifkan mode kios, tetapkan kioskCustomLauncherEnabled ke true atau tentukan aplikasi dalam kebijakan dengan installType KIOSK.

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

Setelan keamanan lanjutan. Dalam sebagian besar kasus, setelan ini tidak perlu ditetapkan.

personalUsagePolicies

object (PersonalUsagePolicies)

Kebijakan yang mengelola penggunaan pribadi di perangkat milik perusahaan.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

Apakah tanggal, waktu, dan zona waktu otomatis diaktifkan di perangkat milik perusahaan. Jika ini ditetapkan, autoTimeRequired akan diabaikan.

oncCertificateProviders[]

object (OncCertificateProvider)

Fitur ini tidak tersedia secara umum.

crossProfilePolicies

object (CrossProfilePolicies)

Kebijakan lintas profil yang diterapkan di perangkat.

preferentialNetworkService

enum (PreferentialNetworkService)

Mengontrol apakah layanan jaringan pilihan diaktifkan di profil kerja atau di perangkat terkelola sepenuhnya. Misalnya, organisasi mungkin memiliki perjanjian dengan operator bahwa semua data kerja dari perangkat karyawan akan dikirim melalui layanan jaringan khusus untuk penggunaan perusahaan. Contoh layanan jaringan preferensial yang didukung adalah slice perusahaan di jaringan 5G. Kebijakan ini tidak berpengaruh jika preferentialNetworkServiceSettings atau ApplicationPolicy.preferentialNetworkId disetel di perangkat yang menjalankan Android 13 atau yang lebih baru.

usageLog

object (UsageLog)

Konfigurasi logging aktivitas perangkat.

cameraAccess

enum (CameraAccess)

Mengontrol penggunaan kamera dan apakah pengguna memiliki akses ke tombol akses kamera.

microphoneAccess

enum (MicrophoneAccess)

Mengontrol penggunaan mikrofon dan apakah pengguna memiliki akses ke tombol akses mikrofon. Setelan ini hanya berlaku di perangkat yang terkelola sepenuhnya.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Mencakup kontrol untuk konektivitas perangkat seperti Wi-Fi, akses data USB, koneksi keyboard/mouse, dan lainnya.

deviceRadioState

object (DeviceRadioState)

Mencakup kontrol untuk status radio seperti Wi-Fi, bluetooth, dan lainnya.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Mengontrol aplikasi mana yang diizinkan untuk bertindak sebagai penyedia kredensial di Android 14 dan yang lebih baru. Aplikasi ini menyimpan kredensial, lihat ini dan ini untuk mengetahui detailnya. Lihat juga credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

Opsional. Mengontrol apakah pencetakan diizinkan. Fitur ini didukung di perangkat yang menjalankan Android 9 dan yang lebih baru. .

displaySettings

object (DisplaySettings)

Opsional. Kontrol untuk setelan tampilan.

assistContentPolicy

enum (AssistContentPolicy)

Opsional. Mengontrol apakah AssistContent diizinkan dikirim ke aplikasi istimewa seperti aplikasi asisten. AssistContent mencakup screenshot dan informasi tentang aplikasi, seperti nama paket. Fitur ini didukung di Android 15 dan yang lebih baru.

workAccountSetupConfig

object (WorkAccountSetupConfig)

Opsional. Mengontrol konfigurasi penyiapan akun kerja, seperti detail apakah akun yang diautentikasi Google diperlukan atau tidak.

wipeDataFlags[]

enum (WipeDataFlag)

Opsional. Menghapus tanda untuk menunjukkan data apa yang dihapus saat penghapusan total perangkat atau profil dipicu karena alasan apa pun (misalnya, ketidakpatuhan). Hal ini tidak berlaku untuk metode enterprises.devices.delete. . Daftar ini tidak boleh memiliki duplikat.

enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

Opsional. Mengontrol apakah enterpriseDisplayName terlihat di perangkat (misalnya, pesan layar kunci di perangkat milik perusahaan).

appFunctions

enum (AppFunctions)

Opsional. Mengontrol apakah aplikasi di perangkat untuk perangkat terkelola sepenuhnya atau di profil kerja untuk perangkat dengan profil kerja diizinkan untuk mengekspos fungsi aplikasi.

defaultApplicationSettings[]

object (DefaultApplicationSetting)

Opsional. Setelan aplikasi default untuk jenis yang didukung. Jika aplikasi default berhasil ditetapkan untuk setidaknya satu jenis aplikasi di profil, pengguna tidak dapat mengubah aplikasi default apa pun di profil tersebut.

Hanya satu DefaultApplicationSetting yang diizinkan untuk setiap DefaultApplicationType.

Lihat panduan Setelan aplikasi default untuk mengetahui detail selengkapnya.

ApplicationPolicy

Representasi 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),
  "customAppConfig": {
    object (CustomAppConfig)
  },
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "signingKeyCerts": [
    {
      object (ApplicationSigningKeyCert)
    }
  ],
  "roles": [
    {
      object (Role)
    }
  ]
}
Kolom
packageName

string

Nama paket aplikasi. Misalnya, com.google.android.youtube untuk aplikasi YouTube.

installType

enum (InstallType)

Jenis penginstalan yang akan dilakukan.

lockTaskAllowed
(deprecated)

boolean

Apakah aplikasi diizinkan untuk mengunci dirinya sendiri dalam mode layar penuh. TIDAK DIGUNAKAN LAGI. Gunakan InstallType KIOSK atau kioskCustomLauncherEnabled untuk mengonfigurasi perangkat khusus.

defaultPermissionPolicy

enum (PermissionPolicy)

Kebijakan default untuk semua izin yang diminta oleh aplikasi. Jika ditentukan, setelan ini akan menggantikan default_permission_policy tingkat kebijakan yang berlaku untuk semua aplikasi. Setelan ini tidak menggantikan permission_grants yang berlaku untuk semua aplikasi.

permissionGrants[]

object (PermissionGrant)

Pemberian atau penolakan izin eksplisit untuk aplikasi. Nilai ini menggantikan default_permission_policy dan permission_grants yang berlaku untuk semua aplikasi.

managedConfiguration

object (Struct format)

Konfigurasi terkelola yang diterapkan ke aplikasi. Format untuk konfigurasi ditentukan oleh nilai ManagedProperty yang didukung oleh aplikasi. Setiap nama kolom dalam konfigurasi terkelola harus cocok dengan kolom key dari ManagedProperty. Nilai kolom harus kompatibel dengan type dari ManagedProperty:

jenisNilai JSON
BOOLtrue atau false
STRINGstring
INTEGERangka
CHOICEstring
MULTISELECTarray string
HIDDENstring
BUNDLE_ARRAYarray objek
Catatan: nilai string tidak boleh lebih dari 65.535 karakter.

disabled

boolean

Apakah aplikasi dinonaktifkan. Jika dinonaktifkan, data aplikasi tetap dipertahankan.

minimumVersionCode

integer

Versi minimum aplikasi yang berjalan di perangkat. Jika disetel, perangkat akan mencoba mengupdate aplikasi ke setidaknya kode versi ini. Jika aplikasi belum diupdate, perangkat akan berisi NonComplianceDetail dengan non_compliance_reason yang ditetapkan ke APP_NOT_UPDATED. Aplikasi harus sudah dipublikasikan ke Google Play dengan kode versi yang lebih besar dari atau sama dengan nilai ini. Maksimal 20 aplikasi dapat menentukan kode versi minimum per kebijakan.

delegatedScopes[]

enum (DelegatedScope)

Cakupan yang didelegasikan ke aplikasi dari Android Device Policy. Izin ini memberikan hak istimewa tambahan untuk aplikasi yang menerapkannya.

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

Template konfigurasi terkelola untuk aplikasi, yang disimpan dari iframe konfigurasi terkelola. Kolom ini diabaikan jika managed_configuration ditetapkan.

accessibleTrackIds[]

string

Daftar ID jalur aplikasi yang dapat diakses oleh perangkat milik perusahaan. Jika daftar berisi beberapa ID jalur, perangkat akan menerima versi terbaru di antara semua jalur yang dapat diakses. Jika daftar tidak berisi ID jalur, perangkat hanya memiliki akses ke jalur produksi aplikasi. Detail selengkapnya tentang setiap jalur tersedia di AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Mengontrol apakah aplikasi dapat berkomunikasi dengan dirinya sendiri di seluruh profil kerja dan pribadi perangkat, dengan tunduk pada izin pengguna.

autoUpdateMode

enum (AutoUpdateMode)

Mengontrol mode update otomatis untuk aplikasi.

extensionConfig
(deprecated)

object (ExtensionConfig)

Konfigurasi untuk mengaktifkan aplikasi ini sebagai aplikasi ekstensi, dengan kemampuan berinteraksi dengan Android Device Policy secara offline.

Kolom ini dapat disetel untuk paling banyak satu aplikasi. Jika ada aplikasi dengan peran COMPANION_APP, kolom ini tidak dapat disetel.

Sidik jari sertifikat kunci penandatanganan aplikasi di perangkat harus cocok dengan salah satu entri di ApplicationPolicy.signingKeyCerts atau ExtensionConfig.signingKeyFingerprintsSha256 (tidak digunakan lagi) atau sidik jari sertifikat kunci penandatanganan yang diperoleh dari Play Store agar aplikasi dapat berkomunikasi dengan Android Device Policy. Jika aplikasi tidak ada di Play Store dan jika ApplicationPolicy.signingKeyCerts dan ExtensionConfig.signingKeyFingerprintsSha256 (tidak digunakan lagi) tidak ditetapkan, NonComplianceDetail dengan INVALID_VALUE akan dilaporkan.

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

Menentukan apakah aplikasi diizinkan untuk menggunakan jaringan saat VPN tidak terhubung dan alwaysOnVpnPackage.lockdownEnabled diaktifkan. Jika disetel ke VPN_LOCKDOWN_ENFORCED, aplikasi tidak diizinkan untuk menggunakan jaringan, dan jika disetel ke VPN_LOCKDOWN_EXEMPTION, aplikasi diizinkan untuk menggunakan jaringan. Hanya didukung di perangkat yang menjalankan Android 10 dan yang lebih baru. Jika tidak didukung oleh perangkat, perangkat akan berisi NonComplianceDetail dengan non_compliance_reason yang disetel ke API_LEVEL dan fieldPath. Jika tidak berlaku untuk aplikasi, perangkat akan berisi NonComplianceDetail dengan non_compliance_reason disetel ke UNSUPPORTED dan fieldPath. fieldPath disetel ke applications[i].alwaysOnVpnLockdownExemption, dengan i adalah indeks paket dalam kebijakan applications.

workProfileWidgets

enum (WorkProfileWidgets)

Menentukan apakah aplikasi yang diinstal di profil kerja diizinkan untuk menambahkan widget ke layar utama.

credentialProviderPolicy

enum (CredentialProviderPolicy)

Opsional. Apakah aplikasi diizinkan untuk bertindak sebagai penyedia kredensial di Android 14 dan yang lebih baru.

customAppConfig

object (CustomAppConfig)

Opsional. Konfigurasi untuk aplikasi kustom ini.

install_type harus disetel ke CUSTOM agar dapat ditetapkan.

installConstraint[]

object (InstallConstraint)

Opsional. Batasan untuk menginstal aplikasi. Anda dapat menentukan maksimum satu InstallConstraint. Beberapa batasan ditolak.

installPriority

integer

Opsional. Di antara aplikasi dengan installType yang disetel ke:

  • FORCE_INSTALLED
  • PREINSTALLED

Ini mengontrol prioritas relatif penginstalan. Nilai 0 (default) berarti aplikasi ini tidak memiliki prioritas dibandingkan aplikasi lain. Untuk nilai antara 1 dan 10.000, nilai yang lebih rendah berarti prioritas yang lebih tinggi. Nilai di luar rentang 0 hingga 10.000 inklusif akan ditolak.

userControlSettings

enum (UserControlSettings)

Opsional. Menentukan apakah kontrol pengguna diizinkan untuk aplikasi. Kontrol pengguna mencakup tindakan pengguna seperti menghentikan paksa dan menghapus data aplikasi. Jenis aplikasi tertentu memiliki perlakuan khusus, lihat USER_CONTROL_SETTINGS_UNSPECIFIED dan USER_CONTROL_ALLOWED untuk mengetahui detail selengkapnya.

preferentialNetworkId

enum (PreferentialNetworkId)

Opsional. ID jaringan pilihan yang digunakan aplikasi. Harus ada konfigurasi untuk ID jaringan yang ditentukan di preferentialNetworkServiceConfigs. Jika disetel ke PREFERENTIAL_NETWORK_ID_UNSPECIFIED, aplikasi akan menggunakan ID jaringan default yang ditentukan dalam defaultPreferentialNetworkId. Lihat dokumentasi defaultPreferentialNetworkId untuk mengetahui daftar aplikasi yang dikecualikan dari penetapan default ini. Hal ini berlaku di profil kerja dan perangkat terkelola sepenuhnya di Android 13 dan yang lebih baru.

signingKeyCerts[]

object (ApplicationSigningKeyCert)

Opsional. Sertifikat kunci penandatanganan aplikasi.

Kolom ini wajib diisi dalam kasus berikut:

  • Aplikasi memiliki installType yang ditetapkan ke CUSTOM (yaitu aplikasi kustom).
  • Aplikasi memiliki roles yang ditetapkan ke daftar yang tidak kosong dan aplikasi tidak ada di Play Store.
  • Aplikasi memiliki setelan extensionConfig (yaitu aplikasi ekstensi), tetapi ExtensionConfig.signingKeyFingerprintsSha256 (tidak digunakan lagi) tidak disetel dan aplikasi tidak ada di Play Store.

Jika kolom ini tidak disetel untuk aplikasi kustom, kebijakan akan ditolak. Jika tidak ditetapkan saat diperlukan untuk aplikasi non-kustom, NonComplianceDetail dengan INVALID_VALUE akan dilaporkan.

Untuk kasus lainnya, kolom ini bersifat opsional dan sertifikat kunci penandatanganan yang diperoleh dari Play Store akan digunakan.

Lihat setelan kebijakan berikut untuk melihat cara kolom ini digunakan:

  • choosePrivateKeyRules
  • ApplicationPolicy.InstallType.CUSTOM
  • ApplicationPolicy.extensionConfig
  • ApplicationPolicy.roles
roles[]

object (Role)

Opsional. Peran yang dimiliki aplikasi.

Aplikasi yang memiliki peran tertentu dapat dikecualikan dari pembatasan daya dan eksekusi latar belakang, penangguhan, dan hibernasi di Android 14 dan yang lebih baru. Kontrol pengguna juga dapat dilarang untuk aplikasi dengan peran tertentu di Android 11 dan yang lebih baru. Lihat dokumentasi setiap RoleType untuk mengetahui detail selengkapnya.

Aplikasi akan diberi tahu tentang peran yang ditetapkan untuknya jika aplikasi memiliki layanan penerima notifikasi dengan <meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLES" android:value="" />. Aplikasi akan diberi tahu setiap kali perannya diperbarui atau setelah aplikasi diinstal saat memiliki daftar peran yang tidak kosong. Aplikasi dapat menggunakan notifikasi ini untuk melakukan bootstrap sendiri setelah penginstalan. Lihat panduan Mengintegrasikan dengan AMAPI SDK dan Mengelola peran aplikasi untuk mengetahui detail selengkapnya tentang persyaratan layanan.

Agar pengecualian diterapkan dan aplikasi diberi tahu tentang peran, sidik jari sertifikat kunci penandatanganan aplikasi di perangkat harus cocok dengan salah satu sidik jari sertifikat kunci penandatanganan yang diperoleh dari Play Store atau salah satu entri di ApplicationPolicy.signingKeyCerts. Jika tidak, NonComplianceDetail dengan APP_SIGNING_CERT_MISMATCH akan dilaporkan.

Tidak boleh ada peran duplikat dengan roleType yang sama. Beberapa aplikasi tidak dapat memiliki peran dengan roleType yang sama. Peran dengan jenis ROLE_TYPE_UNSPECIFIED tidak diizinkan.

PermissionGrant

Representasi JSON
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
Kolom
permission

string

Izin atau grup Android, misalnya android.permission.READ_CALENDAR atau android.permission_group.CALENDAR.

policy

enum (PermissionPolicy)

Kebijakan untuk memberikan izin.

Struct

Representasi JSON
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta tidak berurutan dari nilai yang diketik secara dinamis.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON
{
  "key": string,
  "value": value
}
Kolom
key

string

value

value (Value format)

Nilai

Representasi JSON
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili nilai null.

numberValue

number

Mewakili nilai ganda.

stringValue

string

Mewakili nilai string.

boolValue

boolean

Mewakili nilai boolean.

structValue

object (Struct format)

Mewakili nilai terstruktur.

listValue

array (ListValue format)

Merepresentasikan Value yang berulang.

ListValue

Representasi JSON
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

ManagedConfigurationTemplate

Representasi JSON
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
Kolom
templateId

string

ID template konfigurasi terkelola.

configurationVariables

map (key: string, value: string)

Opsional, peta yang berisi variabel konfigurasi <kunci, nilai> yang ditentukan untuk konfigurasi.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ConfigurationVariablesEntry

Representasi JSON
{
  "key": string,
  "value": string
}
Kolom
key

string

value

string

ExtensionConfig

Representasi JSON
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
Kolom
signingKeyFingerprintsSha256[]
(deprecated)

string

Hash SHA-256 berenkode hex dari sertifikat kunci penandatanganan aplikasi ekstensi. Hanya representasi string heksadesimal 64 karakter yang valid.

Sidik jari sertifikat kunci penandatanganan selalu diperoleh dari Play Store dan kolom ini digunakan untuk memberikan sidik jari sertifikat kunci penandatanganan tambahan. Namun, jika aplikasi tidak tersedia di Play Store, kolom ini harus disetel. NonComplianceDetail dengan INVALID_VALUE dilaporkan jika kolom ini tidak disetel saat aplikasi tidak tersedia di Play Store.

Sidik jari sertifikat kunci penandatanganan aplikasi ekstensi di perangkat harus cocok dengan salah satu sidik jari sertifikat kunci penandatanganan yang diperoleh dari Play Store atau yang diberikan di kolom ini agar aplikasi dapat berkomunikasi dengan Kebijakan Perangkat Android.

Dalam kasus penggunaan produksi, sebaiknya biarkan kolom ini kosong.

notificationReceiver
(deprecated)

string

Nama class yang sepenuhnya memenuhi syarat dari class layanan penerima untuk Android Device Policy guna memberi tahu aplikasi ekstensi tentang pembaruan status perintah lokal. Layanan harus diekspor di AndroidManifest.xml aplikasi ekstensi dan memperluas NotificationReceiverService (lihat panduan Mengintegrasikan dengan AMAPI SDK untuk mengetahui detail selengkapnya).

CustomAppConfig

Representasi JSON
{
  "userUninstallSettings": enum (UserUninstallSettings)
}
Kolom
userUninstallSettings

enum (UserUninstallSettings)

Opsional. Setelan uninstal pengguna untuk aplikasi kustom.

InstallConstraint

Representasi JSON
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
Kolom
networkTypeConstraint

enum (NetworkTypeConstraint)

Opsional. Batasan jenis jaringan.

chargingConstraint

enum (ChargingConstraint)

Opsional. Batasan pengisian daya.

deviceIdleConstraint

enum (DeviceIdleConstraint)

Opsional. Batasan tidak ada aktivitas perangkat.

ApplicationSigningKeyCert

Representasi JSON
{
  "signingKeyCertFingerprintSha256": string
}
Kolom
signingKeyCertFingerprintSha256

string (bytes format)

Wajib. Nilai hash SHA-256 dari sertifikat kunci penandatanganan aplikasi. Nilai ini harus berupa nilai hash SHA-256 yang valid, yaitu 32 byte. Jika tidak, kebijakan akan ditolak.

String berenkode base64.

Peran

Representasi JSON
{
  "roleType": enum (RoleType)
}
Kolom
roleType

enum (RoleType)

Wajib. Jenis peran yang dapat dimiliki aplikasi.

PersistentPreferredActivity

Representasi JSON
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
Kolom
receiverActivity

string

Aktivitas yang harus menjadi pengendali intent default. Ini harus berupa nama komponen Android, misalnya com.android.enterprise.app/.MainActivity. Atau, nilainya dapat berupa nama paket aplikasi, yang menyebabkan Android Device Policy memilih aktivitas yang sesuai dari aplikasi untuk menangani intent.

actions[]

string

Tindakan intent yang akan dicocokkan dalam filter. Jika ada tindakan yang disertakan dalam filter, tindakan intent harus berupa salah satu nilai tersebut agar cocok. Jika tidak ada tindakan yang disertakan, tindakan maksud akan diabaikan.

categories[]

string

Kategori intent yang akan dicocokkan dalam filter. Intent mencakup kategori yang diperlukan, yang semuanya harus disertakan dalam filter agar cocok. Dengan kata lain, menambahkan kategori ke filter tidak akan memengaruhi pencocokan kecuali jika kategori tersebut ditentukan dalam intent.

SystemUpdate

Representasi JSON
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "allowedDaysWithoutUpdate": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
Kolom
type

enum (SystemUpdateType)

Jenis update sistem yang akan dikonfigurasi.

startMinutes

integer

Jika jenisnya adalah WINDOWED, awal masa pemeliharaan, diukur sebagai jumlah menit setelah tengah malam dalam waktu lokal perangkat. Nilai ini harus antara 0 dan 1439, inklusif.

endMinutes

integer

Jika jenisnya adalah WINDOWED, akhir masa pemeliharaan, diukur sebagai jumlah menit setelah tengah malam dalam waktu lokal perangkat. Nilai ini harus antara 0 dan 1439, inklusif. Jika nilai ini kurang dari start_minutes, masa pemeliharaan akan berlangsung hingga tengah malam. Jika masa pemeliharaan yang ditentukan kurang dari 30 menit, masa pemeliharaan sebenarnya diperpanjang hingga 30 menit setelah waktu mulai.

allowedDaysWithoutUpdate

integer

Jika nilainya lebih besar dari nol, maka ini adalah jumlah hari setelah update tertunda tersedia agar perangkat tetap mematuhi kebijakan, tanpa melakukan update. Tidak berpengaruh jika sebaliknya.

freezePeriods[]

object (FreezePeriod)

Periode waktu yang berulang setiap tahun saat update sistem over-the-air (OTA) ditunda untuk membekukan versi OS yang berjalan di perangkat. Untuk mencegah perangkat dibekukan tanpa batas waktu, setiap periode pembekuan harus dipisahkan setidaknya 60 hari.

FreezePeriod

Representasi JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Kolom
startDate

object (Date)

Tanggal mulai (inklusif) periode pembekuan. Catatan: day dan month harus ditetapkan. year tidak boleh ditetapkan karena tidak digunakan. Contoh, {"month": 1,"date": 30}.

endDate

object (Date)

Tanggal akhir (termasuk) periode pembekuan. Tidak boleh lebih dari 90 hari dari tanggal mulai. Jika tanggal akhir lebih awal dari tanggal mulai, periode pembekuan dianggap mencakup akhir tahun. Catatan: day dan month harus ditetapkan. year tidak boleh ditetapkan karena tidak digunakan. Contoh, {"month": 1,"date": 30}.

Tanggal

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

StatusReportingSettings

Representasi JSON
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean,
  "defaultApplicationInfoReportingEnabled": boolean
}
Kolom
applicationReportsEnabled

boolean

Apakah laporan aplikasi diaktifkan.

deviceSettingsEnabled

boolean

Apakah pelaporan setelan perangkat diaktifkan.

softwareInfoEnabled

boolean

Apakah pelaporan info software diaktifkan.

memoryInfoEnabled

boolean

Apakah pelaporan peristiwa memori diaktifkan.

networkInfoEnabled

boolean

Apakah pelaporan info jaringan diaktifkan.

displayInfoEnabled

boolean

Apakah pelaporan tampilan diaktifkan. Data laporan tidak tersedia untuk perangkat milik pribadi dengan profil kerja.

powerManagementEventsEnabled

boolean

Apakah pelaporan peristiwa pengelolaan daya diaktifkan. Data laporan tidak tersedia untuk perangkat milik pribadi dengan profil kerja.

hardwareStatusEnabled

boolean

Apakah pelaporan status hardware diaktifkan. Data laporan tidak tersedia untuk perangkat milik pribadi dengan profil kerja.

systemPropertiesEnabled

boolean

Apakah pelaporan properti sistem diaktifkan.

applicationReportingSettings

object (ApplicationReportingSettings)

Setelan pelaporan aplikasi. Hanya berlaku jika application_reports_enabled benar (true).

commonCriteriaModeEnabled

boolean

Apakah pelaporan Common Criteria Mode diaktifkan atau tidak. Fitur ini hanya didukung di perangkat milik perusahaan.

defaultApplicationInfoReportingEnabled

boolean

Opsional. Apakah pelaporan defaultApplicationInfo diaktifkan atau tidak.

ApplicationReportingSettings

Representasi JSON
{
  "includeRemovedApps": boolean
}
Kolom
includeRemovedApps

boolean

Apakah aplikasi yang dihapus disertakan dalam laporan aplikasi.

UserFacingMessage

Representasi JSON
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Kolom
localizedMessages

map (key: string, value: string)

Peta yang berisi pasangan <locale, message>, dengan locale adalah kode bahasa BCP 47 yang terbentuk dengan baik, seperti en-US, es-ES, atau fr.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

defaultMessage

string

Pesan default yang ditampilkan jika tidak ada pesan yang dilokalkan yang ditentukan atau lokalitas pengguna tidak cocok dengan pesan yang dilokalkan. Pesan default harus diberikan jika ada pesan yang dilokalkan.

LocalizedMessagesEntry

Representasi JSON
{
  "key": string,
  "value": string
}
Kolom
key

string

value

string

PasswordRequirements

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

integer

Panjang sandi minimum yang diizinkan. Nilai 0 berarti tidak ada batasan. Hanya diterapkan jika password_quality adalah NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC, atau COMPLEX.

passwordMinimumLetters

integer

Jumlah huruf minimal yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordMinimumLowerCase

integer

Jumlah minimal huruf kecil yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordMinimumNonLetter

integer

Jumlah minimum karakter non-huruf (digit numerik atau simbol) yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordMinimumNumeric

integer

Jumlah minimum digit numerik yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordMinimumSymbols

integer

Jumlah minimum simbol yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordMinimumUpperCase

integer

Jumlah minimal huruf besar yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.

passwordQuality

enum (PasswordQuality)

Kualitas sandi yang diperlukan.

passwordHistoryLength

integer

Panjang histori sandi. Setelah menyetel kolom ini, pengguna tidak akan dapat memasukkan sandi baru yang sama dengan sandi apa pun dalam histori. Nilai 0 berarti tidak ada batasan.

maximumFailedPasswordsForWipe

integer

Jumlah sandi buka kunci perangkat yang salah yang dapat dimasukkan sebelum perangkat dihapus total. Nilai 0 berarti tidak ada batasan.

passwordExpirationTimeout

string (Duration format)

Batas waktu masa berlaku sandi.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

passwordScope

enum (PasswordPolicyScope)

Cakupan yang berlaku untuk persyaratan sandi.

requirePasswordUnlock

enum (RequirePasswordUnlock)

Jangka waktu setelah perangkat atau profil kerja dibuka kuncinya menggunakan bentuk autentikasi yang kuat (sandi, PIN, pola) sehingga perangkat atau profil kerja tersebut dapat dibuka kuncinya menggunakan metode autentikasi lainnya (misalnya, sidik jari, agen tepercaya, wajah). Setelah jangka waktu yang ditentukan berlalu, hanya bentuk autentikasi yang kuat yang dapat digunakan untuk membuka kunci perangkat atau profil kerja.

unifiedLockSettings

enum (UnifiedLockSettings)

Mengontrol apakah kunci terpadu diizinkan untuk perangkat dan profil kerja, di perangkat yang menjalankan Android 9 dan yang lebih baru dengan profil kerja. Kebijakan ini hanya dapat disetel jika password_scope disetel ke SCOPE_PROFILE. Jika tidak, kebijakan akan ditolak. Jika pengguna belum menyetel kunci aplikasi kerja terpisah dan kolom ini disetel ke REQUIRE_SEPARATE_WORK_LOCK, NonComplianceDetail akan dilaporkan dengan nonComplianceReason disetel ke USER_ACTION.

Durasi

Representasi JSON
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/h * 365,25 h/thn * 10.000 thn

nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

PackageNameList

Representasi JSON
{
  "packageNames": [
    string
  ]
}
Kolom
packageNames[]

string

Daftar nama paket.

ProxyInfo

Representasi JSON
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
Kolom
host

string

Host proxy langsung.

port

integer

Port proxy langsung.

excludedHosts[]

string

Untuk proxy langsung, host yang proxy-nya dilewati. Nama host dapat berisi karakter pengganti seperti *.example.com.

pacUri

string

URI skrip PAC yang digunakan untuk mengonfigurasi proxy.

ChoosePrivateKeyRule

Representasi JSON
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
Kolom
urlPattern

string

Pola URL yang akan dicocokkan dengan URL permintaan. Jika tidak disetel atau kosong, semua URL akan cocok. Ini menggunakan sintaksis ekspresi reguler java.util.regex.Pattern.

packageNames[]

string

Nama paket yang aturan ini berlaku padanya. Sidik jari sertifikat kunci penandatanganan aplikasi diverifikasi terhadap sidik jari sertifikat kunci penandatanganan yang disediakan oleh Play Store dan ApplicationPolicy.signingKeyCerts . Jika tidak ada nama paket yang ditentukan, alias akan diberikan ke semua aplikasi yang memanggil KeyChain.choosePrivateKeyAlias atau kelebihan beban (tetapi tidak tanpa memanggil KeyChain.choosePrivateKeyAlias, bahkan di Android 11 dan yang lebih tinggi). Aplikasi apa pun dengan UID Android yang sama dengan paket yang ditentukan di sini akan memiliki akses saat memanggil KeyChain.choosePrivateKeyAlias.

privateKeyAlias

string

Alias kunci pribadi yang akan digunakan.

AlwaysOnVpnPackage

Representasi JSON
{
  "packageName": string,
  "lockdownEnabled": boolean
}
Kolom
packageName

string

Nama paket aplikasi VPN.

lockdownEnabled

boolean

Tidak mengizinkan jaringan saat VPN tidak terhubung.

ComplianceRule

Representasi 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.
}
Kolom
disableApps

boolean

Jika disetel ke benar (true), aturan ini mencakup tindakan mitigasi untuk menonaktifkan aplikasi sehingga perangkat akan dinonaktifkan secara efektif, tetapi data aplikasi tetap dipertahankan. Jika perangkat menjalankan aplikasi dalam mode tugas terkunci, aplikasi akan ditutup dan UI yang menampilkan alasan ketidakpatuhan akan ditampilkan.

packageNamesToDisable[]

string

Jika disetel, aturan akan menyertakan tindakan mitigasi untuk menonaktifkan aplikasi yang ditentukan dalam daftar, tetapi data aplikasi tetap dipertahankan.

Kolom union condition. Kondisi, yang jika terpenuhi, akan memicu tindakan mitigasi yang ditentukan dalam aturan. Tepat satu kondisi yang harus ditetapkan. condition hanya dapat berupa salah satu dari berikut:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

Kondisi yang terpenuhi jika ada NonComplianceDetail yang cocok untuk perangkat.

apiLevelCondition

object (ApiLevelCondition)

Kondisi yang terpenuhi jika level API Framework Android di perangkat tidak memenuhi persyaratan minimum.

NonComplianceDetailCondition

Representasi JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
Kolom
settingName

string

Nama setelan kebijakan. Ini adalah nama kolom JSON dari kolom Policy tingkat teratas. Jika tidak disetel, kondisi ini akan cocok dengan nama setelan apa pun.

nonComplianceReason

enum (NonComplianceReason)

Alasan perangkat tidak mematuhi setelan. Jika tidak disetel, kondisi ini cocok dengan alasan apa pun.

packageName

string

Nama paket aplikasi yang tidak mematuhi kebijakan. Jika tidak disetel, kondisi ini cocok dengan nama paket apa pun.

ApiLevelCondition

Representasi JSON
{
  "minApiLevel": integer
}
Kolom
minApiLevel

integer

Level API Framework Android minimum yang diinginkan. Jika perangkat tidak memenuhi persyaratan minimum, kondisi ini terpenuhi. Harus lebih besar dari nol.

SetupAction

Representasi 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.
}
Kolom
title

object (UserFacingMessage)

Judul tindakan ini.

description

object (UserFacingMessage)

Deskripsi tindakan ini.

Kolom union action. Tindakan yang akan dijalankan selama penyiapan. action hanya dapat berupa salah satu dari berikut:
launchApp

object (LaunchAppAction)

Tindakan untuk meluncurkan aplikasi. Aplikasi akan diluncurkan dengan intent yang berisi ekstra dengan kunci com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION yang ditetapkan ke nilai boolean true untuk menunjukkan bahwa ini adalah alur tindakan penyiapan. Jika SetupAction mereferensikan aplikasi, installType yang sesuai dalam kebijakan aplikasi harus ditetapkan sebagai REQUIRED_FOR_SETUP atau penyiapan tersebut akan gagal.

LaunchAppAction

Representasi JSON
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
Kolom

Kolom union launch.

launch hanya dapat berupa salah satu dari hal berikut:

packageName

string

Nama paket aplikasi yang akan diluncurkan

PolicyEnforcementRule

Representasi 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.
}
Kolom
blockAction

object (BlockAction)

Tindakan untuk memblokir akses ke aplikasi dan data di perangkat milik perusahaan atau di profil kerja. Tindakan ini juga memicu notifikasi yang ditampilkan kepada pengguna dengan informasi (jika memungkinkan) tentang cara memperbaiki masalah kepatuhan. Catatan: wipeAction juga harus ditentukan.

wipeAction

object (WipeAction)

Tindakan untuk mereset perangkat milik perusahaan atau menghapus profil kerja. Catatan: blockAction juga harus ditentukan.

Kolom union trigger. Kondisi yang akan memicu aturan ini. trigger hanya dapat berupa salah satu dari berikut:
settingName

string

Kebijakan tingkat teratas yang akan diterapkan. Misalnya applications atau passwordPolicies.

BlockAction

Representasi JSON
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
Kolom
blockAfterDays

integer

Jumlah hari kebijakan tidak mematuhi sebelum perangkat atau profil kerja diblokir. Untuk memblokir akses secara langsung, setel ke 0. blockAfterDays harus lebih kecil dari wipeAfterDays.

blockScope

enum (BlockScope)

Menentukan cakupan BlockAction ini. Hanya berlaku untuk perangkat milik perusahaan.

WipeAction

Representasi JSON
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
Kolom
wipeAfterDays

integer

Jumlah hari kebijakan tidak mematuhi sebelum perangkat atau profil kerja dihapus total. wipeAfterDays harus lebih besar dari blockAfterDays.

preserveFrp

boolean

Apakah data perlindungan reset ke setelan pabrik disimpan di perangkat. Setelan ini tidak berlaku untuk profil kerja.

KioskCustomization

Representasi JSON
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
Kolom
powerButtonActions

enum (PowerButtonActions)

Menetapkan perilaku perangkat dalam mode kios saat pengguna menekan lama tombol Daya.

systemErrorWarnings

enum (SystemErrorWarnings)

Menentukan apakah dialog kesalahan sistem untuk aplikasi yang mengalami error atau tidak responsif diblokir dalam mode kios. Jika diblokir, sistem akan menghentikan aplikasi secara paksa seolah-olah pengguna memilih opsi "tutup aplikasi" di UI.

systemNavigation

enum (SystemNavigation)

Menentukan fitur navigasi yang diaktifkan (misalnya tombol Layar utama, Ringkasan) dalam mode kios.

statusBar

enum (StatusBar)

Menentukan apakah info dan notifikasi sistem dinonaktifkan dalam mode kios.

deviceSettings

enum (DeviceSettings)

Menentukan apakah aplikasi Setelan diizinkan dalam mode kios.

AdvancedSecurityOverrides

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

enum (UntrustedAppsPolicy)

Kebijakan untuk aplikasi yang tidak tepercaya (aplikasi dari sumber tidak dikenal) yang diterapkan di perangkat. Menggantikan install_unknown_sources_allowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Apakah verifikasi Google Play Protect diterapkan. Menggantikan ensureVerifyAppsEnabled (tidak digunakan lagi).

developerSettings

enum (DeveloperSettings)

Mengontrol akses ke setelan developer: opsi developer dan booting aman. Menggantikan safeBootDisabled (tidak digunakan lagi) dan debuggingFeaturesAllowed (tidak digunakan lagi). Di perangkat pribadi dengan profil kerja, menyetel kebijakan ini tidak akan menonaktifkan booting aman. Dalam hal ini, NonComplianceDetail dengan MANAGEMENT_MODE dilaporkan.

commonCriteriaMode

enum (CommonCriteriaMode)

Mengontrol Mode Common Criteria—standar keamanan yang ditentukan dalam Common Criteria for Information Technology Security Evaluation (CC). Mengaktifkan Mode Common Criteria akan meningkatkan keamanan komponen keamanan tertentu di perangkat, lihat CommonCriteriaMode untuk mengetahui detailnya.

Peringatan: Mode Common Criteria menerapkan model keamanan ketat yang biasanya hanya diperlukan untuk produk IT yang digunakan dalam sistem keamanan nasional dan organisasi yang sangat sensitif lainnya. Penggunaan perangkat standar mungkin terpengaruh. Hanya diaktifkan jika diperlukan. Jika Mode Kriteria Umum dinonaktifkan setelah diaktifkan sebelumnya, semua jaringan Wi-Fi yang dikonfigurasi pengguna dapat hilang dan semua jaringan Wi-Fi yang dikonfigurasi perusahaan yang memerlukan input pengguna mungkin perlu dikonfigurasi ulang.

personalAppsThatCanReadWorkNotifications[]

string

Aplikasi pribadi yang dapat membaca notifikasi profil kerja menggunakan NotificationListenerService. Secara default, tidak ada aplikasi pribadi (selain aplikasi sistem) yang dapat membaca notifikasi kerja. Setiap nilai dalam daftar harus berupa nama paket.

mtePolicy

enum (MtePolicy)

Opsional. Mengontrol Memory Tagging Extension (MTE) di perangkat. Perangkat harus dimulai ulang untuk menerapkan perubahan pada kebijakan MTE. Di Android 15 dan yang lebih baru, NonComplianceDetail dengan PENDING dilaporkan jika perubahan kebijakan menunggu perangkat di-reboot.

contentProtectionPolicy

enum (ContentProtectionPolicy)

Opsional. Mengontrol apakah perlindungan konten, yang memindai aplikasi menipu, diaktifkan. Fitur ini didukung di Android 15 dan yang lebih baru.

PersonalUsagePolicies

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

boolean

Jika benar (true), kamera dinonaktifkan di profil pribadi.

screenCaptureDisabled

boolean

Jika benar (true), screenshot dinonaktifkan untuk semua pengguna.

accountTypesWithManagementDisabled[]

string

Jenis akun yang tidak dapat dikelola oleh pengguna.

maxDaysWithWorkOff

integer

Mengontrol berapa lama profil kerja dapat dinonaktifkan. Durasi minimum harus minimal 3 hari. Detail lainnya adalah sebagai berikut:

  • Jika durasi disetel ke 0, fitur akan dinonaktifkan.
  • Jika durasi disetel ke nilai yang lebih kecil dari durasi minimum, fitur ini akan menampilkan error.
Catatan: Jika Anda ingin menghindari penangguhan profil pribadi selama periode tidak aktif yang lama, Anda dapat menetapkan nilai besar untuk parameter ini untuk sementara.

personalPlayStoreMode

enum (PlayStoreMode)

Digunakan bersama dengan personalApplications untuk mengontrol cara aplikasi di profil pribadi diizinkan atau diblokir.

personalApplications[]

object (PersonalApplicationPolicy)

Kebijakan yang diterapkan pada aplikasi di profil pribadi.

privateSpacePolicy

enum (PrivateSpacePolicy)

Opsional. Mengontrol apakah ruang privasi diizinkan di perangkat.

bluetoothSharing

enum (BluetoothSharing)

Opsional. Apakah berbagi melalui bluetooth diizinkan.

PersonalApplicationPolicy

Representasi JSON
{
  "packageName": string,
  "installType": enum (InstallType)
}
Kolom
packageName

string

Nama paket aplikasi.

installType

enum (InstallType)

Jenis penginstalan yang akan dilakukan.

OncCertificateProvider

Representasi 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.
}
Kolom
certificateReferences[]

string

Fitur ini tidak tersedia secara umum.

Kolom union endpoint.

Fitur ini tidak tersedia secara umum. endpoint hanya dapat berupa salah satu dari hal berikut:

contentProviderEndpoint

object (ContentProviderEndpoint)

Fitur ini tidak tersedia secara umum.

ContentProviderEndpoint

Representasi JSON
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
Kolom
uri

string

Fitur ini tidak tersedia secara umum.

packageName

string

Fitur ini tidak tersedia secara umum.

signingCertsSha256[]

string

Wajib. Fitur ini tidak tersedia secara umum.

CrossProfilePolicies

Representasi JSON
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "crossProfileAppFunctions": enum (CrossProfileAppFunctions),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
Kolom
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

Apakah aplikasi pribadi dapat mengakses kontak yang disimpan di profil kerja.

Lihat juga exemptions_to_show_work_contacts_in_personal_profile.

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

Apakah teks yang disalin dari satu profil (pribadi atau kerja) dapat ditempelkan di profil lainnya.

crossProfileDataSharing

enum (CrossProfileDataSharing)

Apakah data dari satu profil (pribadi atau kerja) dapat dibagikan dengan aplikasi di profil lainnya. Secara khusus mengontrol berbagi data sederhana melalui intent. Pengelolaan saluran komunikasi antar-profil lainnya, seperti penelusuran kontak, salin/tempel, atau aplikasi kerja & pribadi yang terhubung, dikonfigurasi secara terpisah.

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

Menentukan perilaku default untuk widget profil kerja. Jika kebijakan tidak menentukan work_profile_widgets untuk aplikasi tertentu, aplikasi tersebut akan berperilaku sesuai dengan nilai yang ditentukan di sini.

crossProfileAppFunctions

enum (CrossProfileAppFunctions)

Opsional. Mengontrol apakah aplikasi profil pribadi dapat memanggil fungsi aplikasi yang diekspos oleh aplikasi di profil kerja.

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

Daftar aplikasi yang dikecualikan dari setelan ShowWorkContactsInPersonalProfile. Agar dapat ditetapkan, ShowWorkContactsInPersonalProfile harus ditetapkan ke salah satu nilai berikut:

  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED. Dalam hal ini, pengecualian ini bertindak sebagai daftar yang tidak diizinkan.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED. Dalam hal ini, pengecualian ini berfungsi sebagai daftar yang diizinkan.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM. Dalam hal ini, pengecualian ini berfungsi sebagai daftar yang diizinkan, selain aplikasi sistem yang sudah ada dalam daftar yang diizinkan.

Didukung di Android 14 dan yang lebih baru. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android lebih rendah dari 14.

UsageLog

Representasi JSON
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
Kolom
enabledLogTypes[]

enum (LogType)

Menentukan jenis log yang diaktifkan. Perhatikan bahwa pengguna akan menerima pesan di perangkat saat pencatatan penggunaan diaktifkan.

uploadOnCellularAllowed[]

enum (LogType)

Menentukan jenis log yang diaktifkan yang dapat diupload melalui data seluler. Secara default, log dimasukkan dalam antrean untuk diupload saat perangkat terhubung ke Wi-Fi.

DeviceConnectivityManagement

Representasi 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)
  }
}
Kolom
usbDataAccess

enum (UsbDataAccess)

Mengontrol file dan/atau data yang dapat ditransfer melalui USB. Hanya didukung di perangkat milik perusahaan.

configureWifi

enum (ConfigureWifi)

Mengontrol hak istimewa konfigurasi Wi-Fi. Berdasarkan opsi yang ditetapkan, pengguna akan memiliki kontrol penuh, terbatas, atau tidak ada dalam mengonfigurasi jaringan Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

Mengontrol konfigurasi dan penggunaan setelan Wi-Fi Direct. Didukung di perangkat milik perusahaan yang menjalankan Android 13 dan yang lebih baru.

tetheringSettings

enum (TetheringSettings)

Mengontrol setelan penambatan. Berdasarkan nilai yang ditetapkan, pengguna dilarang sebagian atau sepenuhnya menggunakan berbagai bentuk penambatan.

wifiSsidPolicy

object (WifiSsidPolicy)

Batasan pada SSID Wi-Fi yang dapat dihubungkan oleh perangkat. Perhatikan bahwa tindakan ini tidak memengaruhi jaringan mana yang dapat dikonfigurasi di perangkat. Didukung di perangkat milik perusahaan yang menjalankan Android 13 dan yang lebih baru.

wifiRoamingPolicy

object (WifiRoamingPolicy)

Opsional. Kebijakan roaming Wi-Fi.

bluetoothSharing

enum (BluetoothSharing)

Opsional. Mengontrol apakah berbagi melalui Bluetooth diizinkan.

preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

Opsional. Konfigurasi layanan jaringan preferensial. Menetapkan kolom ini akan menggantikan preferentialNetworkService. Setelan ini dapat ditetapkan di profil kerja dan perangkat terkelola sepenuhnya di Android 13 dan yang lebih baru. Lihat panduan Network slicing 5G untuk mengetahui detail selengkapnya.

apnPolicy

object (ApnPolicy)

Opsional. Kebijakan Nama Poin Akses (APN). Konfigurasi untuk Nama Poin Akses (APN) yang dapat menggantikan APN lain di perangkat. Lihat OVERRIDE_APNS_ENABLED dan overrideApns untuk mengetahui detailnya.

WifiSsidPolicy

Representasi JSON
{
  "wifiSsidPolicyType": enum (WifiSsidPolicyType),
  "wifiSsids": [
    {
      object (WifiSsid)
    }
  ]
}
Kolom
wifiSsidPolicyType

enum (WifiSsidPolicyType)

Jenis kebijakan SSID Wi-Fi yang akan diterapkan.

wifiSsids[]

object (WifiSsid)

Opsional. Daftar SSID Wi-Fi yang harus diterapkan dalam kebijakan. Kolom ini tidak boleh kosong jika WifiSsidPolicyType ditetapkan ke WIFI_SSID_ALLOWLIST. Jika disetel ke daftar yang tidak kosong, detail NonComplianceDetail dengan API_LEVEL akan dilaporkan jika versi Android kurang dari 13 dan NonComplianceDetail dengan MANAGEMENT_MODE akan dilaporkan untuk perangkat yang tidak dimiliki perusahaan.

WifiSsid

Representasi JSON
{
  "wifiSsid": string
}
Kolom
wifiSsid

string

Wajib. SSID Wi-Fi yang direpresentasikan sebagai string.

WifiRoamingPolicy

Representasi JSON
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
Kolom
wifiRoamingSettings[]

object (WifiRoamingSetting)

Opsional. Setelan roaming Wi-Fi. SSID yang diberikan dalam daftar ini harus unik. Jika tidak, kebijakan akan ditolak.

WifiRoamingSetting

Representasi JSON
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
Kolom
wifiSsid

string

Wajib. SSID jaringan Wi-Fi.

wifiRoamingMode

enum (WifiRoamingMode)

Wajib. Mode roaming Wi-Fi untuk SSID yang ditentukan.

PreferentialNetworkServiceSettings

Representasi JSON
{
  "preferentialNetworkServiceConfigs": [
    {
      object (PreferentialNetworkServiceConfig)
    }
  ],
  "defaultPreferentialNetworkId": enum (PreferentialNetworkId)
}
Kolom
preferentialNetworkServiceConfigs[]

object (PreferentialNetworkServiceConfig)

Wajib. Konfigurasi layanan jaringan preferensial yang memungkinkan adanya beberapa slice perusahaan. Tidak boleh ada beberapa konfigurasi dengan preferentialNetworkId yang sama. Jika konfigurasi tidak dirujuk oleh aplikasi apa pun dengan menyetel ApplicationPolicy.preferentialNetworkId atau dengan menyetel defaultPreferentialNetworkId, konfigurasi tersebut akan diabaikan. Untuk perangkat di jaringan 4G, APN perusahaan perlu dikonfigurasi tambahan untuk menyiapkan panggilan data bagi layanan jaringan yang lebih baik. APN ini dapat ditambahkan menggunakan apnPolicy.

defaultPreferentialNetworkId

enum (PreferentialNetworkId)

Wajib. ID jaringan pilihan default untuk aplikasi yang tidak ada di applications atau jika ApplicationPolicy.preferentialNetworkId disetel ke PREFERENTIAL_NETWORK_ID_UNSPECIFIED. Harus ada konfigurasi untuk ID jaringan yang ditentukan di preferentialNetworkServiceConfigs, kecuali jika ini disetel ke NO_PREFERENTIAL_NETWORK. Jika disetel ke PREFERENTIAL_NETWORK_ID_UNSPECIFIED atau tidak disetel, nilai defaultnya adalah NO_PREFERENTIAL_NETWORK. Catatan: Jika jaringan pilihan default salah dikonfigurasi, aplikasi yang tidak menyetel ApplicationPolicy.preferentialNetworkId tidak dapat mengakses internet. Setelan ini tidak berlaku untuk aplikasi penting berikut:

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

ApplicationPolicy.preferentialNetworkId masih dapat digunakan untuk mengonfigurasi jaringan pilihan untuknya.

PreferentialNetworkServiceConfig

Representasi JSON
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
Kolom
preferentialNetworkId

enum (PreferentialNetworkId)

Wajib. ID jaringan pilihan. Kebijakan ini tidak boleh disetel ke NO_PREFERENTIAL_NETWORK atau PREFERENTIAL_NETWORK_ID_UNSPECIFIED. Jika tidak, kebijakan akan ditolak.

fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

Opsional. Apakah penggantian ke jaringan default tingkat perangkat diizinkan. Jika disetel ke FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED, nonMatchingNetworks tidak boleh disetel ke NON_MATCHING_NETWORKS_DISALLOWED. Jika tidak, kebijakan akan ditolak. Catatan: Jika setelan ini disetel ke FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED, aplikasi tidak dapat mengakses internet jika slice 5G tidak tersedia.

nonMatchingNetworks

enum (NonMatchingNetworks)

Opsional. Apakah aplikasi yang menerapkan konfigurasi ini diblokir agar tidak menggunakan jaringan selain layanan pilihan. Jika disetel ke NON_MATCHING_NETWORKS_DISALLOWED, fallbackToDefaultConnection harus disetel ke FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED.

ApnPolicy

Representasi JSON
{
  "overrideApns": enum (OverrideApns),
  "apnSettings": [
    {
      object (ApnSetting)
    }
  ]
}
Kolom
overrideApns

enum (OverrideApns)

Opsional. Apakah APN pengganti dinonaktifkan atau diaktifkan. Lihat DevicePolicyManager.setOverrideApnsEnabled untuk mengetahui detail selengkapnya.

apnSettings[]

object (ApnSetting)

Opsional. Setelan APN untuk mengganti APN. Tidak boleh ada konflik antara setelan APN yang diberikan, jika tidak, kebijakan akan ditolak. Dua ApnSetting dianggap bertentangan jika semua kolom berikut cocok di keduanya: numericOperatorId, apn, proxyAddress, proxyPort, mmsProxyAddress, mmsProxyPort, mmsc, mvnoType, protocol, roamingProtocol. Jika beberapa setelan APN menyebabkan ketidakpatuhan terhadap INVALID_VALUE , setelan tersebut akan diabaikan. Setelan ini dapat ditetapkan di perangkat yang terkelola sepenuhnya di Android 10 dan yang lebih baru. Setelan ini juga dapat ditetapkan di profil kerja di Android 13 dan yang lebih baru, serta hanya dengan ApnSetting's dengan jenis APN ENTERPRISE. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android lebih rendah dari 10. NonComplianceDetail dengan MANAGEMENT_MODE dilaporkan untuk profil kerja di Android versi di bawah 13.

ApnSetting

Representasi 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
}
Kolom
apnTypes[]

enum (ApnType)

Wajib. Kategori penggunaan untuk APN. Kebijakan akan ditolak jika kolom ini kosong atau berisi APN_TYPE_UNSPECIFIED atau duplikat. Beberapa jenis APN dapat disetel di perangkat yang terkelola sepenuhnya. ENTERPRISE adalah satu-satunya jenis APN yang diizinkan di profil kerja. NonComplianceDetail dengan MANAGEMENT_MODE dilaporkan untuk nilai lain pada profil kerja. Jenis APN yang tidak didukung di perangkat atau mode pengelolaan akan diabaikan. Jika hal ini menghasilkan daftar kosong, setelan APN akan diabaikan, karena apnTypes adalah kolom wajib diisi. NonComplianceDetail dengan INVALID_VALUE dilaporkan jika tidak ada jenis APN yang didukung di perangkat atau mode pengelolaan.

apn

string

Wajib. Nama APN. Kebijakan akan ditolak jika kolom ini kosong.

displayName

string

Wajib. Nama yang dapat dibaca manusia yang menjelaskan APN. Kebijakan akan ditolak jika kolom ini kosong.

alwaysOnSetting

enum (AlwaysOnSetting)

Opsional. Apakah resource User Plane harus diaktifkan selama setiap transisi dari mode CM-IDLE ke status CM-CONNECTED untuk APN ini. Lihat bagian 5.6.13 3GPP TS 23.501.

authType

enum (AuthType)

Opsional. Jenis autentikasi APN.

carrierId

integer

Opsional. ID Operator untuk APN. Nilai 0 (default) berarti tidak ditetapkan dan nilai negatif ditolak.

mmsProxyAddress

string

Opsional. Alamat proxy MMS (Multimedia Messaging Service) APN yang dapat berupa alamat IP atau nama host (bukan URL).

mmsProxyPort

integer

Opsional. Port proxy MMS (Multimedia Messaging Service) APN. Nilai 0 (default) berarti tidak ditetapkan dan nilai negatif ditolak.

mmsc

string

Opsional. URI MMSC (Multimedia Messaging Service Center) APN.

mtuV4

integer

Opsional. Ukuran MTU (Unit Transmisi Maksimum) default dalam byte untuk rute IPv4 yang ditampilkan oleh setelan APN ini. Nilai 0 (default) berarti tidak ditetapkan dan nilai negatif ditolak. Didukung di Android 13 dan yang lebih baru. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android lebih rendah dari 13.

mtuV6

integer

Opsional. Ukuran MTU (Unit Transmisi Maksimum) antarmuka seluler IPv6 yang terhubung ke APN. Nilai 0 (default) berarti tidak ditetapkan dan nilai negatif ditolak. Didukung di Android 13 dan yang lebih baru. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android lebih rendah dari 13.

mvnoType

enum (MvnoType)

Opsional. Jenis pencocokan MVNO untuk APN.

networkTypes[]

enum (NetworkType)

Opsional. Teknologi radio (jenis jaringan) yang dapat digunakan APN. Kebijakan akan ditolak jika kolom ini berisi NETWORK_TYPE_UNSPECIFIED atau duplikat.

username

string

Opsional. Nama pengguna APN.

password

string

Opsional. Sandi APN.

numericOperatorId

string

Opsional. ID operator numerik APN. ID operator numerik ditentukan sebagai MCC (Mobile Country Code) + MNC (Mobile Network Code).

protocol

enum (Protocol)

Opsional. Protokol yang akan digunakan untuk terhubung ke APN ini.

roamingProtocol

enum (Protocol)

Opsional. Protokol yang akan digunakan untuk terhubung ke APN ini saat perangkat melakukan roaming.

proxyAddress

string

Opsional. Alamat proxy APN.

proxyPort

integer

Opsional. Port proxy APN. Nilai 0 (default) berarti tidak ditetapkan dan nilai negatif ditolak.

DeviceRadioState

Representasi JSON
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel),
  "userInitiatedAddEsimSettings": enum (UserInitiatedAddEsimSettings)
}
Kolom
wifiState

enum (WifiState)

Mengontrol status Wi-Fi saat ini dan apakah pengguna dapat mengubah statusnya.

airplaneModeState

enum (AirplaneModeState)

Mengontrol apakah mode pesawat dapat diaktifkan/dinonaktifkan oleh pengguna atau tidak.

ultraWidebandState

enum (UltraWidebandState)

Mengontrol status setelan ultra wideband dan apakah pengguna dapat mengaktifkan atau menonaktifkannya.

cellularTwoGState

enum (CellularTwoGState)

Mengontrol apakah setelan 2G seluler dapat diaktifkan/dinonaktifkan oleh pengguna atau tidak.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

Tingkat keamanan minimum yang diperlukan untuk jaringan Wi-Fi yang dapat dihubungkan oleh perangkat.

userInitiatedAddEsimSettings

enum (UserInitiatedAddEsimSettings)

Opsional. Mengontrol apakah pengguna diizinkan untuk menambahkan profil eSIM.

DisplaySettings

Representasi JSON
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
Kolom
screenBrightnessSettings

object (ScreenBrightnessSettings)

Opsional. Mengontrol setelan kecerahan layar.

screenTimeoutSettings

object (ScreenTimeoutSettings)

Opsional. Mengontrol setelan waktu tunggu layar.

ScreenBrightnessSettings

Representasi JSON
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
Kolom
screenBrightnessMode

enum (ScreenBrightnessMode)

Opsional. Mengontrol mode kecerahan layar.

screenBrightness

integer

Opsional. Kecerahan layar antara 1 dan 255, dengan 1 adalah kecerahan terendah dan 255 adalah kecerahan tertinggi. Nilai 0 (default) berarti tidak ada kecerahan layar yang ditetapkan. Nilai lainnya akan ditolak. screenBrightnessMode harus berupa BRIGHTNESS_AUTOMATIC atau BRIGHTNESS_FIXED untuk menyetelnya. Didukung di Android 9 dan yang lebih baru di perangkat yang terkelola sepenuhnya. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android kurang dari 9. Didukung di profil kerja di perangkat milik perusahaan di Android 15 dan yang lebih baru.

ScreenTimeoutSettings

Representasi JSON
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
Kolom
screenTimeoutMode

enum (ScreenTimeoutMode)

Opsional. Mengontrol apakah pengguna diizinkan untuk mengonfigurasi waktu tunggu layar.

screenTimeout

string (Duration format)

Opsional. Mengontrol durasi waktu tunggu layar. Durasi waktu tunggu layar harus lebih besar dari 0, jika tidak, permintaan akan ditolak. Selain itu, nilai ini tidak boleh lebih besar dari maximumTimeToLock. Jika tidak, waktu tunggu layar akan disetel ke maximumTimeToLock dan NonComplianceDetail dengan alasan INVALID_VALUE serta alasan spesifik SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK akan dilaporkan. Jika waktu tunggu layar kurang dari batas bawah tertentu, waktu tunggu layar akan disetel ke batas bawah. Batas bawah dapat bervariasi di seluruh perangkat. Jika disetel, screenTimeoutMode harus berupa SCREEN_TIMEOUT_ENFORCED. Didukung di Android 9 dan yang lebih baru di perangkat yang terkelola sepenuhnya. NonComplianceDetail dengan API_LEVEL dilaporkan jika versi Android kurang dari 9. Didukung di profil kerja di perangkat milik perusahaan di Android 15 dan yang lebih baru.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

WorkAccountSetupConfig

Representasi JSON
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
Kolom
authenticationType

enum (AuthenticationType)

Opsional. Jenis autentikasi pengguna di perangkat.

requiredAccountEmail

string

Opsional. Alamat email akun kerja Google tertentu yang akan ditambahkan. Kolom ini hanya relevan jika authenticationType adalah GOOGLE_AUTHENTICATED. Akun ini harus berupa akun perusahaan, bukan akun konsumen. Setelah ditetapkan dan akun yang diautentikasi Google ditambahkan ke perangkat, perubahan kolom ini tidak akan berpengaruh, sehingga sebaiknya ditetapkan hanya sekali.

DefaultApplicationSetting

Representasi JSON
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "defaultApplications": [
    {
      object (DefaultApplication)
    }
  ],
  "defaultApplicationScopes": [
    enum (DefaultApplicationScope)
  ]
}
Kolom
defaultApplicationType

enum (DefaultApplicationType)

Wajib. Jenis aplikasi untuk menetapkan aplikasi default.

defaultApplications[]

object (DefaultApplication)

Wajib. Daftar aplikasi yang dapat ditetapkan sebagai aplikasi default untuk jenis tertentu. Daftar ini tidak boleh kosong atau berisi duplikat. Aplikasi pertama dalam daftar yang diinstal dan memenuhi syarat untuk defaultApplicationType (misalnya, aplikasi SMS untuk DEFAULT_SMS) ditetapkan sebagai aplikasi default. Sidik jari sertifikat kunci penandatanganan aplikasi di perangkat juga harus cocok dengan salah satu sidik jari sertifikat kunci penandatanganan yang diperoleh dari Play Store atau salah satu entri di ApplicationPolicy.signingKeyCerts agar dapat ditetapkan sebagai default.

Jika defaultApplicationScopes berisi SCOPE_FULLY_MANAGED atau SCOPE_WORK_PROFILE, aplikasi harus memiliki entri di applications dengan installType yang ditetapkan ke nilai selain BLOCKED.

NonComplianceDetail dengan alasan APP_NOT_INSTALLED dan alasan spesifik DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE dilaporkan jika tidak ada aplikasi dalam daftar yang diinstal. NonComplianceDetail dengan alasan INVALID_VALUE dan alasan spesifik DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE dilaporkan jika setidaknya satu aplikasi diinstal, tetapi kebijakan gagal diterapkan karena alasan lain (misalnya, aplikasi bukan jenis yang tepat).

Saat menerapkan SCOPE_PERSONAL_PROFILE di perangkat milik perusahaan dengan profil kerja, hanya aplikasi sistem bawaan yang dapat ditetapkan sebagai default. NonComplianceDetail dengan alasan INVALID_VALUE dan alasan spesifik DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE dilaporkan jika kebijakan gagal diterapkan ke profil pribadi.

defaultApplicationScopes[]

enum (DefaultApplicationScope)

Wajib. Cakupan tempat kebijakan harus diterapkan. Daftar ini tidak boleh kosong atau berisi duplikat.

NonComplianceDetail dengan alasan MANAGEMENT_MODE dan alasan spesifik DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES dilaporkan jika tidak ada cakupan yang ditentukan yang dapat diterapkan ke mode pengelolaan (misalnya, perangkat terkelola sepenuhnya menerima kebijakan dengan hanya SCOPE_PERSONAL_PROFILE dalam daftar).

DefaultApplication

Representasi JSON
{
  "packageName": string
}
Kolom
packageName

string

Wajib. Nama paket yang harus ditetapkan sebagai aplikasi default. Kebijakan ditolak jika nama paket tidak valid.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌