MCP Tools Reference: Android Device Management MCP Server

Narzędzie: list_policies

Wyświetla listę zasad dla danej firmy. Wymaga nazwy zasobu przedsiębiorstwa w polu nadrzędnym (np. enterprises/{enterpriseId}).

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie list_policies MCP.

Żądanie 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
}'
                

Schemat wejściowy

Prośba o wyświetlenie zasad dla danej firmy.

ListPoliciesRequest

Zapis JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Pola
parent

string

Nazwa przedsiębiorstwa w formacie enterprises/{enterpriseId}.

pageSize

integer

Żądany rozmiar strony. Rzeczywisty rozmiar strony może być ograniczony do wartości minimalnej lub maksymalnej.

pageToken

string

Token identyfikujący stronę wyników zwróconych przez serwer.

Schemat wyjściowy

Odpowiedź na prośbę o wyświetlenie zasad dotyczących danej firmy.

ListPoliciesResponse

Zapis JSON
{
  "policies": [
    {
      object (Policy)
    }
  ],
  "nextPageToken": string
}
Pola
policies[]

object (Policy)

Lista zasad.

nextPageToken

string

Jeśli jest więcej wyników, token do pobrania następnej strony wyników.

Zasady

Zapis 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)
    }
  ]
}
Pola
name

string

Nazwa zasady w formacie enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

Wersja zasad. To pole jest tylko do odczytu. Wersja jest zwiększana za każdym razem, gdy zasady są aktualizowane.

applications[]

object (ApplicationPolicy)

Zasady zastosowane w aplikacjach. Może zawierać maksymalnie 3000 elementów.

maximumTimeToLock

string (int64 format)

Maksymalny czas aktywności użytkownika (w milisekundach) do momentu zablokowania urządzenia. Wartość 0 oznacza brak ograniczeń.

screenCaptureDisabled

boolean

Czy przechwytywanie ekranu jest wyłączone.

cameraDisabled
(deprecated)

boolean

Jeśli parametr camera_access ma wartość inną niż CAMERA_ACCESS_UNSPECIFIED, nie ma to żadnego wpływu. W przeciwnym razie to pole określa, czy kamery są wyłączone: jeśli ma wartość „true”, wszystkie kamery są wyłączone, w przeciwnym razie są dostępne. W przypadku urządzeń w pełni zarządzanych to pole dotyczy wszystkich aplikacji na urządzeniu. W przypadku profili służbowych to pole dotyczy tylko aplikacji w profilu służbowym, a dostęp do aparatu w aplikacjach poza profilem służbowym pozostaje bez zmian.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

wyłączanie dostosowywania ekranu blokady (na przykład przy użyciu widżetów),

defaultPermissionPolicy

enum (PermissionPolicy)

Domyślne zasady dotyczące żądań uprawnień w czasie działania.

persistentPreferredActivities[]

object (PersistentPreferredActivity)

Domyślne działania modułu obsługi intencji.

openNetworkConfiguration

object (Struct format)

Konfiguracja sieci na urządzeniu. Więcej informacji znajdziesz w artykule o konfigurowaniu sieci.

systemUpdate

object (SystemUpdate)

Zasady aktualizacji systemu, które określają sposób stosowania aktualizacji systemu operacyjnego. Jeśli typ aktualizacji to WINDOWED, okno aktualizacji zostanie automatycznie zastosowane również do aktualizacji aplikacji w Google Play.

Uwaga: aktualizacje systemowe Google Play (nazywane też aktualizacjami Mainline) są pobierane automatycznie, ale ich zainstalowanie wymaga restartu urządzenia. Więcej informacji znajdziesz w sekcji dotyczącej głównej linii w artykule Zarządzanie aktualizacjami systemu.

accountTypesWithManagementDisabled[]

string

Typy kont, którymi użytkownik nie może zarządzać.

addUserDisabled

boolean

Informacja, czy dodawanie nowych użytkowników i profili jest wyłączone. W przypadku urządzeń, na których managementMode ma wartość DEVICE_OWNER, to pole jest ignorowane, a użytkownik nigdy nie może dodawać ani usuwać użytkowników.

adjustVolumeDisabled

boolean

Określa, czy regulacja głośności głównej jest wyłączona. Wycisza też urządzenie. Ustawienie ma zastosowanie tylko na urządzeniach w pełni zarządzanych.

factoryResetDisabled

boolean

Czy przywracanie ustawień fabrycznych z poziomu ustawień jest wyłączone.

installAppsDisabled

boolean

Czy instalowanie aplikacji przez użytkowników jest wyłączone.

mountPhysicalMediaDisabled

boolean

czy użytkownik podłączający fizyczne nośniki zewnętrzne jest wyłączony;

modifyAccountsDisabled

boolean

Określa, czy dodawanie i usuwanie kont jest wyłączone.

safeBootDisabled
(deprecated)

boolean

Czy ponowne uruchamianie urządzenia w trybie awaryjnym jest wyłączone.

uninstallAppsDisabled

boolean

Określa, czy odinstalowywanie aplikacji przez użytkowników jest wyłączone. Uniemożliwia to odinstalowywanie aplikacji, nawet tych usuniętych za pomocą applications.

statusBarDisabled
(deprecated)

boolean

Czy pasek stanu jest wyłączony. Wyłącza to powiadomienia, szybkie ustawienia i inne nakładki ekranowe, które umożliwiają wyjście z trybu pełnoekranowego. WYCOFANO. Aby wyłączyć pasek stanu na urządzeniu w trybie kiosku, użyj InstallType KIOSK lub kioskCustomLauncherEnabled.

keyguardDisabled

boolean

Jeśli ta zasada ma wartość Prawda, wyłącza ekran blokady na wyświetlaczach głównych lub dodatkowych. Ta zasada jest obsługiwana tylko w trybie zarządzania urządzeniami dedykowanymi.

minimumApiLevel

integer

Minimalny dozwolony poziom interfejsu API Androida.

statusReportingSettings

object (StatusReportingSettings)

Ustawienia raportowania stanu

bluetoothContactSharingDisabled

boolean

Określa, czy udostępnianie kontaktów przez Bluetooth jest wyłączone.

shortSupportMessage

object (UserFacingMessage)

Wiadomość wyświetlana użytkownikowi na ekranie ustawień, na którym administrator wyłączył funkcje. Jeśli wiadomość ma więcej niż 200 znaków, może zostać obcięta.

longSupportMessage

object (UserFacingMessage)

Komunikat wyświetlany użytkownikowi na ekranie ustawień administratorów urządzenia.

passwordRequirements
(deprecated)

object (PasswordRequirements)

Wymagania dotyczące hasła. Pole password_requirements.require_password_unlock nie może być ustawione. WYCOFANO – użyj passwordPolicies.

Uwaga:

Nie można tu używać wartości PasswordQuality opartych na złożoności, czyli COMPLEXITY_LOW, COMPLEXITY_MEDIUMCOMPLEXITY_HIGH. Nie można tu użyć unified_lock_settings.

wifiConfigsLockdownEnabled
(deprecated)

boolean

To zostało wycofane.

bluetoothConfigDisabled

boolean

Czy konfigurowanie Bluetooth jest wyłączone.

cellBroadcastsConfigDisabled

boolean

Określa, czy konfigurowanie komunikatów z sieci komórkowej jest wyłączone.

credentialsConfigDisabled

boolean

Określa, czy konfigurowanie danych logowania użytkownika jest wyłączone.

mobileNetworksConfigDisabled

boolean

Określa, czy konfigurowanie sieci komórkowych jest wyłączone.

tetheringConfigDisabled
(deprecated)

boolean

Określa, czy konfigurowanie tetheringu i przenośnych hotspotów jest wyłączone. Jeśli wartość tetheringSettings jest inna niż TETHERING_SETTINGS_UNSPECIFIED, to ustawienie jest ignorowane.

vpnConfigDisabled

boolean

Określa, czy konfigurowanie sieci VPN jest wyłączone.

wifiConfigDisabled
(deprecated)

boolean

Określa, czy konfigurowanie sieci Wi-Fi jest wyłączone. Obsługiwane na urządzeniach w pełni zarządzanych i profilach służbowych na urządzeniach należących do firmy. W przypadku urządzeń w pełni zarządzanych ustawienie tej zasady na wartość „prawda” powoduje usunięcie wszystkich skonfigurowanych sieci i zachowanie tylko tych, które zostały skonfigurowane za pomocą zasady openNetworkConfiguration. W przypadku profili służbowych na urządzeniach należących do firmy nie ma to wpływu na skonfigurowane sieci, a użytkownik nie może dodawać, usuwać ani modyfikować sieci Wi-Fi. Jeśli wartość configureWifi jest inna niż CONFIGURE_WIFI_UNSPECIFIED, to ustawienie jest ignorowane. Uwaga: jeśli podczas uruchamiania nie można nawiązać połączenia z siecią, a konfigurowanie Wi-Fi jest wyłączone, wyświetli się funkcja awaryjnego przywracania sieci, która umożliwia odświeżenie zasad urządzenia (patrz networkEscapeHatchEnabled).

createWindowsDisabled

boolean

Określa, czy tworzenie okien innych niż okna aplikacji jest wyłączone.

networkResetDisabled

boolean

Czy resetowanie ustawień sieci jest wyłączone.

outgoingBeamDisabled

boolean

czy używanie NFC do przesyłania danych z aplikacji jest wyłączone.

outgoingCallsDisabled

boolean

Określa, czy połączenia wychodzące są wyłączone.

removeUserDisabled

boolean

Określa, czy usuwanie innych użytkowników jest wyłączone.

shareLocationDisabled

boolean

Określa, czy udostępnianie lokalizacji jest wyłączone.

smsDisabled

boolean

Czy wysyłanie i odbieranie SMS-ów jest wyłączone.

unmuteMicrophoneDisabled
(deprecated)

boolean

Jeśli parametr microphone_access ma wartość inną niż MICROPHONE_ACCESS_UNSPECIFIED, nie ma to żadnego wpływu. W przeciwnym razie to pole określa, czy mikrofony są wyłączone: jeśli ma wartość „true”, wszystkie mikrofony są wyłączone, w przeciwnym razie są dostępne. Ta funkcja jest dostępna tylko na urządzeniach w pełni zarządzanych.

usbFileTransferDisabled
(deprecated)

boolean

Określa, czy przesyłanie plików przez USB jest wyłączone. Ta funkcja jest obsługiwana tylko na urządzeniach należących do firmy.

ensureVerifyAppsEnabled
(deprecated)

boolean

Określa, czy weryfikacja aplikacji jest wymuszona.

permittedInputMethods

object (PackageNameList)

Jeśli ta lista jest obecna, dozwolone są tylko metody wprowadzania dostarczane przez pakiety z tej listy. Jeśli to pole jest obecne, ale lista jest pusta, dozwolone są tylko systemowe metody wprowadzania.

stayOnPluggedModes[]

enum (BatteryPluggedMode)

Tryby zasilania bateryjnego, w których urządzenie pozostaje włączone. Jeśli używasz tego ustawienia, zalecamy wyłączenie maximum_time_to_lock, aby urządzenie nie blokowało się, gdy jest włączone.

recommendedGlobalProxy

object (ProxyInfo)

Globalny serwer proxy HTTP niezależny od sieci. Zwykle serwery proxy powinny być konfigurowane w open_network_configuration dla każdej sieci. W przypadku nietypowych konfiguracji, takich jak ogólne filtrowanie wewnętrzne, może się jednak przydać globalny serwer proxy HTTP. Jeśli serwer proxy jest niedostępny, dostęp do sieci może zostać przerwany. Globalny serwer proxy jest tylko rekomendacją, a niektóre aplikacje mogą go ignorować.

setUserIconDisabled

boolean

Informacja, czy zmiana ikony użytkownika jest wyłączona. Dotyczy to tylko urządzeń z Androidem 7 lub nowszym.

setWallpaperDisabled

boolean

Określa, czy zmiana tapety jest wyłączona.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

Reguły określania dostępu aplikacji do kluczy prywatnych. Aby dowiedzieć się więcej, zobacz ChoosePrivateKeyRule. To pole musi być puste, jeśli jakakolwiek aplikacja ma zakres przekazywania dostępu CERT_SELECTION.

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

Konfiguracja stałego połączenia VPN. Użyj tego ustawienia z parametrem vpn_config_disabled, aby uniemożliwić modyfikowanie tego ustawienia.

frpAdminEmails[]

string

Adresy e-mail administratorów urządzenia na potrzeby ochrony przed przywróceniem do ustawień fabrycznych. Po przywróceniu ustawień fabrycznych na urządzeniu jeden z tych administratorów będzie musiał zalogować się za pomocą adresu e-mail i hasła do konta Google, aby odblokować urządzenie. Jeśli nie podasz administratorów, urządzenie nie będzie objęte ochroną po przywróceniu do ustawień fabrycznych.

deviceOwnerLockScreenInfo

object (UserFacingMessage)

Informacje o właścicielu urządzenia, które mają być wyświetlane na ekranie blokady.

dataRoamingDisabled

boolean

Określa, czy usługi transmisji danych w roamingu są wyłączone.

locationMode

enum (LocationMode)

Stopień włączenia wykrywania lokalizacji.

networkEscapeHatchEnabled

boolean

Czy wyjście awaryjne sieci jest włączone. Jeśli podczas uruchamiania nie można nawiązać połączenia z siecią, funkcja awaryjna wyświetla prośbę o tymczasowe połączenie z siecią w celu odświeżenia zasad urządzenia. Po zastosowaniu zasad sieć tymczasowa zostanie zapomniana, a urządzenie będzie kontynuować uruchamianie. Zapobiega to sytuacji, w której nie można połączyć się z siecią, jeśli w ostatnich zasadach nie ma odpowiedniej sieci, a urządzenie uruchamia się w aplikacji w trybie blokady zadań lub użytkownik nie może uzyskać dostępu do ustawień urządzenia.

Uwaga: ustawienie wartości wifiConfigDisabled na „true” w określonych okolicznościach zastąpi to ustawienie. Więcej informacji znajdziesz na stronie wifiConfigDisabled. Ustawienie configureWifi na DISALLOW_CONFIGURING_WIFI w określonych okolicznościach zastąpi to ustawienie. Więcej informacji znajdziesz na stronie DISALLOW_CONFIGURING_WIFI.

bluetoothDisabled

boolean

Czy Bluetooth jest wyłączony. Preferuj to ustawienie zamiast bluetooth_config_disabled, ponieważ użytkownik może je pominąć.bluetooth_config_disabled

complianceRules[]
(deprecated)

object (ComplianceRule)

Reguły określające działania łagodzące, które należy podjąć, gdy urządzenie nie jest zgodne z zasadami. Gdy warunki kilku reguł zostaną spełnione, podejmowane są wszystkie działania łagodzące związane z tymi regułami. Obowiązuje limit 100 reguł. Zamiast tego użyj reguł egzekwowania zasad.

blockApplicationsEnabled
(deprecated)

boolean

Czy instalacja aplikacji innych niż skonfigurowane w applications jest zablokowana. Gdy ta opcja jest włączona, aplikacje, które zostały zainstalowane w ramach poprzednio obowiązującej zasady, ale nie są już uwzględnione w zasadach, zostaną automatycznie odinstalowane.

installUnknownSourcesAllowed
(deprecated)

boolean

To pole nie ma żadnego wpływu.

debuggingFeaturesAllowed
(deprecated)

boolean

Określa, czy użytkownik może włączyć funkcje debugowania.

funDisabled

boolean

Czy użytkownik może się dobrze bawić. Określa, czy gra typu Easter egg w Ustawieniach jest wyłączona.

autoTimeRequired
(deprecated)

boolean

Określa, czy wymagana jest automatyczna synchronizacja czasu, co uniemożliwia użytkownikowi ręczne ustawienie daty i godziny. Jeśli ustawiona jest wartość autoDateAndTimeZone, to pole jest ignorowane.

permittedAccessibilityServices

object (PackageNameList)

Określa dozwolone usługi ułatwień dostępu. Jeśli to pole nie jest ustawione, można używać dowolnej usługi ułatwień dostępu. Jeśli to pole jest ustawione, można używać tylko usług ułatwień dostępu z tej listy i wbudowanej usługi ułatwień dostępu w systemie. W szczególności, jeśli pole jest puste, można używać tylko wbudowanych usług ułatwień dostępu. Można to ustawić na urządzeniach w pełni zarządzanych i w profilach służbowych. Jeśli to ustawienie zostanie zastosowane do profilu służbowego, będzie miało wpływ zarówno na profil osobisty, jak i na profil służbowy.

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

Zalecana alternatywa: autoUpdateMode, która jest ustawiana dla każdej aplikacji i zapewnia większą elastyczność w zakresie częstotliwości aktualizacji.

Gdy zasada autoUpdateMode ma wartość AUTO_UPDATE_POSTPONED lub AUTO_UPDATE_HIGH_PRIORITY, to pole nie ma żadnego wpływu.

Zasady automatycznych aktualizacji aplikacji, które określają, kiedy można stosować automatyczne aktualizacje aplikacji.

kioskCustomLauncherEnabled

boolean

Określa, czy włączony jest niestandardowy program uruchamiający kiosku. Zastępuje to ekran główny programem uruchamiającym, który blokuje urządzenie i umożliwia korzystanie tylko z aplikacji zainstalowanych za pomocą ustawienia applications. Aplikacje są wyświetlane na jednej stronie w porządku alfabetycznym. Użyj parametru kioskCustomization, aby dodatkowo skonfigurować działanie urządzenia w trybie kiosku.

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

To ustawienie nie jest obsługiwane. Każda wartość jest ignorowana.

skipFirstUseHintsEnabled

boolean

Flaga, która umożliwia pominięcie wskazówek przy pierwszym użyciu. Administratorzy wersji Enterprise mogą włączyć rekomendacje systemowe dotyczące aplikacji, aby użytkownicy mogli pominąć samouczek i inne wskazówki wprowadzające przy pierwszym uruchomieniu.

privateKeySelectionEnabled

boolean

Umożliwia wyświetlanie interfejsu na urządzeniu, aby użytkownik mógł wybrać alias klucza prywatnego, jeśli w funkcji ChoosePrivateKeyRules nie ma pasujących reguł. W przypadku urządzeń z Androidem w wersji starszej niż P ustawienie tej opcji może narazić klucze firmowe na zagrożenia. Ta wartość nie będzie miała wpływu, jeśli jakakolwiek aplikacja ma zakres delegowania CERT_SELECTION.

encryptionPolicy

enum (EncryptionPolicy)

Czy szyfrowanie jest włączone

usbMassStorageEnabled
(deprecated)

boolean

Określa, czy nośnik USB jest włączony. Rola wycofana.

permissionGrants[]

object (PermissionGrant)

Jawne zezwolenia lub odmowy dla wszystkich aplikacji lub grup. Te wartości zastępują default_permission_policy.

playStoreMode

enum (PlayStoreMode)

Ten tryb określa, które aplikacje są dostępne dla użytkownika w Sklepie Play, oraz zachowanie urządzenia, gdy aplikacje zostaną usunięte z zasad.

setupActions[]

object (SetupAction)

Działania, które należy wykonać podczas procesu konfiguracji. Można określić maksymalnie 1 działanie.

passwordPolicies[]

object (PasswordRequirements)

zasady dotyczące wymagań związanych z hasłami, Różne zasady można ustawić dla profilu służbowego lub w pełni zarządzanych urządzeń, ustawiając pole password_scope w zasadach.

policyEnforcementRules[]

object (PolicyEnforcementRule)

Reguły określające działanie, gdy nie można zastosować określonych zasad na urządzeniu.

kioskCustomization

object (KioskCustomization)

Ustawienia określające działanie urządzenia w trybie kiosku. Aby włączyć tryb kiosku, ustaw wartość kioskCustomLauncherEnabled na true lub określ aplikację w zasadach za pomocą installType KIOSK.

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

Zaawansowane ustawienia zabezpieczeń. W większości przypadków nie musisz ich ustawiać.

personalUsagePolicies

object (PersonalUsagePolicies)

Zasady zarządzania użytkowaniem osobistym na urządzeniu należącym do firmy.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

Czy na urządzeniu należącym do firmy włączone są automatyczna data, godzina i strefa czasowa. Jeśli ta opcja jest ustawiona, parametr autoTimeRequired jest ignorowany.

oncCertificateProviders[]

object (OncCertificateProvider)

Ta funkcja nie jest ogólnie dostępna.

crossProfilePolicies

object (CrossProfilePolicies)

Zasady dotyczące wielu profili zastosowane na urządzeniu.

preferentialNetworkService

enum (PreferentialNetworkService)

Określa, czy preferencyjna usługa sieciowa jest włączona w profilu służbowym lub na w pełni zarządzanych urządzeniach. Na przykład organizacja może mieć umowę z operatorem, zgodnie z którą wszystkie dane służbowe z urządzeń pracowników będą przesyłane za pomocą usługi sieciowej przeznaczonej do użytku firmowego. Przykładem obsługiwanej usługi preferencyjnej sieci jest wycinek sieciowy dla przedsiębiorstw w sieciach 5G. Ta zasada nie działa, jeśli na urządzeniach z Androidem 13 lub nowszym skonfigurowano zasady preferentialNetworkServiceSettings lub ApplicationPolicy.preferentialNetworkId.

usageLog

object (UsageLog)

Konfiguracja logowania aktywności urządzenia.

cameraAccess

enum (CameraAccess)

Określa, czy użytkownik może korzystać z aparatu i czy ma dostęp do przełącznika dostępu do aparatu.

microphoneAccess

enum (MicrophoneAccess)

Określa użycie mikrofonu i to, czy użytkownik ma dostęp do przełącznika dostępu do mikrofonu. Dotyczy to tylko urządzeń w pełni zarządzanych.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Obejmuje ustawienia łączności urządzenia, takie jak Wi-Fi, dostęp do danych przez USB, połączenia klawiatury i myszy oraz inne.

deviceRadioState

object (DeviceRadioState)

Obejmuje elementy sterujące stanem radia, takie jak Wi-Fi, Bluetooth i inne.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Określa, które aplikacje mogą działać jako dostawcy danych logowania na urządzeniach z Androidem 14 lub nowszym. Aplikacje te przechowują dane logowania. Więcej informacji znajdziesz tutajtutaj. Zobacz też credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

Opcjonalnie. Określa, czy drukowanie jest dozwolone. Ta funkcja jest obsługiwana na urządzeniach z Androidem 9 lub nowszym. .

displaySettings

object (DisplaySettings)

Opcjonalnie. Elementy sterujące ustawieniami wyświetlania.

assistContentPolicy

enum (AssistContentPolicy)

Opcjonalnie. Określa, czy AssistContent może być wysyłany do uprzywilejowanej aplikacji, np. aplikacji asystenta. AssistContent obejmuje zrzuty ekranu i informacje o aplikacji, takie jak nazwa pakietu. Ta funkcja jest obsługiwana na urządzeniach z Androidem 15 lub nowszym.

workAccountSetupConfig

object (WorkAccountSetupConfig)

Opcjonalnie. Określa konfigurację konta służbowego, np. czy wymagane jest konto uwierzytelnione przez Google.

wipeDataFlags[]

enum (WipeDataFlag)

Opcjonalnie. Flagi czyszczenia wskazują, jakie dane są czyszczone, gdy z dowolnego powodu (np. niezgodności) zostanie wyczyszczone urządzenie lub profil. Nie dotyczy to metody enterprises.devices.delete. . Lista nie może zawierać duplikatów.

enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

Opcjonalnie. Określa, czy symbol enterpriseDisplayName jest widoczny na urządzeniu (np. wiadomość na ekranie blokady na urządzeniach należących do firmy).

appFunctions

enum (AppFunctions)

Opcjonalnie. Określa, czy aplikacje na urządzeniu w przypadku urządzeń w pełni zarządzanych lub w profilu służbowym w przypadku urządzeń z profilami służbowymi mogą udostępniać funkcje aplikacji.

defaultApplicationSettings[]

object (DefaultApplicationSetting)

Opcjonalnie. Domyślne ustawienie aplikacji dla obsługiwanych typów. Jeśli aplikacja domyślna zostanie ustawiona dla co najmniej 1 typu aplikacji w profilu, użytkownicy nie będą mogli zmienić żadnych aplikacji domyślnych w tym profilu.

Dozwolony jest tylko 1 tag DefaultApplicationSetting na każdy tag DefaultApplicationType.

Więcej informacji znajdziesz w przewodniku Ustawienia domyślne aplikacji.

ApplicationPolicy

Zapis 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)
    }
  ]
}
Pola
packageName

string

Nazwa pakietu aplikacji. Na przykład com.google.android.youtube w przypadku aplikacji YouTube.

installType

enum (InstallType)

Typ instalacji do przeprowadzenia.

lockTaskAllowed
(deprecated)

boolean

Określa, czy aplikacja może blokować się w trybie pełnoekranowym. WYCOFANO. Użyj InstallType KIOSK lub kioskCustomLauncherEnabled, aby skonfigurować urządzenie dedykowane.

defaultPermissionPolicy

enum (PermissionPolicy)

Domyślne zasady dotyczące wszystkich uprawnień wymaganych przez aplikację. Jeśli ta zasada jest określona, zastępuje zasadę default_permission_policy na poziomie zasad, która ma zastosowanie do wszystkich aplikacji. Nie zastępuje ona permission_grants, która obowiązuje w przypadku wszystkich aplikacji.

permissionGrants[]

object (PermissionGrant)

Wyraźne przyznanie lub odmowa przyznania uprawnień aplikacji. Te wartości zastępują wartości default_permission_policypermission_grants, które mają zastosowanie do wszystkich aplikacji.

managedConfiguration

object (Struct format)

Konfiguracja zarządzana zastosowana w aplikacji. Format konfiguracji jest określany przez wartości ManagedProperty obsługiwane przez aplikację. Każda nazwa pola w konfiguracji zarządzanej musi odpowiadać polu keyManagedProperty. Wartość pola musi być zgodna z atrybutem type elementu ManagedProperty:

typeWartość JSON
BOOLtrue lub false
STRINGciąg znaków
INTEGERliczba
CHOICEciąg znaków
MULTISELECTtablica ciągów znaków
HIDDENciąg znaków
BUNDLE_ARRAYtablica obiektów
Uwaga: wartości ciągów znaków nie mogą być dłuższe niż 65 535 znaków.

disabled

boolean

Czy aplikacja jest wyłączona. Gdy ta opcja jest wyłączona, dane aplikacji są nadal zachowywane.

minimumVersionCode

integer

Minimalna wersja aplikacji, która działa na urządzeniu. Jeśli ta opcja jest ustawiona, urządzenie próbuje zaktualizować aplikację co najmniej do tej wersji. Jeśli aplikacja nie jest aktualna, urządzenie będzie zawierać element NonComplianceDetail z wartością non_compliance_reason ustawioną na APP_NOT_UPDATED. Aplikacja musi być już opublikowana w Google Play z kodem wersji równym tej wartości lub większym. W przypadku każdej zasady można określić minimalny kod wersji dla maksymalnie 20 aplikacji.

delegatedScopes[]

enum (DelegatedScope)

Zakresy delegowane do aplikacji z Android Device Policy. Zapewniają one dodatkowe uprawnienia aplikacjom, do których są stosowane.

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

Szablon konfiguracji zarządzanych aplikacji zapisany w elemencie iframe konfiguracji zarządzanych. To pole jest ignorowane, jeśli ustawiona jest wartość managed_configuration.

accessibleTrackIds[]

string

Lista identyfikatorów ścieżek aplikacji, do których urządzenie należące do przedsiębiorstwa może uzyskać dostęp. Jeśli lista zawiera kilka identyfikatorów ścieżek, urządzenia otrzymują najnowszą wersję ze wszystkich dostępnych ścieżek. Jeśli lista nie zawiera identyfikatorów ścieżek, urządzenia mają dostęp tylko do ścieżki produkcyjnej aplikacji. Więcej informacji o każdej ścieżce znajdziesz w AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Określa, czy aplikacja może komunikować się sama ze sobą w profilu służbowym i osobistym na urządzeniu, pod warunkiem uzyskania zgody użytkownika.

autoUpdateMode

enum (AutoUpdateMode)

Określa tryb automatycznej aktualizacji aplikacji.

extensionConfig
(deprecated)

object (ExtensionConfig)

Konfiguracja umożliwiająca włączenie tej aplikacji jako aplikacji rozszerzającej z możliwością interakcji z aplikacją Android Device Policy w trybie offline.

To pole można ustawić dla co najwyżej 1 aplikacji. Jeśli jakakolwiek aplikacja ma rolę COMPANION_APP, nie można ustawić tego pola.

Aby aplikacja mogła komunikować się z aplikacją Android Device Policy, odcisk palca certyfikatu klucza podpisywania aplikacji na urządzeniu musi być zgodny z jednym z wpisów w ApplicationPolicy.signingKeyCerts lub ExtensionConfig.signingKeyFingerprintsSha256 (wersja wycofana) albo z odciskami palca certyfikatu klucza podpisywania uzyskanymi ze Sklepu Play. Jeśli aplikacja nie jest dostępna w Sklepie Play i nie są ustawione parametry ApplicationPolicy.signingKeyCerts ani ExtensionConfig.signingKeyFingerprintsSha256 (wycofane), zgłaszany jest parametr NonComplianceDetail z wartością INVALID_VALUE.

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

Określa, czy aplikacja może korzystać z sieci, gdy sieć VPN nie jest połączona i zasada alwaysOnVpnPackage.lockdownEnabled jest włączona. Jeśli zasada ma wartość VPN_LOCKDOWN_ENFORCED, aplikacja nie może korzystać z sieci, a jeśli ma wartość VPN_LOCKDOWN_EXEMPTION, może korzystać z sieci. Obsługiwane tylko na urządzeniach z Androidem 10 lub nowszym. Jeśli urządzenie nie obsługuje tej funkcji, będzie zawierać element NonComplianceDetail z wartością non_compliance_reason ustawioną na API_LEVEL i pole fieldPath. Jeśli nie dotyczy to aplikacji, urządzenie będzie zawierać element NonComplianceDetail z ustawionym polem non_compliance_reason na wartość UNSUPPORTED i polem fieldPath. Wartość fieldPath to applications[i].alwaysOnVpnLockdownExemption, gdzie i to indeks pakietu w zasadzie applications.

workProfileWidgets

enum (WorkProfileWidgets)

Określa, czy aplikacja zainstalowana w profilu służbowym może dodawać widżety do ekranu głównego.

credentialProviderPolicy

enum (CredentialProviderPolicy)

Opcjonalnie. Określa, czy aplikacja może działać jako dostawca danych logowania na urządzeniach z Androidem 14 lub nowszym.

customAppConfig

object (CustomAppConfig)

Opcjonalnie. Konfiguracja tej aplikacji niestandardowej.

Aby można było ustawić tę wartość, pole install_type musi mieć wartość CUSTOM.

installConstraint[]

object (InstallConstraint)

Opcjonalnie. Ograniczenia dotyczące instalacji aplikacji. Możesz określić maksymalnie 1 warunek InstallConstraint. Wiele ograniczeń jest odrzucanych.

installPriority

integer

Opcjonalnie. Wśród aplikacji, w których installType jest ustawione na:

  • FORCE_INSTALLED
  • PREINSTALLED

określa względny priorytet instalacji. Wartość 0 (domyślna) oznacza, że ta aplikacja nie ma priorytetu przed innymi aplikacjami. W przypadku wartości z zakresu od 1 do 10 000 niższa wartość oznacza wyższy priorytet. Wartości spoza zakresu od 0 do 10 000 włącznie są odrzucane.

userControlSettings

enum (UserControlSettings)

Opcjonalnie. Określa, czy użytkownik może kontrolować aplikację. Kontrola użytkownika obejmuje takie działania jak wymuszenie zatrzymania i wyczyszczenie danych aplikacji. Niektóre typy aplikacji są traktowane w specjalny sposób. Więcej informacji znajdziesz w sekcjach USER_CONTROL_SETTINGS_UNSPECIFIEDUSER_CONTROL_ALLOWED.

preferentialNetworkId

enum (PreferentialNetworkId)

Opcjonalnie. Identyfikator preferowanej sieci, z której korzysta aplikacja. W preferentialNetworkServiceConfigs musi być konfiguracja dla określonego identyfikatora sieci. Jeśli wartość to PREFERENTIAL_NETWORK_ID_UNSPECIFIED, aplikacja będzie używać domyślnego identyfikatora sieci określonego w parametrze defaultPreferentialNetworkId. Listę aplikacji wykluczonych z tego ustawienia domyślnego znajdziesz w dokumentacji defaultPreferentialNetworkId. Dotyczy to zarówno profili służbowych, jak i w pełni zarządzanych urządzeń z Androidem 13 lub nowszym.

signingKeyCerts[]

object (ApplicationSigningKeyCert)

Opcjonalnie. Certyfikaty klucza podpisywania aplikacji.

To pole jest wymagane w tych przypadkach:

  • Aplikacja ma ustawienie installType ustawione na CUSTOM (czyli jest aplikacją niestandardową).
  • Aplikacja ma ustawioną niepustą listę roles, ale nie jest dostępna w Sklepie Play.
  • Aplikacja ma ustawioną wartość extensionConfig (czyli jest aplikacją rozszerzającą), ale nie ma ustawionej wartości ExtensionConfig.signingKeyFingerprintsSha256 (wartość wycofana) i nie jest dostępna w Sklepie Play.

Jeśli to pole nie jest ustawione w przypadku aplikacji niestandardowej, zasada zostanie odrzucona. Jeśli nie jest ustawiony, gdy jest wymagany w przypadku aplikacji niestandardowej, zgłaszany jest znak NonComplianceDetail z symbolem INVALID_VALUE.

W innych przypadkach to pole jest opcjonalne i używane są certyfikaty klucza podpisywania uzyskane ze Sklepu Play.

Aby dowiedzieć się, jak używane jest to pole, zapoznaj się z tymi ustawieniami zasad:

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

object (Role)

Opcjonalnie. Role, które ma aplikacja.

Aplikacje z określonymi rolami mogą być zwolnione z ograniczeń dotyczących zasilania i działania w tle, zawieszania i hibernacji na urządzeniach z Androidem 14 lub nowszym. W przypadku aplikacji z określonymi rolami na Androidzie 11 i nowszym można też zablokować możliwość sterowania przez użytkownika. Więcej informacji znajdziesz w dokumentacji poszczególnych RoleType.

Aplikacja jest powiadamiana o przypisanych do niej rolach, jeśli ma usługę odbiornika powiadomień z uprawnieniem <meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLES" android:value="" />. Aplikacja otrzymuje powiadomienie za każdym razem, gdy jej role zostaną zaktualizowane lub po zainstalowaniu aplikacji, jeśli ma ona niepustą listę ról. Aplikacja może użyć tego powiadomienia, aby uruchomić się po instalacji. Więcej informacji o wymaganiach dotyczących usługi znajdziesz w przewodnikach Integracja z pakietem AMAPI SDKZarządzanie rolami aplikacji.

Aby zastosować wyjątki i powiadomić aplikację o rolach, odcisk palca certyfikatu klucza podpisywania aplikacji na urządzeniu musi być zgodny z jednym z odcisków palca certyfikatu klucza podpisywania uzyskanym ze Sklepu Play lub z jednym z wpisów w ApplicationPolicy.signingKeyCerts. W przeciwnym razie zgłaszany jest NonComplianceDetail z wartością APP_SIGNING_CERT_MISMATCH.

Nie może być zduplikowanych ról z tym samym roleType. Wiele aplikacji nie może mieć roli z tym samym roleType. Rola o typie ROLE_TYPE_UNSPECIFIED jest niedozwolona.

PermissionGrant

Zapis JSON
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
Pola
permission

string

Uprawnienie lub grupa na Androidzie, np. android.permission.READ_CALENDAR lub android.permission_group.CALENDAR.

policy

enum (PermissionPolicy)

Zasady przyznawania uprawnień.

Struct

Zapis JSON
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

Zapis JSON
{
  "key": string,
  "value": value
}
Pola
key

string

value

value (Value format)

Wartość

Zapis 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.
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje wartość null.

numberValue

number

Reprezentuje wartość typu double.

stringValue

string

Reprezentuje wartość ciągu tekstowego.

boolValue

boolean

Reprezentuje wartość logiczną.

structValue

object (Struct format)

Reprezentuje wartość strukturalną.

listValue

array (ListValue format)

Oznacza powtórzone Value.

ListValue

Zapis JSON
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Powtórzone pole wartości o dynamicznym typie.

ManagedConfigurationTemplate

Zapis JSON
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
Pola
templateId

string

Identyfikator szablonu konfiguracji zarządzanych.

configurationVariables

map (key: string, value: string)

Opcjonalnie mapa zawierająca zmienne konfiguracji <klucz, wartość> zdefiniowane dla konfiguracji.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ConfigurationVariablesEntry

Zapis JSON
{
  "key": string,
  "value": string
}
Pola
key

string

value

string

ExtensionConfig

Zapis JSON
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
Pola
signingKeyFingerprintsSha256[]
(deprecated)

string

Zaszyfrowane szesnastkowo hasze SHA-256 certyfikatów kluczy podpisywania aplikacji rozszerzenia. Prawidłowe są tylko ciągi szesnastkowe o długości 64 znaków.

Odciski cyfrowe certyfikatów kluczy podpisywania są zawsze pobierane ze Sklepu Play, a to pole służy do podawania dodatkowych odcisków cyfrowych certyfikatów kluczy podpisywania. Jeśli jednak aplikacja nie jest dostępna w Sklepie Play, to pole musi być ustawione. Jeśli to pole nie jest ustawione, gdy aplikacja nie jest dostępna w Sklepie Play, zgłaszany jest błąd NonComplianceDetail z kodem INVALID_VALUE.

Aby aplikacja rozszerzenia na urządzeniu mogła komunikować się z zasadami dotyczącymi urządzeń z Androidem, odcisk cyfrowy certyfikatu klucza podpisywania musi być zgodny z jednym z odcisków cyfrowych certyfikatu klucza podpisywania uzyskanych ze Sklepu Play lub z odciskami podanymi w tym polu.

W przypadku zastosowań produkcyjnych zalecamy pozostawienie tego pola pustego.

notificationReceiver
(deprecated)

string

Pełna nazwa klasy usługi odbiornika, która umożliwia aplikacji Android Device Policy powiadamianie aplikacji rozszerzenia o wszelkich aktualizacjach stanu poleceń lokalnych. Usługa musi być wyeksportowana w pliku AndroidManifest.xml aplikacji rozszerzenia i rozszerzać NotificationReceiverService (więcej informacji znajdziesz w przewodniku Integracja z pakietem AMAPI SDK).

CustomAppConfig

Zapis JSON
{
  "userUninstallSettings": enum (UserUninstallSettings)
}
Pola
userUninstallSettings

enum (UserUninstallSettings)

Opcjonalnie. Użytkownik odinstalowuje ustawienia aplikacji niestandardowej.

InstallConstraint

Zapis JSON
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
Pola
networkTypeConstraint

enum (NetworkTypeConstraint)

Opcjonalnie. Ograniczenie typu sieci.

chargingConstraint

enum (ChargingConstraint)

Opcjonalnie. Ograniczenie ładowania.

deviceIdleConstraint

enum (DeviceIdleConstraint)

Opcjonalnie. Ograniczenie dotyczące nieaktywności urządzenia.

ApplicationSigningKeyCert

Zapis JSON
{
  "signingKeyCertFingerprintSha256": string
}
Pola
signingKeyCertFingerprintSha256

string (bytes format)

Wymagane. Wartość skrótu SHA-256 certyfikatu klucza podpisywania aplikacji. Musi to być prawidłowa wartość skrótu SHA-256, czyli 32 bajty. W przeciwnym razie zasada zostanie odrzucona.

Ciąg tekstowy zakodowany w formacie Base64.

Rola

Zapis JSON
{
  "roleType": enum (RoleType)
}
Pola
roleType

enum (RoleType)

Wymagane. Typ roli, jaką może mieć aplikacja.

PersistentPreferredActivity

Zapis JSON
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
Pola
receiverActivity

string

Działanie, które powinno być domyślnym modułem obsługi intencji. Powinna to być nazwa komponentu Androida, np. com.android.enterprise.app/.MainActivity. Może to być też nazwa pakietu aplikacji, która powoduje, że zasady dotyczące urządzeń z Androidem wybierają odpowiednią aktywność z aplikacji do obsługi intencji.

actions[]

string

Działania intencji, które mają być dopasowane w filtrze. Jeśli filtr zawiera jakiekolwiek działania, działanie intencji musi być jedną z tych wartości, aby pasowało do filtra. Jeśli nie uwzględnisz żadnych działań, działanie związane z intencją zostanie zignorowane.

categories[]

string

Kategorie intencji, które mają być uwzględnione w filtrze. Intencja zawiera kategorie, których wymaga. Aby dopasować intencję, wszystkie te kategorie muszą być uwzględnione w filtrze. Innymi słowy, dodanie kategorii do filtra nie ma wpływu na dopasowywanie, chyba że kategoria jest określona w intencji.

SystemUpdate

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

enum (SystemUpdateType)

Typ aktualizacji systemu do skonfigurowania.

startMinutes

integer

Jeśli typ to WINDOWED, początek okresu konserwacji, mierzony jako liczba minut po północy w czasie lokalnym urządzenia. Wartość musi mieścić się w przedziale od 0 do 1439 włącznie.

endMinutes

integer

Jeśli typ to WINDOWED, jest to koniec okresu konserwacji mierzony jako liczba minut po północy w czasie lokalnym urządzenia. Wartość musi mieścić się w przedziale od 0 do 1439 włącznie. Jeśli ta wartość jest mniejsza niż start_minutes, okres konserwacji obejmuje północ. Jeśli określony okres konserwacji jest krótszy niż 30 minut, zostanie on wydłużony do 30 minut od godziny rozpoczęcia.

allowedDaysWithoutUpdate

integer

Jeśli ta wartość jest większa od zera, oznacza to liczbę dni, przez które urządzenie może zachować zgodność po udostępnieniu oczekującej aktualizacji, bez jej instalowania. Nie ma to żadnego innego wpływu.

freezePeriods[]

object (FreezePeriod)

Powtarzający się co roku okres, w którym aktualizacje systemu OTA są odkładane, aby zamrozić wersję systemu operacyjnego działającą na urządzeniu. Aby zapobiec trwałemu zablokowaniu urządzenia, każdy okres blokady musi być oddzielony od kolejnego co najmniej 60-dniowym odstępem.

FreezePeriod

Zapis JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Pola
startDate

object (Date)

Data rozpoczęcia okresu zamrożenia (włącznie z tym dniem). Uwaga: należy ustawić wartości daymonth. Nie należy ustawiać wartości year, ponieważ nie jest ona używana. Na przykład: {"month": 1,"date": 30}.

endDate

object (Date)

Data zakończenia okresu zamrożenia (włącznie z tym dniem). Nie może przypadać później niż 90 dni od daty rozpoczęcia. Jeśli data zakończenia jest wcześniejsza niż data rozpoczęcia, okres zamrożenia jest uznawany za obejmujący koniec roku. Uwaga: należy ustawić wartości daymonth. Nie należy ustawiać wartości year, ponieważ nie jest ona używana. Na przykład: {"month": 1,"date": 30}.

Data

Zapis JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.

month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok albo rok i miesiąc, w których dzień nie ma znaczenia.

StatusReportingSettings

Zapis 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
}
Pola
applicationReportsEnabled

boolean

Czy raporty o aplikacjach są włączone.

deviceSettingsEnabled

boolean

informacji, czy raportowanie ustawień urządzenia jest włączone.

softwareInfoEnabled

boolean

czy raportowanie informacji o oprogramowaniu jest włączone.

memoryInfoEnabled

boolean

Określa, czy raportowanie zdarzeń związanych z pamięcią jest włączone.

networkInfoEnabled

boolean

Czy raportowanie informacji o sieci jest włączone.

displayInfoEnabled

boolean

Określa, czy raportowanie wyświetleń jest włączone. Dane raportu nie są dostępne w przypadku urządzeń należących do użytkownika, na których skonfigurowano profil służbowy.

powerManagementEventsEnabled

boolean

Określa, czy raportowanie zdarzeń zarządzania energią jest włączone. Dane raportu nie są dostępne w przypadku urządzeń należących do użytkownika, na których skonfigurowano profil służbowy.

hardwareStatusEnabled

boolean

Określa, czy raportowanie stanu sprzętu jest włączone. Dane raportu nie są dostępne w przypadku urządzeń należących do użytkownika, na których skonfigurowano profil służbowy.

systemPropertiesEnabled

boolean

Czy raportowanie właściwości systemu jest włączone.

applicationReportingSettings

object (ApplicationReportingSettings)

Ustawienia raportowania aplikacji. Ma zastosowanie tylko wtedy, gdy application_reports_enabled ma wartość true.

commonCriteriaModeEnabled

boolean

Czy raportowanie Common Criteria Mode jest włączone. Ta funkcja jest obsługiwana tylko na urządzeniach należących do firmy.

defaultApplicationInfoReportingEnabled

boolean

Opcjonalnie. Czy raportowanie defaultApplicationInfo jest włączone.

ApplicationReportingSettings

Zapis JSON
{
  "includeRemovedApps": boolean
}
Pola
includeRemovedApps

boolean

Określa, czy usunięte aplikacje są uwzględniane w raportach o aplikacjach.

UserFacingMessage

Zapis JSON
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Pola
localizedMessages

map (key: string, value: string)

Mapa zawierająca pary <locale, message>, gdzie locale to prawidłowo sformułowany kod języka BCP 47, np. en-US, es-ES lub fr.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

defaultMessage

string

Domyślny komunikat wyświetlany, jeśli nie określono zlokalizowanego komunikatu lub język użytkownika nie pasuje do żadnego z nich. Jeśli podano jakiekolwiek zlokalizowane wiadomości, należy podać domyślną wiadomość.

LocalizedMessagesEntry

Zapis JSON
{
  "key": string,
  "value": string
}
Pola
key

string

value

string

PasswordRequirements

Zapis 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)
}
Pola
passwordMinimumLength

integer

Minimalna dozwolona długość hasła. Wartość 0 oznacza brak ograniczeń. Wymagane tylko wtedy, gdy wartość parametru password_quality to NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC lub COMPLEX.

passwordMinimumLetters

integer

Minimalna liczba liter wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordMinimumLowerCase

integer

Minimalna liczba małych liter wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordMinimumNonLetter

integer

Minimalna liczba znaków innych niż litery (cyfr lub symboli) wymaganych w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordMinimumNumeric

integer

Minimalna liczba cyfr wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordMinimumSymbols

integer

Minimalna liczba symboli wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordMinimumUpperCase

integer

Minimalna liczba wielkich liter wymaganych w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.

passwordQuality

enum (PasswordQuality)

Wymagana jakość hasła.

passwordHistoryLength

integer

Długość historii haseł. Po ustawieniu tego pola użytkownik nie będzie mógł wpisać nowego hasła, które jest takie samo jak którekolwiek hasło w historii. Wartość 0 oznacza brak ograniczeń.

maximumFailedPasswordsForWipe

integer

Liczba nieprawidłowych haseł odblokowujących urządzenie, które można wpisać przed wyczyszczeniem urządzenia. Wartość 0 oznacza brak ograniczeń.

passwordExpirationTimeout

string (Duration format)

Czas wygaśnięcia hasła.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

passwordScope

enum (PasswordPolicyScope)

Zakres, którego dotyczy wymaganie dotyczące hasła.

requirePasswordUnlock

enum (RequirePasswordUnlock)

Okres, po którym urządzenie lub profil służbowy odblokowany za pomocą silnej formy uwierzytelniania (hasła, kodu PIN, wzoru) może zostać odblokowany za pomocą dowolnej innej metody uwierzytelniania (np. odcisku palca, zaufanych agentów, rozpoznawania twarzy). Po upływie określonego czasu do odblokowania urządzenia lub profilu służbowego można używać tylko silnych metod uwierzytelniania.

unifiedLockSettings

enum (UnifiedLockSettings)

Określa, czy na urządzeniach z Androidem 9 lub nowszym z profilem służbowym dozwolona jest ujednolicona blokada urządzenia i profilu służbowego. Można ją skonfigurować tylko wtedy, gdy zasada password_scope ma wartość SCOPE_PROFILE. W przeciwnym razie zasada zostanie odrzucona. Jeśli użytkownik nie ustawił osobnej blokady służbowej, a to pole ma wartość REQUIRE_SEPARATE_WORK_LOCK, zgłaszany jest NonComplianceDetail z polem nonComplianceReason ustawionym na USER_ACTION.

Czas trwania

Zapis JSON
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Podpisane sekundy przedziału czasu. Musi mieścić się w zakresie od -315 576 000 000 do +315 576 000 000 włącznie. Uwaga: te granice są obliczane na podstawie: 60 s/min * 60 min/godz. * 24 godz./dzień * 365,25 dni/rok * 10 000 lat.

nanos

integer

Podpisane ułamki sekundy w nanosekundowej rozdzielczości przedziału czasu. Czasy trwania krótsze niż sekunda są reprezentowane przez pole 0 seconds i pole nanos z wartością dodatnią lub ujemną. W przypadku czasów trwania wynoszących co najmniej 1 sekundę wartość pola nanos musi mieć ten sam znak co pole seconds. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie.

PackageNameList

Zapis JSON
{
  "packageNames": [
    string
  ]
}
Pola
packageNames[]

string

Lista nazw pakietów.

ProxyInfo

Zapis JSON
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
Pola
host

string

Host bezpośredniego serwera proxy.

port

integer

Port bezpośredniego serwera proxy.

excludedHosts[]

string

W przypadku serwera proxy bezpośredniego są to hosty, dla których serwer proxy jest pomijany. Nazwy hostów mogą zawierać symbole wieloznaczne, np. *.example.com.

pacUri

string

Identyfikator URI skryptu PAC używanego do konfigurowania serwera proxy.

ChoosePrivateKeyRule

Zapis JSON
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
Pola
urlPattern

string

Wzorzec adresu URL, który ma być porównywany z adresem URL żądania. Jeśli nie jest ustawiona lub jest pusta, pasuje do wszystkich adresów URL. Używana jest składnia wyrażeń regularnych java.util.regex.Pattern.

packageNames[]

string

Nazwy pakietów, do których ma zastosowanie ta reguła. Odcisk cyfrowy certyfikatu klucza podpisywania aplikacji jest weryfikowany na podstawie odcisków cyfrowych certyfikatu klucza podpisywania dostarczonych przez Sklep Play i ApplicationPolicy.signingKeyCerts . Jeśli nie podasz nazw pakietów, alias będzie dostępny dla wszystkich aplikacji, które wywołują funkcję KeyChain.choosePrivateKeyAlias lub jej przeciążenia (ale nie bez wywołania funkcji KeyChain.choosePrivateKeyAlias, nawet na Androidzie 11 i nowszych wersjach). Każda aplikacja z tym samym identyfikatorem UID Androida co pakiet określony w tym miejscu będzie mieć dostęp, gdy wywoła KeyChain.choosePrivateKeyAlias.

privateKeyAlias

string

Alias klucza prywatnego, który ma być używany.

AlwaysOnVpnPackage

Zapis JSON
{
  "packageName": string,
  "lockdownEnabled": boolean
}
Pola
packageName

string

Nazwa pakietu aplikacji VPN.

lockdownEnabled

boolean

Blokuje połączenia sieciowe, gdy VPN nie jest połączony.

ComplianceRule

Zapis 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.
}
Pola
disableApps

boolean

Jeśli ma wartość „true”, reguła zawiera działanie łagodzące, które polega na wyłączeniu aplikacji, aby urządzenie było w praktyce wyłączone, ale dane aplikacji zostały zachowane. Jeśli na urządzeniu działa aplikacja w trybie zablokowanego zadania, zostanie ona zamknięta i wyświetli się interfejs z informacją o przyczynie niezgodności.

packageNamesToDisable[]

string

Jeśli ta opcja jest włączona, reguła zawiera działanie ograniczające, które wyłącza aplikacje określone na liście, ale dane aplikacji są zachowywane.

Pole zbiorcze condition. Warunek, który po spełnieniu uruchamia działania łagodzące zdefiniowane w regule. Musi być ustawiony dokładnie jeden z warunków. condition może mieć tylko jedną z tych wartości:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

Warunek, który jest spełniony, jeśli dla urządzenia istnieje jakikolwiek pasujący NonComplianceDetail.

apiLevelCondition

object (ApiLevelCondition)

Warunek, który jest spełniony, jeśli poziom interfejsu API platformy Android na urządzeniu nie spełnia minimalnych wymagań.

NonComplianceDetailCondition

Zapis JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
Pola
settingName

string

Nazwa ustawienia zasady. Jest to nazwa pola JSON pola Policy najwyższego poziomu. Jeśli nie jest ustawiony, ten warunek pasuje do dowolnej nazwy ustawienia.

nonComplianceReason

enum (NonComplianceReason)

Powód, dla którego urządzenie nie jest zgodne z ustawieniem. Jeśli nie jest ustawiony, ten warunek pasuje do każdej przyczyny.

packageName

string

Nazwa pakietu aplikacji, która nie jest zgodna z zasadami. Jeśli nie zostanie ustawiony, ten warunek będzie pasował do dowolnej nazwy pakietu.

ApiLevelCondition

Zapis JSON
{
  "minApiLevel": integer
}
Pola
minApiLevel

integer

Minimalny wymagany poziom interfejsu API platformy Android. Jeśli urządzenie nie spełnia minimalnych wymagań, ten warunek jest spełniony. Wartość musi być większa od zera.

SetupAction

Zapis 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.
}
Pola
title

object (UserFacingMessage)

Nazwa tego działania.

description

object (UserFacingMessage)

Opis tego działania.

Pole zbiorcze action. Działanie do wykonania podczas konfiguracji. action może mieć tylko jedną z tych wartości:
launchApp

object (LaunchAppAction)

Działanie polegające na uruchomieniu aplikacji. Aplikacja zostanie uruchomiona z intencją zawierającą dodatkowy klucz com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION ustawiony na wartość logiczną true, co oznacza, że jest to przepływ działania konfiguracji. Jeśli SetupAction odnosi się do aplikacji, odpowiednia wartość installType w zasadach dotyczących aplikacji musi być ustawiona jako REQUIRED_FOR_SETUP. W przeciwnym razie konfiguracja się nie powiedzie.

LaunchAppAction

Zapis JSON
{

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

Pole zbiorcze launch.

Pole launch może mieć tylko jedną z tych wartości:

packageName

string

Nazwa pakietu aplikacji, która ma zostać uruchomiona

PolicyEnforcementRule

Zapis 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.
}
Pola
blockAction

object (BlockAction)

Działanie blokujące dostęp do aplikacji i danych na urządzeniu należącym do firmy lub na profilu służbowym. Ta czynność powoduje też wysłanie do użytkownika powiadomienia z informacjami (w miarę możliwości) o tym, jak rozwiązać problem z zgodnością. Uwaga: musisz też określić parametr wipeAction.

wipeAction

object (WipeAction)

Działanie polegające na zresetowaniu urządzenia należącego do firmy lub usunięciu profilu służbowego. Uwaga: musisz też określić parametr blockAction.

Pole zbiorcze trigger. Warunek, który wywoła tę regułę. trigger może mieć tylko jedną z tych wartości:
settingName

string

Zasada najwyższego poziomu, która ma być egzekwowana. Na przykład applications lub passwordPolicies.

BlockAction

Zapis JSON
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
Pola
blockAfterDays

integer

Liczba dni, przez które zasady są niezgodne, zanim urządzenie lub profil służbowy zostaną zablokowane. Aby natychmiast zablokować dostęp, ustaw wartość 0. Wartość blockAfterDays musi być mniejsza niż wipeAfterDays.

blockScope

enum (BlockScope)

Określa zakres tego BlockAction. Dotyczy tylko urządzeń należących do firmy.

WipeAction

Zapis JSON
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
Pola
wipeAfterDays

integer

Liczba dni, przez które zasady są niezgodne, zanim urządzenie lub profil służbowy zostaną wyczyszczone. Wartość wipeAfterDays musi być większa niż blockAfterDays.

preserveFrp

boolean

Określa, czy dane dotyczące ochrony przed przywróceniem do ustawień fabrycznych są zachowywane na urządzeniu. To ustawienie nie dotyczy profili służbowych.

KioskCustomization

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

enum (PowerButtonActions)

Określa zachowanie urządzenia w trybie kiosku, gdy użytkownik naciśnie i przytrzyma przycisk zasilania.

systemErrorWarnings

enum (SystemErrorWarnings)

Określa, czy w trybie kiosku blokowane są okna dialogowe błędów systemowych dotyczące aplikacji, które uległy awarii lub przestały odpowiadać. Gdy aplikacja jest zablokowana, system wymusza jej zatrzymanie, tak jakby użytkownik wybrał w interfejsie opcję „Zamknij aplikację”.

systemNavigation

enum (SystemNavigation)

Określa, które funkcje nawigacji (np. przyciski ekranu głównego i przeglądu) są włączone w trybie kiosku.

statusBar

enum (StatusBar)

Określa, czy informacje o systemie i powiadomienia są wyłączone w trybie kiosku.

deviceSettings

enum (DeviceSettings)

Określa, czy aplikacja Ustawienia jest dozwolona w trybie kiosku.

AdvancedSecurityOverrides

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

enum (UntrustedAppsPolicy)

Zasady dotyczące niezaufanych aplikacji (aplikacji z nieznanych źródeł) egzekwowane na urządzeniu. Zastępuje install_unknown_sources_allowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Czy weryfikacja Google Play Protect jest wymuszana. Zastępuje parametr ensureVerifyAppsEnabled (wycofany).

developerSettings

enum (DeveloperSettings)

Kontroluje dostęp do ustawień programisty: opcji programisty i bezpiecznego rozruchu. Zastępuje wycofane funkcje safeBootDisableddebuggingFeaturesAllowed. Na urządzeniach osobistych z profilem służbowym ustawienie tej zasady nie spowoduje wyłączenia bezpiecznego rozruchu. W tym przypadku raportowany jest NonComplianceDetail z wartością MANAGEMENT_MODE.

commonCriteriaMode

enum (CommonCriteriaMode)

Kontroluje tryb Common Criteria – standardy bezpieczeństwa zdefiniowane w dokumencie Common Criteria for Information Technology Security Evaluation (CC). Włączenie trybu kryteriów wspólnych zwiększa poziom zabezpieczeń niektórych komponentów urządzenia. Więcej informacji znajdziesz w CommonCriteriaMode.

Ostrzeżenie: tryb Common Criteria wymusza stosowanie ścisłego modelu zabezpieczeń, który jest zwykle wymagany tylko w przypadku produktów IT używanych w systemach bezpieczeństwa narodowego i innych organizacjach o wysokim stopniu wrażliwości. Może to wpłynąć na standardowe korzystanie z urządzenia. Włączaj tylko w razie potrzeby. Jeśli tryb kryteriów wspólnych zostanie wyłączony po wcześniejszym włączeniu, wszystkie sieci Wi-Fi skonfigurowane przez użytkownika mogą zostać utracone, a wszystkie sieci Wi-Fi skonfigurowane przez firmę, które wymagają interwencji użytkownika, mogą wymagać ponownej konfiguracji.

personalAppsThatCanReadWorkNotifications[]

string

Aplikacje osobiste, które mogą odczytywać powiadomienia z profilu służbowego za pomocą NotificationListenerService. Domyślnie żadne aplikacje osobiste (z wyjątkiem aplikacji systemowych) nie mogą odczytywać powiadomień służbowych. Każda wartość na liście musi być nazwą pakietu.

mtePolicy

enum (MtePolicy)

Opcjonalnie. Kontroluje Memory Tagging Extension (MTE) na urządzeniu. Aby zastosować zmiany w zasadach MTE, musisz ponownie uruchomić urządzenie. W Androidzie 15 i nowszych zgłaszany jest stan NonComplianceDetail z wartością PENDING, jeśli zmiana zasady oczekuje na ponowne uruchomienie urządzenia.

contentProtectionPolicy

enum (ContentProtectionPolicy)

Opcjonalnie. Określa, czy ochrona treści, która skanuje w poszukiwaniu podejrzanych aplikacji, jest włączona. Ta funkcja jest obsługiwana na urządzeniach z Androidem 15 lub nowszym.

PersonalUsagePolicies

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

boolean

Jeśli wartość to prawda, kamera jest wyłączona w profilu osobistym.

screenCaptureDisabled

boolean

Jeśli ta zasada ma wartość Prawda, przechwytywanie ekranu jest wyłączone u wszystkich użytkowników.

accountTypesWithManagementDisabled[]

string

Typy kont, którymi użytkownik nie może zarządzać.

maxDaysWithWorkOff

integer

Określa, jak długo profil służbowy może być wyłączony. Minimalny czas trwania musi wynosić co najmniej 3 dni. Pozostałe szczegóły:

  • Jeśli czas trwania jest ustawiony na 0, funkcja jest wyłączona.
  • Jeśli czas trwania jest ustawiony na wartość mniejszą niż minimalny czas trwania, funkcja zwraca błąd.
Uwaga: jeśli chcesz uniknąć zawieszenia profili osobistych podczas długich okresów nieaktywności, możesz tymczasowo ustawić dużą wartość tego parametru.

personalPlayStoreMode

enum (PlayStoreMode)

Używane razem z personalApplications do kontrolowania, czy aplikacje w profilu osobistym są dozwolone czy zablokowane.

personalApplications[]

object (PersonalApplicationPolicy)

Zasady zastosowane w przypadku aplikacji w profilu osobistym.

privateSpacePolicy

enum (PrivateSpacePolicy)

Opcjonalnie. Określa, czy na urządzeniu można utworzyć przestrzeń prywatną.

bluetoothSharing

enum (BluetoothSharing)

Opcjonalnie. Czy udostępnianie przez Bluetooth jest dozwolone.

PersonalApplicationPolicy

Zapis JSON
{
  "packageName": string,
  "installType": enum (InstallType)
}
Pola
packageName

string

Nazwa pakietu aplikacji.

installType

enum (InstallType)

Typ instalacji do przeprowadzenia.

OncCertificateProvider

Zapis 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.
}
Pola
certificateReferences[]

string

Ta funkcja nie jest ogólnie dostępna.

Pole zbiorcze endpoint.

Ta funkcja nie jest ogólnie dostępna. Pole endpoint może mieć tylko jedną z tych wartości:

contentProviderEndpoint

object (ContentProviderEndpoint)

Ta funkcja nie jest ogólnie dostępna.

ContentProviderEndpoint

Zapis JSON
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
Pola
uri

string

Ta funkcja nie jest ogólnie dostępna.

packageName

string

Ta funkcja nie jest ogólnie dostępna.

signingCertsSha256[]

string

Wymagane. Ta funkcja nie jest ogólnie dostępna.

CrossProfilePolicies

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

enum (ShowWorkContactsInPersonalProfile)

Określa, czy aplikacje osobiste mogą uzyskiwać dostęp do kontaktów przechowywanych w profilu służbowym.

Zobacz też exemptions_to_show_work_contacts_in_personal_profile.

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

Czy tekst skopiowany z jednego profilu (osobistego lub służbowego) można wkleić w drugim profilu.

crossProfileDataSharing

enum (CrossProfileDataSharing)

Określa, czy dane z jednego profilu (osobistego lub służbowego) mogą być udostępniane aplikacjom w drugim profilu. Umożliwia kontrolowanie prostego udostępniania danych za pomocą intencji. Zarządzanie innymi kanałami komunikacji między profilami, takimi jak wyszukiwanie kontaktów, kopiowanie i wklejanie czy połączone aplikacje służbowe i osobiste, jest konfigurowane oddzielnie.

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

Określa domyślne działanie widżetów profilu służbowego. Jeśli zasada nie określa wartości work_profile_widgets dla konkretnej aplikacji, będzie ona działać zgodnie z wartością określoną tutaj.

crossProfileAppFunctions

enum (CrossProfileAppFunctions)

Opcjonalnie. Określa, czy aplikacje w profilu osobistym mogą wywoływać funkcje aplikacji udostępniane przez aplikacje w profilu służbowym.

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

Lista aplikacji wykluczonych z ustawienia ShowWorkContactsInPersonalProfile. Aby można było ustawić ten atrybut, atrybut ShowWorkContactsInPersonalProfile musi mieć jedną z tych wartości:

  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED W tym przypadku te wyjątki działają jak lista zablokowanych.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED. W takim przypadku te wyjątki działają jak lista dozwolonych.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM. W takim przypadku te wyjątki działają jako lista dozwolonych, oprócz aplikacji systemowych, które już są na tej liście.

Obsługiwane na urządzeniach z Androidem 14 lub nowszym. Jeśli wersja Androida jest starsza niż 14, zgłaszana jest wartość NonComplianceDetail z wartością API_LEVEL.

UsageLog

Zapis JSON
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
Pola
enabledLogTypes[]

enum (LogType)

Określa, które typy logów są włączone. Pamiętaj, że gdy rejestrowanie użycia jest włączone, użytkownicy będą otrzymywać wiadomości na urządzeniu.

uploadOnCellularAllowed[]

enum (LogType)

Określa, które z włączonych typów logów można przesyłać przez mobilną transmisję danych. Domyślnie dzienniki są umieszczane w kolejce do przesłania, gdy urządzenie połączy się z Wi-Fi.

DeviceConnectivityManagement

Zapis 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)
  }
}
Pola
usbDataAccess

enum (UsbDataAccess)

Określa, jakie pliki lub dane można przesyłać przez USB. Obsługiwane tylko na urządzeniach należących do firmy.

configureWifi

enum (ConfigureWifi)

Kontroluje uprawnienia do konfigurowania Wi-Fi. W zależności od wybranej opcji użytkownik będzie mieć pełną, ograniczoną lub żadną kontrolę nad konfigurowaniem sieci Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

Umożliwia konfigurowanie i używanie ustawień Wi-Fi Direct. Obsługiwane na urządzeniach należących do firmy z Androidem 13 lub nowszym.

tetheringSettings

enum (TetheringSettings)

Kontroluje ustawienia tetheringu. W zależności od ustawionej wartości użytkownik może mieć częściowo lub całkowicie zablokowaną możliwość korzystania z różnych form tetheringu.

wifiSsidPolicy

object (WifiSsidPolicy)

Ograniczenia dotyczące identyfikatorów SSID sieci Wi-Fi, z którymi urządzenie może się połączyć. Pamiętaj, że nie ma to wpływu na to, które sieci można skonfigurować na urządzeniu. Obsługiwane na urządzeniach należących do firmy z Androidem 13 lub nowszym.

wifiRoamingPolicy

object (WifiRoamingPolicy)

Opcjonalnie. zasady roamingu Wi-Fi,

bluetoothSharing

enum (BluetoothSharing)

Opcjonalnie. Określa, czy udostępnianie przez Bluetooth jest dozwolone.

preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

Opcjonalnie. Konfiguracja usługi preferencyjnej sieci. Ustawienie tego pola spowoduje zastąpienie wartości preferentialNetworkService. Można to ustawić zarówno w profilach służbowych, jak i na w pełni zarządzanych urządzeniach z Androidem 13 lub nowszym. Więcej informacji znajdziesz w przewodniku Dzielenie sieci 5G.

apnPolicy

object (ApnPolicy)

Opcjonalnie. zasady dotyczące nazwy punktu dostępu (APN), Konfiguracja nazw punktów dostępu (APN), która może zastąpić inne nazwy APN na urządzeniu. Więcej informacji znajdziesz w sekcjach OVERRIDE_APNS_ENABLEDoverrideApns.

WifiSsidPolicy

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

enum (WifiSsidPolicyType)

Typ zasady identyfikatora SSID sieci Wi-Fi do zastosowania.

wifiSsids[]

object (WifiSsid)

Opcjonalnie. Lista identyfikatorów SSID sieci Wi-Fi, które mają być stosowane w zasadach. To pole nie może być puste, gdy pole WifiSsidPolicyType ma wartość WIFI_SSID_ALLOWLIST. Jeśli ta lista nie jest pusta, w przypadku urządzeń z Androidem w wersji starszej niż 13 zgłaszany jest szczegół NonComplianceDetail z wartością API_LEVEL, a w przypadku urządzeń nienależących do firmy zgłaszany jest szczegół NonComplianceDetail z wartością MANAGEMENT_MODE.

WifiSsid

Zapis JSON
{
  "wifiSsid": string
}
Pola
wifiSsid

string

Wymagane. Identyfikator SSID sieci Wi-Fi przedstawiony jako ciąg znaków.

WifiRoamingPolicy

Zapis JSON
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
Pola
wifiRoamingSettings[]

object (WifiRoamingSetting)

Opcjonalnie. Ustawienia roamingu Wi-Fi. Identyfikatory SSID podane na tej liście muszą być unikalne. W przeciwnym razie zasady zostaną odrzucone.

WifiRoamingSetting

Zapis JSON
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
Pola
wifiSsid

string

Wymagane. Identyfikator SSID sieci Wi-Fi.

wifiRoamingMode

enum (WifiRoamingMode)

Wymagane. Tryb roamingu Wi-Fi dla określonego identyfikatora SSID.

PreferentialNetworkServiceSettings

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

object (PreferentialNetworkServiceConfig)

Wymagane. Preferencyjne konfiguracje usług sieciowych, które umożliwiają korzystanie z wielu segmentów sieciowych dla przedsiębiorstw. Nie może być wielu konfiguracji z tym samym preferentialNetworkId. Jeśli konfiguracja nie jest używana przez żadną aplikację (nie jest do niej odwoływana przez ustawienie ApplicationPolicy.preferentialNetworkId ani defaultPreferentialNetworkId), będzie ignorowana. W przypadku urządzeń w sieciach 4G należy dodatkowo skonfigurować firmową nazwę APN, aby skonfigurować połączenie transmisji danych na potrzeby preferencyjnej usługi sieciowej. Te nazwy APN można dodać za pomocą apnPolicy.

defaultPreferentialNetworkId

enum (PreferentialNetworkId)

Wymagane. Domyślny preferowany identyfikator sieci dla aplikacji, które nie znajdują się w applications lub jeśli ApplicationPolicy.preferentialNetworkId ma wartość PREFERENTIAL_NETWORK_ID_UNSPECIFIED. W preferentialNetworkServiceConfigs musi być konfiguracja dla podanego identyfikatora sieci, chyba że to pole ma wartość NO_PREFERENTIAL_NETWORK. Jeśli zasada ma wartość PREFERENTIAL_NETWORK_ID_UNSPECIFIED lub jest nieskonfigurowana, domyślna wartość to NO_PREFERENTIAL_NETWORK. Uwaga: jeśli domyślna preferowana sieć jest nieprawidłowo skonfigurowana, aplikacje bez ustawionej właściwości ApplicationPolicy.preferentialNetworkId nie będą mieć dostępu do internetu. To ustawienie nie dotyczy tych kluczowych aplikacji:

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

ApplicationPolicy.preferentialNetworkId można nadal używać do konfigurowania preferowanej sieci.

PreferentialNetworkServiceConfig

Zapis JSON
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
Pola
preferentialNetworkId

enum (PreferentialNetworkId)

Wymagane. Identyfikator sieci preferencyjnej. Nie może mieć wartości NO_PREFERENTIAL_NETWORK ani PREFERENTIAL_NETWORK_ID_UNSPECIFIED. W przeciwnym razie zasada zostanie odrzucona.

fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

Opcjonalnie. Czy dozwolone jest przełączanie na domyślną sieć na poziomie urządzenia. Jeśli ta zasada ma wartość FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED, zasada nonMatchingNetworks nie może mieć wartości NON_MATCHING_NETWORKS_DISALLOWED. W przeciwnym razie zasada zostanie odrzucona. Uwaga: jeśli to ustawienie jest włączone FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED, aplikacje nie mogą uzyskać dostępu do internetu, jeśli nie jest dostępny wycinek sieci 5G.

nonMatchingNetworks

enum (NonMatchingNetworks)

Opcjonalnie. Czy aplikacje, do których ma zastosowanie ta konfiguracja, mają być blokowane przed korzystaniem z sieci innych niż preferowana usługa. Jeśli to pole ma wartość NON_MATCHING_NETWORKS_DISALLOWED, pole fallbackToDefaultConnection musi mieć wartość FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED.

ApnPolicy

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

enum (OverrideApns)

Opcjonalnie. Czy zastępowanie punktów APN jest wyłączone czy włączone. Więcej informacji znajdziesz w sekcji DevicePolicyManager.setOverrideApnsEnabled.

apnSettings[]

object (ApnSetting)

Opcjonalnie. Ustawienia APN dla zastępowanych APN. Nie może występować żaden konflikt między podanymi ustawieniami APN, w przeciwnym razie zasady zostaną odrzucone. Dwa ApnSetting są uznawane za sprzeczne, gdy wszystkie te pola są zgodne w obu przypadkach: numericOperatorId, apn, proxyAddress, proxyPort, mmsProxyAddress, mmsProxyPort, mmsc, mvnoType, protocol, roamingProtocol. Jeśli niektóre ustawienia APN powodują niezgodność z zasadami INVALID_VALUE , zostaną zignorowane. Można to ustawić na w pełni zarządzanych urządzeniach z Androidem 10 lub nowszym. Można to też ustawić w profilach służbowych na Androidzie 13 i nowszym, ale tylko w przypadku ApnSettingENTERPRISE z typem APN. Jeśli wersja Androida jest starsza niż 10, zgłaszany jest symbol NonComplianceDetail z symbolem API_LEVEL. W przypadku profili służbowych na Androidzie w wersji starszej niż 13 zgłaszany jest NonComplianceDetailMANAGEMENT_MODE.

ApnSetting

Zapis 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
}
Pola
apnTypes[]

enum (ApnType)

Wymagane. Kategorie użycia punktu APN. Zasada zostanie odrzucona, jeśli to pole jest puste lub zawiera wartość APN_TYPE_UNSPECIFIED albo duplikaty. Na urządzeniach w pełni zarządzanych można ustawić wiele typów APN. ENTERPRISE to jedyny dozwolony typ APN w profilach służbowych. W przypadku innych wartości w profilach służbowych raportowany jest znak NonComplianceDetailMANAGEMENT_MODE. Typy APN, które nie są obsługiwane na urządzeniu lub w trybie zarządzania, zostaną zignorowane. Jeśli w wyniku tego otrzymasz pustą listę, ustawienie APN zostanie zignorowane, ponieważ apnTypes jest polem wymaganym. Wartość NonComplianceDetail z parametrem INVALID_VALUE jest zgłaszana, jeśli urządzenie lub tryb zarządzania nie obsługuje żadnego z typów APN.

apn

string

Wymagane. Nazwa APN. Jeśli to pole jest puste, zasady zostaną odrzucone.

displayName

string

Wymagane. Zrozumiała dla człowieka nazwa opisująca APN. Jeśli to pole jest puste, zasady zostaną odrzucone.

alwaysOnSetting

enum (AlwaysOnSetting)

Opcjonalnie. Określa, czy zasoby płaszczyzny użytkownika muszą być aktywowane podczas każdego przejścia z trybu CM-IDLE do stanu CM-CONNECTED dla tego APN. Patrz sekcja 5.6.13 w 3GPP TS 23.501.

authType

enum (AuthType)

Opcjonalnie. Typ uwierzytelniania APN.

carrierId

integer

Opcjonalnie. Identyfikator operatora sieci komórkowej dla punktu dostępu. Wartość 0 (domyślna) oznacza, że nie została ustawiona, a wartości ujemne są odrzucane.

mmsProxyAddress

string

Opcjonalnie. Adres serwera proxy MMS (Multimedia Messaging Service) punktu dostępu, który może być adresem IP lub nazwą hosta (nie adresem URL).

mmsProxyPort

integer

Opcjonalnie. Port proxy MMS (Multimedia Messaging Service) punktu dostępu. Wartość 0 (domyślna) oznacza, że nie została ustawiona, a wartości ujemne są odrzucane.

mmsc

string

Opcjonalnie. Identyfikator URI MMSC (Multimedia Messaging Service Center) punktu dostępu.

mtuV4

integer

Opcjonalnie. Domyślny rozmiar MTU (maksymalnej jednostki przesyłania) w bajtach w przypadku tras IPv4 skonfigurowanych przez to ustawienie APN. Wartość 0 (domyślna) oznacza, że nie została ustawiona, a wartości ujemne są odrzucane. Obsługiwane na urządzeniach z Androidem 13 lub nowszym. Jeśli wersja Androida jest starsza niż 13, zgłaszany jest NonComplianceDetail z wartością API_LEVEL.

mtuV6

integer

Opcjonalnie. Rozmiar MTU (Maximum Transmission Unit) interfejsu mobilnego IPv6, z którym połączony jest APN. Wartość 0 (domyślna) oznacza, że nie została ustawiona, a wartości ujemne są odrzucane. Obsługiwane na urządzeniach z Androidem 13 lub nowszym. Jeśli wersja Androida jest starsza niż 13, zgłaszany jest NonComplianceDetail z wartością API_LEVEL.

mvnoType

enum (MvnoType)

Opcjonalnie. Typ dopasowania MVNO dla APN.

networkTypes[]

enum (NetworkType)

Opcjonalnie. Technologie radiowe (typy sieci), z których może korzystać APN. Zasady zostaną odrzucone, jeśli to pole zawiera wartość NETWORK_TYPE_UNSPECIFIED lub duplikaty.

username

string

Opcjonalnie. Nazwa użytkownika punktu APN.

password

string

Opcjonalnie. Hasło APN.

numericOperatorId

string

Opcjonalnie. Numeryczny identyfikator operatora APN. Identyfikator operatora w postaci liczbowej jest zdefiniowany jako MCC (kod kraju komórki) + MNC (kod sieci komórkowej).

protocol

enum (Protocol)

Opcjonalnie. Protokół używany do łączenia się z tym APN.

roamingProtocol

enum (Protocol)

Opcjonalnie. Protokół, który ma być używany do łączenia się z tym punktem dostępu podczas roamingu urządzenia.

proxyAddress

string

Opcjonalnie. Adres serwera proxy APN.

proxyPort

integer

Opcjonalnie. Port serwera proxy APN. Wartość 0 (domyślna) oznacza, że nie została ustawiona, a wartości ujemne są odrzucane.

DeviceRadioState

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

enum (WifiState)

Określa bieżący stan Wi-Fi i to, czy użytkownik może go zmienić.

airplaneModeState

enum (AirplaneModeState)

Określa, czy użytkownik może włączać i wyłączać tryb samolotowy.

ultraWidebandState

enum (UltraWidebandState)

Określa stan ustawienia ultraszerokopasmowego i czy użytkownik może je włączać i wyłączać.

cellularTwoGState

enum (CellularTwoGState)

Określa, czy użytkownik może włączać i wyłączać ustawienie sieci komórkowej 2G.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

Minimalny wymagany poziom bezpieczeństwa sieci Wi-Fi, z którymi urządzenie może się połączyć.

userInitiatedAddEsimSettings

enum (UserInitiatedAddEsimSettings)

Opcjonalnie. Określa, czy użytkownik może dodawać profile eSIM.

DisplaySettings

Zapis JSON
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
Pola
screenBrightnessSettings

object (ScreenBrightnessSettings)

Opcjonalnie. Kontroluje ustawienia jasności ekranu.

screenTimeoutSettings

object (ScreenTimeoutSettings)

Opcjonalnie. Określa ustawienia automatycznego wygaszania.

ScreenBrightnessSettings

Zapis JSON
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
Pola
screenBrightnessMode

enum (ScreenBrightnessMode)

Opcjonalnie. Określa tryb jasności ekranu.

screenBrightness

integer

Opcjonalnie. Jasność ekranu w zakresie od 1 do 255, gdzie 1 to najniższa, a 255 – najwyższa jasność. Wartość 0 (domyślna) oznacza, że nie ustawiono jasności ekranu. Każda inna wartość jest odrzucana. Aby to ustawić, w polu screenBrightnessMode musi występować wartość BRIGHTNESS_AUTOMATIC lub BRIGHTNESS_FIXED. Obsługiwane na urządzeniach z Androidem 9 lub nowszym, którymi w pełni zarządza organizacja. Jeśli wersja Androida jest starsza niż 9, zgłaszana jest wartość NonComplianceDetail z wartością API_LEVEL. Obsługiwane w profilach służbowych na urządzeniach należących do firmy z Androidem 15 lub nowszym.

ScreenTimeoutSettings

Zapis JSON
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
Pola
screenTimeoutMode

enum (ScreenTimeoutMode)

Opcjonalnie. Określa, czy użytkownik może konfigurować limit czasu ekranu.

screenTimeout

string (Duration format)

Opcjonalnie. Określa czas, po którym ekran wygasa. Czas oczekiwania na wyłączenie ekranu musi być większy niż 0, w przeciwnym razie zostanie odrzucony. Nie powinna być też większa niż maximumTimeToLock, ponieważ w przeciwnym razie czas oczekiwania na wyłączenie ekranu zostanie ustawiony na maximumTimeToLock i zostanie zgłoszony błąd NonComplianceDetail z przyczyną INVALID_VALUE i szczegółową przyczyną SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK. Jeśli czas automatycznego wygaszania jest mniejszy niż określona dolna granica, zostanie ustawiony na tę wartość. Dolna granica może się różnić w zależności od urządzenia. Jeśli ta opcja jest ustawiona, pole screenTimeoutMode musi mieć wartość SCREEN_TIMEOUT_ENFORCED. Obsługiwane na urządzeniach z Androidem 9 lub nowszym, którymi w pełni zarządza organizacja. Jeśli wersja Androida jest starsza niż 9, zgłaszana jest wartość NonComplianceDetail z wartością API_LEVEL. Obsługiwane w profilach służbowych na urządzeniach należących do firmy z Androidem 15 lub nowszym.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

WorkAccountSetupConfig

Zapis JSON
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
Pola
authenticationType

enum (AuthenticationType)

Opcjonalnie. Typ uwierzytelniania użytkownika na urządzeniu.

requiredAccountEmail

string

Opcjonalnie. Adres e-mail konkretnego konta służbowego Google, które ma zostać dodane. To pole jest istotne tylko wtedy, gdy authenticationType ma wartość GOOGLE_AUTHENTICATED. Musi to być konto firmowe, a nie konto konsumenckie. Po ustawieniu tego pola i dodaniu do urządzenia uwierzytelnionego konta Google zmiana tego pola nie będzie miała żadnego wpływu, dlatego zalecamy ustawienie go tylko raz.

DefaultApplicationSetting

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

enum (DefaultApplicationType)

Wymagane. Typ aplikacji, dla której chcesz ustawić aplikację domyślną.

defaultApplications[]

object (DefaultApplication)

Wymagane. Lista aplikacji, które można ustawić jako domyślne dla danego typu. Lista nie może być pusta ani zawierać duplikatów. Pierwsza aplikacja na liście, która jest zainstalowana i spełnia wymagania dotyczące defaultApplicationType (np. aplikacja SMS dla DEFAULT_SMS), jest ustawiana jako domyślna. Aby można było ustawić aplikację jako domyślną, odcisk palca certyfikatu klucza podpisywania aplikacji na urządzeniu musi też być zgodny z jednym z odcisków palca certyfikatu klucza podpisywania uzyskanym ze Sklepu Play lub z jednym z wpisów w ApplicationPolicy.signingKeyCerts.

Jeśli defaultApplicationScopes zawiera SCOPE_FULLY_MANAGED lub SCOPE_WORK_PROFILE, aplikacja musi mieć wpis w applications z wartością installType inną niż BLOCKED.

Jeśli żadna z aplikacji na liście nie jest zainstalowana, zgłaszany jest NonComplianceDetail z przyczyną APP_NOT_INSTALLED i konkretną przyczyną DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE. Stan NonComplianceDetailINVALID_VALUE powodem i DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE konkretnym powodem jest zgłaszany, jeśli zainstalowano co najmniej 1 aplikację, ale zasady nie zostały zastosowane z innych powodów (np. aplikacja nie jest odpowiedniego typu).

W przypadku stosowania do SCOPE_PERSONAL_PROFILE na urządzeniu należącym do firmy z profilem służbowym jako domyślne można ustawić tylko wstępnie zainstalowane aplikacje systemowe. Jeśli zasady nie zostaną zastosowane w przypadku profilu osobistego, zgłaszany jest NonComplianceDetailINVALID_VALUE powodem i DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE konkretnym powodem.

defaultApplicationScopes[]

enum (DefaultApplicationScope)

Wymagane. Zakresy, do których powinna mieć zastosowanie zasada. Lista nie może być pusta ani zawierać duplikatów.

Raport o NonComplianceDetailMANAGEMENT_MODEDEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES jest generowany, jeśli żaden z określonych zakresów nie może być zastosowany w trybie zarządzania (np. w przypadku urządzenia w pełni zarządzanego, które otrzymuje zasady zawierające na liście tylko SCOPE_PERSONAL_PROFILE).

DefaultApplication

Zapis JSON
{
  "packageName": string
}
Pola
packageName

string

Wymagane. Nazwa pakietu, która powinna być ustawiona jako domyślna aplikacja. Jeśli nazwa pakietu jest nieprawidłowa, zasady zostaną odrzucone.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌