REST Resource: enterprises.policies

משאב: מדיניות

משאב מדיניות מייצג קבוצה של הגדרות שקובעות את ההתנהגות של מכשיר מנוהל ושל האפליקציות שמותקנות בו.

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

string

שם המדיניות בפורמט enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

גרסת המדיניות. זהו שדה לקריאה בלבד. הגרסה מתעדכנת בכל פעם שהמדיניות מתעדכנת.

applications[]

object (ApplicationPolicy)

המדיניות שחלה על אפליקציות. הרכיב יכול להכיל עד 3,000 רכיבים.

maximumTimeToLock

string (int64 format)

משך הזמן המקסימלי באלפיות השנייה של פעילות משתמש עד שהמכשיר ננעל. המשמעות של ערך 0 היא שאין הגבלה.

screenCaptureDisabled

boolean

אם צילום המסך מושבת.

cameraDisabled
(deprecated)

boolean

אם המשתנה cameraAccess מוגדר לערך שאינו CAMERA_ACCESS_UNSPECIFIED, אין לכך השפעה. אחרת, השדה הזה קובע אם המצלמות יהיו מושבתות: אם true, כל המצלמות יושבתו, אחרת הן זמינות. במכשירים מנוהלים, השדה הזה חל על כל האפליקציות במכשיר. בפרופילים של עבודה, השדה הזה רלוונטי רק לאפליקציות בפרופיל העבודה. אין השפעה על הגישה למצלמה של אפליקציות מחוץ לפרופיל העבודה.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

התאמות אישיות של מגן המקשים מושבתות, כמו ווידג'טים.

defaultPermissionPolicy

enum (PermissionPolicy)

מדיניות ההרשאות המוגדרת כברירת מחדל לבקשות הרשאה בתחילת ההפעלה.

persistentPreferredActivities[]

object (PersistentPreferredActivity)

פעילויות ברירת מחדל של handler של Intent.

openNetworkConfiguration

object (Struct format)

הגדרות הרשת של המכשיר. למידע נוסף, ראה הגדר רשתות.

systemUpdate

object (SystemUpdate)

מדיניות עדכוני המערכת, שקובעת איך חלים עדכוני מערכת הפעלה. אם סוג העדכון הוא WINDOWED, חלון העדכון יחול באופן אוטומטי גם על עדכוני אפליקציית Play.

accountTypesWithManagementDisabled[]

string

סוגי חשבונות שהמשתמשים לא יכולים לנהל.

addUserDisabled

boolean

האפשרות להוסיף משתמשים ופרופילים חדשים מושבתת.

adjustVolumeDisabled

boolean

האם הכוונון של עוצמת הקול הראשית מושבת. משתיק גם את המכשיר.

factoryResetDisabled

boolean

אם האיפוס להגדרות המקוריות מושבת.

installAppsDisabled

boolean

האם התקנת האפליקציות על ידי המשתמש מושבתת.

mountPhysicalMediaDisabled

boolean

אם המשתמש טוען מדיה פיזית חיצונית מושבתת.

modifyAccountsDisabled

boolean

האפשרות להוסיף או להסיר חשבונות מושבתת.

safeBootDisabled
(deprecated)

boolean

האפשרות להפעיל מחדש את המכשיר כדי להפעיל אותו בבטחה מושבתת.

uninstallAppsDisabled

boolean

האם הסרת ההתקנה של אפליקציות על ידי המשתמש מושבתת. הפעולה הזו מונעת הסרה של אפליקציות, גם כאלה שהוסרו באמצעות applications

statusBarDisabled
(deprecated)

boolean

האם שורת הסטטוס מושבתת. ההגדרה משביתה התראות, הגדרות מהירות ושכבות-על אחרות במסך שמאפשרות לצאת ממצב מסך מלא. הוצא משימוש. כדי להשבית את שורת הסטטוס במכשיר קיוסק, צריך להשתמש ב-InstallType KIOSK או ב-kioskCustomLauncherEnabled.

keyguardDisabled

boolean

אם True, הפעולה הזו תשבית את מסך הנעילה עבור המסכים הראשיים או המשניים.

minimumApiLevel

integer

רמת ה-API המינימלית המותרת ב-Android.

statusReportingSettings

object (StatusReportingSettings)

הגדרות דיווח על סטטוס

bluetoothContactSharingDisabled

boolean

אם התכונה 'שיתוף אנשי קשר' ב-Bluetooth מושבתת.

shortSupportMessage

object (UserFacingMessage)

הודעה שתוצג למשתמש במסך ההגדרות, בכל מקום שבו האדמין השבית את הפונקציונליות. אם ההודעה ארוכה מ-200 תווים, יכול להיות שהיא תיחתך.

longSupportMessage

object (UserFacingMessage)

הודעה המוצגת למשתמש במסך ההגדרות של מנהלי המכשיר.

passwordRequirements
(deprecated)

object (PasswordRequirements)

דרישות סיסמה. אין להגדיר את השדה passwordRequirements.require_password_unlock. הוצא משימוש – יש להשתמש ב-passwordPolicies.

הערה:

לא ניתן להשתמש כאן בערכים מבוססי מורכבות של PasswordQuality, כלומר COMPLEXITY_LOW, COMPLEXITY_MEDIUM ו-COMPLEXITY_HIGH. לא ניתן להשתמש כאן בunifiedLockSettings.

wifiConfigsLockdownEnabled
(deprecated)

boolean

הוצא משימוש – יש להשתמש ב-wifiConfigDisabled.

bluetoothConfigDisabled

boolean

האפשרות להגדיר Bluetooth מושבתת.

cellBroadcastsConfigDisabled

boolean

אם ההגדרה של שידור סלולרי מושבתת.

credentialsConfigDisabled

boolean

האפשרות להשבית את ההגדרה של פרטי כניסה של משתמשים.

mobileNetworksConfigDisabled

boolean

האפשרות להגדיר רשתות סלולריות מושבתת.

tetheringConfigDisabled
(deprecated)

boolean

האפשרות להגדיר שיתוף אינטרנט בין מכשירים ונקודות ניידות לשיתוף אינטרנט מושבתת. אם המדיניות tetheringSettings מוגדרת לערך כלשהו מלבד TETHERING_SETTINGS_UNSPECIFIED, המערכת תתעלם מההגדרה הזו.

vpnConfigDisabled

boolean

האם ההגדרה של ה-VPN מושבתת.

wifiConfigDisabled
(deprecated)

boolean

האפשרות להגדיר רשתות Wi-Fi מושבתת. נתמכת במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה. במכשירים שמנוהלים באופן מלא, ההגדרה הזו כ-True מסירה את כל הרשתות שהוגדרו ושומרת רק את הרשתות שהוגדרו באמצעות openNetworkConfiguration. לפרופילי עבודה במכשירים שבבעלות החברה, הרשתות המוגדרות לא יושפעו ואין למשתמש הרשאה להוסיף, להסיר או לשנות רשתות Wi-Fi. אם המדיניות configureWifi מוגדרת לערך כלשהו מלבד CONFIGURE_WIFI_UNSPECIFIED, המערכת תתעלם מההגדרה הזו. הערה: אם לא ניתן להתחבר לרשת בזמן ההפעלה והגדרת ה-Wi-Fi מושבתת, חלון היציאה מהרשת יוצג כדי לרענן את מדיניות המכשיר (ראו networkEscapeHatchEnabled).

createWindowsDisabled

boolean

האפשרות ליצור חלונות מלבד חלונות אפליקציה מושבתת.

networkResetDisabled

boolean

האם איפוס הגדרות הרשת מושבת.

outgoingBeamDisabled

boolean

האפשרות להשתמש ב-NFC כדי להעביר נתונים מאפליקציות מושבתת.

outgoingCallsDisabled

boolean

אם השיחות היוצאות מושבתות.

removeUserDisabled

boolean

האפשרות להסיר משתמשים אחרים מושבתת.

shareLocationDisabled

boolean

האם שיתוף המיקום מושבת. יש תמיכה ב-shareLocationDisabled גם במכשירים שמנוהלים באופן מלא וגם בפרופילי עבודה בבעלות אישית.

smsDisabled

boolean

השבתה של שליחה וקבלה של הודעות SMS.

unmuteMicrophoneDisabled
(deprecated)

boolean

אם המשתנה microphoneAccess מוגדר לערך שאינו MICROPHONE_ACCESS_UNSPECIFIED, אין לכך השפעה. אחרת, השדה הזה קובע אם המיקרופונים מושבתים: אם true, כל המיקרופונים מושבתים, אחרת הם יהיו זמינים. האפשרות הזו זמינה רק במכשירים שמנוהלים באופן מלא.

usbFileTransferDisabled
(deprecated)

boolean

האפשרות להעביר קבצים באמצעות USB מושבתת. אפשר להגדיר זאת רק במכשירים בבעלות החברה.

ensureVerifyAppsEnabled
(deprecated)

boolean

האם ההגדרה של אימות אפליקציות מופעלת באילוץ.

permittedInputMethods

object (PackageNameList)

אם יש חבילות כאלה, מותר להשתמש רק בשיטות הקלט שסופקו על ידי החבילות ברשימה הזו. אם השדה הזה קיים אבל הרשימה ריקה, מותר להשתמש רק בשיטות קלט של המערכת.

stayOnPluggedModes[]

enum (BatteryPluggedMode)

הסוללה שמחוברת למצבים שבהם המכשיר נשאר מופעל. כשמשתמשים בהגדרה הזו, מומלץ לנקות את maximumTimeToLock כדי שהמכשיר לא יינעל את עצמו בזמן שהוא פועל.

recommendedGlobalProxy

object (ProxyInfo)

שרת proxy גלובלי ל-HTTP שאינו תלוי ברשת. בדרך כלל צריך להגדיר שרתי proxy לכל רשת ב-openNetworkConfiguration. עם זאת, במקרה של הגדרות חריגות כמו סינון פנימי כללי, שרת proxy גלובלי של HTTP עשוי להיות שימושי. אם שרת ה-proxy לא נגיש, יכול להיות שהגישה לרשת תיקטע. שרת ה-Proxy הגלובלי הוא המלצה בלבד ואפליקציות מסוימות עשויות להתעלם ממנו.

setUserIconDisabled

boolean

השבתה של שינוי סמל המשתמש.

setWallpaperDisabled

boolean

האפשרות לשנות את הטפט מושבתת.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

כללים לקביעת הגישה של אפליקציות למפתחות פרטיים. את יכולה לראות עוד פרטים בכתובת ChoosePrivateKeyRule. השדה הזה חייב להיות ריק אם לאפליקציה כלשהי יש היקף הענקת הגישה של CERT_SELECTION.

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

הגדרה לחיבור VPN שפועל כל הזמן. כדי למנוע שינוי של ההגדרה הזו, צריך להשתמש בשילוב עם vpnConfigDisabled.

frpAdminEmails[]

string

כתובות האימייל של מנהלי המכשיר לצורך הגנה מפני איפוס להגדרות המקוריות. כשמאפסים את המכשיר להגדרות המקוריות, אחד מהאדמינים האלה יצטרך להתחבר עם כתובת האימייל והסיסמה של חשבון Google כדי לבטל את הנעילה של המכשיר. אם לא תציינו אדמינים, המכשיר לא יספק הגנה מפני איפוס להגדרות המקוריות.

deviceOwnerLockScreenInfo

object (UserFacingMessage)

פרטי בעלי המכשיר שיוצגו במסך הנעילה.

dataRoamingDisabled

boolean

האם שירותי נתונים בנדידה מושבתים.

locationMode

enum (LocationMode)

מידת ההפעלה של זיהוי המיקום.

networkEscapeHatchEnabled

boolean

אם פתח היציאה של הרשת מופעל. אם לא ניתן להתחבר לרשת בזמן ההפעלה, מפתח המילוט יבקש מהמשתמש להתחבר באופן זמני לרשת כדי לרענן את מדיניות המכשיר. אחרי החלת המדיניות, הרשת הזמנית תישכח והמכשיר ימשיך לאתחל את עצמו. המדיניות הזו מונעת את האפשרות להתחבר לרשת אם לא הוגדרה רשת מתאימה במדיניות האחרונה, והמכשיר מופעל ומופעל באפליקציה במצב משימת נעילה, או אם המשתמש לא יכול להגיע להגדרות המכשיר בדרך אחרת.

הערה: הגדרת הערך wifiConfigDisabled כ-True תבטל את ההגדרה הזו בנסיבות ספציפיות. פרטים נוספים זמינים בכתובת wifiConfigDisabled. אם מגדירים את הערך של configureWifi לערך 'DISALLOW_CONFIGURING_WIFI', ההגדרה הזו תבטל את ההגדרה הזו בנסיבות ספציפיות. פרטים נוספים זמינים בכתובת DISALLOW_CONFIGURING_WIFI.

bluetoothDisabled

boolean

אם ה-Bluetooth מושבת. עדיף להשתמש בהגדרה הזו על פני bluetoothConfigDisabled כי המשתמש יכול לעקוף את bluetoothConfigDisabled.

complianceRules[]
(deprecated)

object (ComplianceRule)

כללים שמצהירים אילו פעולות מקלות יש לבצע כשמכשיר לא תואם למדיניות שלו. כשהתנאים של כמה כללים מתקיימים, מתבצעות כל הפעולות המקלות על הכללים. אפשר להוסיף עד 100 כללים. השתמשו בכללי אכיפת המדיניות במקום זאת.

blockApplicationsEnabled
(deprecated)

boolean

אם האפשרות להתקין אפליקציות אחרות מלבד אלו שהוגדרו ב-applications חסומה. לאחר ההגדרה, אפליקציות שהותקנו במסגרת מדיניות קודמת אבל לא מופיעות יותר במדיניות מוסרות באופן אוטומטי.

installUnknownSourcesAllowed
(deprecated)

boolean

לשדה הזה אין השפעה.

debuggingFeaturesAllowed
(deprecated)

boolean

האם למשתמש מותר להפעיל תכונות לניפוי באגים.

funDisabled

boolean

האם מותר למשתמש ליהנות. המדיניות קובעת אם המשחק ביצי הפסחא בהגדרות מושבת.

autoTimeRequired
(deprecated)

boolean

אם נדרש זמן אוטומטי, ולכן המשתמש לא יכול להגדיר את התאריך והשעה באופן ידני. אם מגדירים את הערך autoDateAndTimeZone, המערכת מתעלמת מהשדה הזה.

permittedAccessibilityServices

object (PackageNameList)

מציינת שירותי נגישות מותרים. אם השדה לא מוגדר, ניתן להשתמש בכל שירות נגישות. אם השדה מוגדר, ניתן להשתמש רק בשירותי הנגישות שברשימה הזו ובשירות הנגישות המובנה של המערכת. באופן ספציפי, אם השדה מוגדר ריק, ניתן להשתמש רק בשירותי הנגישות המובנים של המערכת. אפשר להגדיר את ההרשאה הזו במכשירים מנוהלים ובפרופילי עבודה. אם מחילים אותם על פרופיל עבודה, הם משפיעים גם על הפרופיל האישי וגם על פרופיל העבודה.

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

חלופה מומלצת: המאפיין autoUpdateMode, שמוגדר לכל אפליקציה, מספק גמישות רבה יותר לגבי תדירות העדכון.

כשהערך בשדה autoUpdateMode הוא AUTO_UPDATE_POSTPONED או AUTO_UPDATE_HIGH_PRIORITY, לשדה הזה אין השפעה.

מדיניות העדכון האוטומטי של אפליקציות, שקובעת מתי ניתן להחיל עדכונים אוטומטיים של אפליקציות.

kioskCustomLauncherEnabled

boolean

האם מרכז האפליקציות בהתאמה אישית של קיוסק מופעל. הפעולה הזו מחליפה את מסך הבית במרכז אפליקציות נועל את המכשיר לאפליקציות שהותקנו באמצעות ההגדרה applications. האפליקציות מופיעות בדף יחיד בסדר אלפביתי. השתמש בkioskCustomization כדי להמשיך להגדיר את התנהגות מכשיר הקיוסק.

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

ההגדרה הזו לא נתמכת. המערכת תתעלם מכל ערך.

skipFirstUseHintsEnabled

boolean

ניתן לסמן כדי לדלג על רמזים בשימוש הראשון. מנהל חשבון ארגוני יכול להפעיל את המלצה המערכת לאפליקציות לדלג על המדריך למשתמש ועל רמזים מקדימים אחרים בהפעלה הראשונה.

privateKeySelectionEnabled

boolean

המדיניות מאפשרת להציג ממשק משתמש במכשיר כדי שלמשתמשים תהיה אפשרות לבחור כינוי פרטי למפתח פרטי, אם אין כללים תואמים ב-SelectPrivateKey Rules. במכשירים עם Android P מתחת ל-Android P, הגדרה זו עלולה לחשוף את המפתחות של הארגון לפגיעים. לערך הזה לא תהיה השפעה אם לאפליקציה כלשהי יש היקף הענקת הגישה CERT_SELECTION.

encryptionPolicy

enum (EncryptionPolicy)

האם ההצפנה מופעלת

usbMassStorageEnabled
(deprecated)

boolean

האם אחסון USB מופעל. הוּצא משימוש.

permissionGrants[]

object (PermissionGrant)

הרשאה מפורשת או קבוצה של הרשאות או דחיות, לכל האפליקציות. הערכים האלה מבטלים את הערך defaultPermissionPolicy.

playStoreMode

enum (PlayStoreMode)

המצב הזה קובע אילו אפליקציות זמינות למשתמש בחנות Play ואת ההתנהגות במכשיר כשמסירים אפליקציות מהמדיניות.

setupActions[]

object (SetupAction)

הפעולה שתבוצע בתהליך ההגדרה. ניתן לציין פעולה אחת לכל היותר.

passwordPolicies[]

object (PasswordRequirements)

המדיניות בנושא דרישות סיסמה. אפשר להגדיר כללי מדיניות שונים לפרופיל עבודה או למכשירים שמנוהלים באופן מלא, על ידי הגדרת השדה passwordScope במדיניות.

policyEnforcementRules[]

object (PolicyEnforcementRule)

כללים שמגדירים התנהגות כשלא ניתן להחיל מדיניות מסוימת במכשיר

kioskCustomization

object (KioskCustomization)

הגדרות שקובעות את התנהגות המכשיר במצב קיוסק. כדי להפעיל מצב קיוסק, צריך להגדיר את kioskCustomLauncherEnabled לערך true או לציין אפליקציה במדיניות עם installType KIOSK.

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

הגדרות אבטחה מתקדמות. ברוב המקרים אין צורך להגדיר אותן.

personalUsagePolicies

object (PersonalUsagePolicies)

כללי מדיניות לגבי השימוש האישי במכשיר בבעלות החברה.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

הפעלה של התאריך, השעה ואזור הזמן האוטומטיים במכשיר בבעלות החברה. אם המדיניות הזו מוגדרת, המערכת תתעלם מ-autoTimeRequired.

oncCertificateProviders[]

object (OncCertificateProvider)

התכונה הזו לא זמינה לכלל המשתמשים.

crossProfilePolicies

object (CrossProfilePolicies)

כללי מדיניות למספר פרופילים הוחלו על המכשיר.

preferentialNetworkService

enum (PreferentialNetworkService)

המדיניות הזו קובעת אם שירות הרשת המועדפת מופעל בפרופיל העבודה. לדוגמה, לארגון יכול להיות הסכם עם ספק שלפיו כל נתוני העבודה יישלחו דרך שירות רשת שמיועד לשימוש ארגוני. דוגמה לשירות רשת מועדף נתמך: פלח הארגון ברשתות 5G. אין לכך השפעה על מכשירים שמנוהלים באופן מלא.

usageLog

object (UsageLog)

הגדרת הרישום ביומן הפעילות במכשיר.

cameraAccess

enum (CameraAccess)

קובעת את השימוש במצלמה ואם למשתמש יש גישה למתג הגישה למצלמה.

microphoneAccess

enum (MicrophoneAccess)

קובעת את השימוש במיקרופון ואם למשתמש יש גישה למתג הגישה למיקרופון. הסעיף הזה רלוונטי רק למכשירים שמנוהלים באופן מלא.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

כיסויים לפקדים לקישוריות של המכשיר, כמו Wi-Fi, גישה לנתונים ב-USB, חיבורי מקלדת/עכבר ועוד.

deviceRadioState

object (DeviceRadioState)

כיסוי פקדים למצב רדיו כמו Wi-Fi, Bluetooth ועוד.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

המדיניות הזו קובעת אילו אפליקציות מורשות לפעול כספקי פרטי כניסה ב-Android מגרסה 14 ואילך. האפליקציות האלה שומרות פרטי כניסה. פרטים נוספים זמינים כאן וכאן. למידע נוסף, יש לעיין ב-credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

זה שינוי אופציונלי. המדיניות קובעת אם ניתן להדפיס. התכונה הזו נתמכת במכשירים עם Android מגרסה 9 ומעלה. .

ApplicationPolicy

מדיניות לגבי אפליקציה מסוימת. הערה: לא ניתן לשנות את זמינות האפליקציה במכשיר נתון באמצעות המדיניות הזו אם המדיניות installAppsDisabled מופעלת. מספר האפליקציות המרבי שניתן להגדיר לכל מדיניות הוא 3,000.

ייצוג JSON
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer
}
שדות
packageName

string

שם החבילה של האפליקציה. למשל, com.google.android.youtube של אפליקציית YouTube.

installType

enum (InstallType)

סוג ההתקנה שצריך לבצע.

lockTaskAllowed
(deprecated)

boolean

האם האפליקציה יכולה לנעול את עצמה במצב מסך מלא. הוצא משימוש. יש להשתמש ב-InstallType KIOSK או ב-kioskCustomLauncherEnabled כדי להגדיר מכשיר ייעודי.

defaultPermissionPolicy

enum (PermissionPolicy)

מדיניות ברירת המחדל לכל ההרשאות שהאפליקציה מבקשת. אם היא מוגדרת, היא מבטלת את defaultPermissionPolicy ברמת המדיניות, שתחול על כל האפליקציות. היא לא מבטלת את permissionGrants שחלה על כל האפליקציות.

permissionGrants[]

object (PermissionGrant)

הרשאות מפורשות שמעניקות או דחיות של הרשאות לאפליקציה. הערכים האלה מבטלים את defaultPermissionPolicy ו-permissionGrants שחלים על כל האפליקציות.

managedConfiguration

object (Struct format)

הגדרה מנוהלת הוחלה על האפליקציה. הפורמט של ההגדרה נקבע על ידי ערכי ManagedProperty שנתמכים על ידי האפליקציה. כל שם של שדה בהגדרה המנוהלת חייב להתאים לשדה key בשדה ManagedProperty. ערך השדה חייב להתאים לtype של ManagedProperty:

סוגערך JSON
BOOLtrue או false
STRINGמחרוזת
INTEGERnumber
CHOICEמחרוזת
MULTISELECTמערך של מחרוזות
HIDDENמחרוזת
BUNDLE_ARRAYמערך של אובייקטים

disabled

boolean

האם האפליקציה מושבתת. גם כשההגדרה מושבתת, נתוני האפליקציה נשמרים.

minimumVersionCode

integer

הגרסה המינימלית של האפליקציה שפועלת במכשיר. אם המדיניות מוגדרת, המכשיר ינסה לעדכן את האפליקציה לקוד הגרסה הזה לפחות. אם האפליקציה לא מעודכנת, המכשיר יכיל NonComplianceDetail עם nonComplianceReason שמוגדר ל-APP_NOT_UPDATED. האפליקציה חייבת להתפרסם ב-Google Play עם קוד גרסה גדול יותר מהערך הזה או שווה לו. לכל היותר 20 אפליקציות יכולות לציין קוד גרסה מינימלי לכל מדיניות.

delegatedScopes[]

enum (DelegatedScope)

היקפי ההרשאות שהועברו לאפליקציה מ-Android Device Policy. הרשאות אלה מספקות הרשאות נוספות עבור האפליקציות שעליהן הם חלים.

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

תבנית ההגדרות האישיות המנוהלות של האפליקציה, שנשמרה מ-iframe של ההגדרות המנוהלות. המערכת מתעלמת מהשדה הזה אם השדה managedConfiguration מוגדר.

accessibleTrackIds[]

string

רשימת מזהי המסלולים של האפליקציה, שמכשיר ששייך לארגון יכול לגשת אליהם. אם הרשימה מכילה כמה מזהי מסלולים, המכשירים מקבלים את הגרסה האחרונה מבין כל המסלולים הנגישים. אם הרשימה לא כוללת מזהי מסלולים, למכשירים יש גישה רק למסלול לסביבת הייצור של האפליקציה. פרטים נוספים לגבי כל טראק זמינים ב-AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

ההגדרה קובעת אם האפליקציה יכולה לתקשר עם עצמה בפרופיל העבודה ובפרופיל האישי במכשיר, בכפוף להסכמת המשתמש.

autoUpdateMode

enum (AutoUpdateMode)

המדיניות הזו קובעת את מצב העדכון האוטומטי של האפליקציה.

extensionConfig

object (ExtensionConfig)

הגדרה להפעלת האפליקציה הזו כאפליקציית תוסף, עם היכולת ליצור אינטראקציה עם Android Device Policy במצב אופליין.

ניתן להגדיר את השדה הזה לאפליקציה אחת לכל היותר.

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

המדיניות הזו מציינת אם האפליקציה מורשית להתחבר לרשת כשה-VPN לא מחובר וכשהתכונה alwaysOnVpnPackage.lockdownEnabled מופעלת. אם קובעים במדיניות את הערך VPN_LOCKDOWN_ENFORCED, לא ניתן להשתמש באפליקציה ברשת. אם קובעים במדיניות את הערך VPN_LOCKDOWN_EXEMPTION, ניתן להשתמש באפליקציה ברשת. התכונה נתמכת רק במכשירים עם Android מגרסה 10 ומעלה. אם המכשיר לא תומך באפשרות הזו, המכשיר יכיל NonComplianceDetail עם nonComplianceReason שמוגדר כ-API_LEVEL ו-FieldPath. אם ההגדרה הזו לא רלוונטית לאפליקציה, המכשיר יכיל NonComplianceDetail עם nonComplianceReason שמוגדר ל-UNSUPPORTED ו-FieldPath. השדה FieldPath מוגדר כ-applications[i].alwaysOnVpnLockdownExemption. הערך i הוא האינדקס של החבילה במדיניות applications.

workProfileWidgets

enum (WorkProfileWidgets)

ההגדרה קובעת אם לאפליקציה שמותקנת בפרופיל העבודה יש הרשאה להוסיף ווידג'טים למסך הבית.

credentialProviderPolicy

enum (CredentialProviderPolicy)

זה שינוי אופציונלי. האם האפליקציה מורשית לפעול כספק של פרטי כניסה ב-Android מגרסה 14 ואילך.

installConstraint[]

object (InstallConstraint)

זה שינוי אופציונלי. האילוצים של התקנת האפליקציה. ניתן לציין InstallConstraint אחד לכל היותר. יש כמה אילוצים שנדחו.

installPriority

integer

זה שינוי אופציונלי. בין האפליקציות שבהן installType מוגדר לערך:

זה קובע את העדיפות היחסית של ההתקנה. ערך של 0 (ברירת מחדל) פירושו שלאפליקציה הזו אין עדיפות על פני אפליקציות אחרות. עבור ערכים בין 1 ל-10,000, ערך נמוך יותר פירושו עדיפות גבוהה יותר. ערכים מחוץ לטווח 0 עד 10,000 כולל נדחים.

InstallType

סוג ההתקנה שצריך לבצע עבור אפליקציה. אם setupAction מפנה לאפליקציה, צריך להגדיר את installType כ-REQUIRED_FOR_SETUP, אחרת ההגדרה תיכשל.

טיפוסים בני מנייה (enums)
INSTALL_TYPE_UNSPECIFIED לא צוין. ברירת המחדל היא AVAILABLE.
PREINSTALLED האפליקציה מותקנת אוטומטית והמשתמשים יכולים להסיר אותה.
FORCE_INSTALLED האפליקציה מותקנת אוטומטית ללא קשר לחלון תחזוקה שהוגדר, והמשתמשים לא יכולים להסיר אותה.
BLOCKED האפליקציה חסומה ואי אפשר להתקין אותה. אם האפליקציה הותקנה במסגרת מדיניות קודמת, היא תוסר. הפעולה הזו גם תחסום את הפונקציונליות של אפליקציות ללא התקנה.
AVAILABLE האפליקציה זמינה להתקנה.
REQUIRED_FOR_SETUP האפליקציה מותקנת אוטומטית והמשתמשים לא יכולים להסיר אותה, והיא תמנע את השלמת ההתקנה עד לסיום ההתקנה.
KIOSK האפליקציה מותקנת אוטומטית במצב קיוסק: היא מוגדרת כ-Intent המועדף בבית, והיא נוספה לרשימת ההיתרים של מצב משימת נעילה. לא ניתן יהיה להשלים את הגדרת המכשיר עד שהאפליקציה תותקן. לאחר ההתקנה, המשתמשים לא יוכלו להסיר את האפליקציה. ניתן להגדיר את installType הזה רק לאפליקציה אחת בכל מדיניות. אם האפשרות הזו מופיעה במדיניות, שורת הסטטוס תושבת באופן אוטומטי.

PermissionPolicy

המדיניות בנוגע למתן בקשות הרשאה לאפליקציות.

טיפוסים בני מנייה (enums)
PERMISSION_POLICY_UNSPECIFIED לא צוינה מדיניות. אם לא צוינה מדיניות להרשאה בשום רמה, המערכת תשתמש בהתנהגות PROMPT כברירת מחדל.
PROMPT הצגת בקשה למשתמש להעניק הרשאה.
GRANT

הענקת הרשאה אוטומטית.

ב-Android מגרסה 12 ואילך, אפשר להעניק את Manifest.permission.READ_SMS והרשאות שקשורות לחיישנים רק במכשירים שמנוהלים באופן מלא:

DENY דחייה אוטומטית של הרשאה.

PermissionGrant

הגדרה של הרשאה ל-Android ומצב ההרשאה שלה.

ייצוג JSON
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
שדות
permission

string

ההרשאה או הקבוצה ב-Android, למשל android.permission.READ_CALENDAR או android.permission_group.CALENDAR.

policy

enum (PermissionPolicy)

המדיניות בנושא הענקת ההרשאה.

DelegatedScope

היקפי הרשאות שחבילה אחרת יכולה לרכוש מ-Android Device Policy. הרשאות אלה מספקות הרשאות נוספות עבור האפליקציות שעליהן הם חלים.

ניתן להחיל היקפי הרשאות על מספר אפליקציות, מלבד SECURITY_LOGS ו-NETWORK_ACTIVITY_LOGS, אבל ניתן להקצות אותן רק לאפליקציה אחת בכל פעם.

טיפוסים בני מנייה (enums)
DELEGATED_SCOPE_UNSPECIFIED לא צוין היקף להענקת גישה.
CERT_INSTALL הענקת גישה להתקנה ולניהול של אישורים.
MANAGED_CONFIGURATIONS הענקת גישה לניהול הגדרות מנוהלות.
BLOCK_UNINSTALL תוענק גישה לחסימת הסרה.
PERMISSION_GRANT הענקת גישה למדיניות ההרשאות ומצב הענקת ההרשאות.
PACKAGE_ACCESS הענקת גישה למצב הגישה לחבילה.
ENABLE_SYSTEM_APP הענקת גישה להפעלת אפליקציות מערכת.
NETWORK_ACTIVITY_LOGS הענקת גישה ליומני הפעילות ברשת. מאפשר לאפליקציה שהוענקה הרשאה להפעיל שיטות setNetworkLoggingEnabled, isNetworkLoggingEnabled ו-retrieveNetworkLogs. אפשר להקצות את ההיקף הזה לאפליקציה אחת לכל היותר. נתמכת במכשירים שמנוהלים באופן מלא ב-Android 10 ואילך. התכונה נתמכת בפרופיל עבודה ב-Android מגרסה 12 ואילך. אם יש תמיכה ומוגדרת בהענקת גישה, המערכת מתעלמת מ-NETWORK_ACTIVITY_LOGS.
SECURITY_LOGS הענקת גישה ליומני אבטחה. מאפשר לאפליקציה שהוענקה הרשאה לקרוא לשיטות setSecurityLoggingEnabled, isSecurityLoggingEnabled, retrieveSecurityLogs ו-retrievePreRebootSecurityLogs. אפשר להקצות את ההיקף הזה לאפליקציה אחת לכל היותר. נתמכת במכשירים שמנוהלים באופן מלא ובמכשירים בבעלות חברה, עם פרופיל עבודה ב-Android מגרסה 12 ואילך. אם יש תמיכה ומוגדרת בהענקת גישה, המערכת מתעלמת מ-SECURITY_LOGS.
CERT_SELECTION מעניקה גישה לבחירה של אישורי KeyChain מטעם בקשות גישה לאפליקציות. לאחר האישור, האפליקציה שהוענקה לך גישה תתחיל לקבל DelegatedAdminReceiver#onChoosePrivateKeyAlias. מאפשר לאפליקציה שהוענקה הרשאה להפעיל שיטות grantKeyPairToApp ו-revokeKeyPairFromApp. יכולה להיות לכל היותר אפליקציה אחת להענקת הגישה הזו. השדה choosePrivateKeyRules חייב להיות ריק ול-privateKeySelectionEnabled אין השפעה אם בחירת האישורים מוקצית לאפליקציה.

ManagedConfigurationTemplate

תבנית ההגדרות האישיות המנוהלות של האפליקציה, שנשמרה מ-iframe של ההגדרות המנוהלות.

ייצוג JSON
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
שדות
templateId

string

המזהה של תבנית ההגדרות האישיות המנוהלות.

configurationVariables

map (key: string, value: string)

אופציונלי: מפה שמכילה את משתני התצורה <key, value> שהוגדרו לתצורה.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ConnectedWorkAndPersonalApp

המדיניות קובעת אם האפליקציה יכולה לתקשר עם עצמה במספר פרופילים, בכפוף להסכמת המשתמשים.

טיפוסים בני מנייה (enums)
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED לא צוין. ברירת המחדל היא CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED.
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED ברירת מחדל. האפליקציה לא יכולה לתקשר בין פרופילים שונים.
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED ההרשאה הזו מאפשרת לאפליקציה לתקשר בין פרופילים לאחר קבלת הסכמה מהמשתמשים.

AutoUpdateMode

המדיניות קובעת את מצב העדכון האוטומטי של האפליקציה. אם משתמש במכשיר מבצע שינויים בהגדרות המכשיר באופן ידני, AutoUpdateMode תתעלם מהבחירות האלה כי הן מקבלות עדיפות.

טיפוסים בני מנייה (enums)
AUTO_UPDATE_MODE_UNSPECIFIED לא צוין. ברירת המחדל היא AUTO_UPDATE_DEFAULT.
AUTO_UPDATE_DEFAULT

מצב העדכון שמוגדר כברירת מחדל.

האפליקציה מתעדכנת באופן אוטומטי עם עדיפות נמוכה כדי לצמצם את ההשפעה על המשתמש.

האפליקציה מתעדכנת אם כל התנאים הבאים מתקיימים:

  • לא נעשה שימוש פעיל במכשיר.
  • המכשיר מחובר לרשת שאינה נמדדת.
  • המכשיר בטעינה.
  • האפליקציה שרוצים לעדכן לא פועלת בחזית.

המכשיר מקבל הודעה על עדכון חדש תוך 24 שעות מהפרסום שלו על ידי המפתח. לאחר הפרסום, האפליקציה תתעדכן בפעם הבאה שתעמוד בתנאים שמפורטים למעלה.

AUTO_UPDATE_POSTPONED

האפליקציה לא מתעדכנת באופן אוטומטי במשך 90 יום לכל היותר אחרי שהיא מפסיקה להתעדכן.

90 יום אחרי שיפוג התוקף של האפליקציה, הגרסה האחרונה שזמינה תותקן באופן אוטומטי עם עדיפות נמוכה (מידע נוסף מופיע ב-AUTO_UPDATE_DEFAULT). לאחר עדכון האפליקציה, היא לא מתעדכנת שוב באופן אוטומטי עד 90 יום אחרי שהיא מפסיקה להיות מעודכנת.

המשתמש עדיין יכול לעדכן את האפליקציה באופן ידני מחנות Play בכל שלב.

AUTO_UPDATE_HIGH_PRIORITY

האפליקציה תתעדכן בהקדם האפשרי. לא הוחלו מגבלות.

המכשיר יקבל הודעה בהקדם האפשרי על עדכון חדש ברגע שהוא יהיה זמין.

ExtensionConfig

הגדרה להפעלת אפליקציה כאפליקציית תוסף, עם היכולת ליצור אינטראקציה עם Android Device Policy במצב אופליין. בגרסה 13 של Android ואילך, אפליקציות של תוספים פטורות מהגבלות סוללה, ולכן לא ייכללו בקטגוריה המוגבלת של אפליקציה במצב המתנה. אפליקציות של תוספים מוגנות גם מפני משתמשים שמבצעים ניקוי של הנתונים שלהם או סגירה מאולצת של האפליקציה, אם כי אדמינים יכולים להמשיך להשתמש ב-clear app data command באפליקציות של תוספים במידת הצורך, ב-Android מגרסה 13 ואילך.

ייצוג JSON
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
שדות
signingKeyFingerprintsSha256[]

string

גיבוב SHA-256 עם קידוד הקסדצימלי של אישור החתימה של אפליקציית התוסף. חוקיים רק ייצוגים של מחרוזות הקסדצימליות של 64 תווים.

אם לא מציינים זאת, החתימה של שם החבילה התואם מתקבלת מחנות Play במקום זאת.

אם הרשימה הזו ריקה, החתימה של אפליקציית התוסף במכשיר חייבת להתאים לחתימה שהתקבלה מחנות Play כדי שהאפליקציה תוכל לתקשר עם Android Device Policy.

אם הרשימה לא ריקה, החתימה של אפליקציית התוסף במכשיר חייבת להתאים לאחת מהרשומות ברשימה הזו כדי שהאפליקציה תוכל לתקשר עם Android Device Policy.

בתרחישים לדוגמה בסביבת הייצור, מומלץ להשאיר את השדה הזה ריק.

notificationReceiver

string

שם מחלקה מוגדר במלואו של מחלקת השירות של המקבל עבור Android Device Policy כדי ליידע את אפליקציית התוסף על כל עדכון סטטוס של פקודה מקומית.

AlwaysOnVpnLockdownExemption

המדיניות קובעת אם האפליקציה פטורה מההגדרה alwaysOnVpnPackage.lockdownEnabled.

טיפוסים בני מנייה (enums)
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED לא צוין. ברירת המחדל היא VPN_LOCKDOWN_ENFORCED.
VPN_LOCKDOWN_ENFORCED האפליקציה פועלת בהתאם להגדרת הנעילה של ה-VPN שפועלת כל הזמן.
VPN_LOCKDOWN_EXEMPTION האפליקציה פטורה מהגדרה של 'ללא 'ביטול נעילה עם VPN''.

WorkProfileWidgets

ההגדרה קובעת אם אפליקציה של פרופיל עבודה יכולה להוסיף ווידג'טים למסך הבית.

טיפוסים בני מנייה (enums)
WORK_PROFILE_WIDGETS_UNSPECIFIED לא צוין. ברירת המחדל היא workProfileWidgetsDefault
WORK_PROFILE_WIDGETS_ALLOWED מותר להשתמש בווידג'טים של פרופיל העבודה. המשמעות היא שהאפליקציה תוכל להוסיף ווידג'טים למסך הבית.
WORK_PROFILE_WIDGETS_DISALLOWED אין להשתמש בווידג'טים של פרופיל העבודה. המשמעות היא שהאפליקציה לא תוכל להוסיף ווידג'טים למסך הבית.

CredentialProviderPolicy

האם האפליקציה מורשית לפעול כספק של פרטי כניסה ב-Android מגרסה 14 ואילך.

טיפוסים בני מנייה (enums)
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED לא צוין. ההתנהגות כפופה ל-credentialProviderPolicyDefault.
CREDENTIAL_PROVIDER_ALLOWED האפליקציה מורשית לפעול כספק של פרטי הכניסה.

InstallConstraint

בין האפליקציות שבהן InstallType מוגדר לערך:

ההגדרה הזו מגדירה קבוצה של הגבלות על התקנת האפליקציה. יש להגדיר לפחות אחד מהשדות. כשמגדירים כמה שדות, צריך למלא את כל האילוצים כדי שהאפליקציה תותקן.

ייצוג JSON
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
שדות
networkTypeConstraint

enum (NetworkTypeConstraint)

זה שינוי אופציונלי. מגבלה על סוג הרשת.

chargingConstraint

enum (ChargingConstraint)

זה שינוי אופציונלי. מגבלת טעינה.

deviceIdleConstraint

enum (DeviceIdleConstraint)

זה שינוי אופציונלי. מגבלת אי-פעילות של המכשיר.

NetworkTypeConstraint

מגבלה על סוג הרשת.

טיפוסים בני מנייה (enums)
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED לא צוין. ברירת המחדל היא INSTALL_ON_ANY_NETWORK.
INSTALL_ON_ANY_NETWORK כל הרשתות הפעילות (Wi-Fi, רשתות סלולריות וכו').
INSTALL_ONLY_ON_UNMETERED_NETWORK כל רשת שאינה נמדדת (כמו Wi-Fi).

ChargingConstraint

מגבלת טעינה.

טיפוסים בני מנייה (enums)
CHARGING_CONSTRAINT_UNSPECIFIED לא צוין. ברירת המחדל היא CHARGING_NOT_REQUIRED.
CHARGING_NOT_REQUIRED המכשיר לא חייב להיטען.
INSTALL_ONLY_WHEN_CHARGING המכשיר צריך להיטען.

DeviceIdleConstraint

מגבלה על מצב לא פעיל של המכשיר.

טיפוסים בני מנייה (enums)
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED לא צוין. ברירת המחדל היא DEVICE_IDLE_NOT_REQUIRED.
DEVICE_IDLE_NOT_REQUIRED המכשיר לא חייב להיות במצב של חוסר פעילות. אפשר להתקין את האפליקציה בזמן שהמשתמש מקיים אינטראקציה עם המכשיר.
INSTALL_ONLY_WHEN_DEVICE_IDLE המכשיר צריך להיות ללא פעילות.

KeyguardDisabledFeature

תכונות מגן המקשים (מסך נעילה) שניתן להשבית.

טיפוסים בני מנייה (enums)
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED המערכת מתעלמת מהערך הזה.
CAMERA השבתת המצלמה במסכי מפתח מאובטחים (למשל, קוד אימות).
NOTIFICATIONS השבתת ההצגה של כל ההתראות במסכי מפתח מאובטחים.
UNREDACTED_NOTIFICATIONS השבתת התראות לא מצונזרות במסכי מפתח מאובטחים.
TRUST_AGENTS התעלמות ממצב סביבה אמינה במסכי מפתח מאובטחים.
DISABLE_FINGERPRINT השבת את חיישן טביעות האצבע במסכי נעילת מקשים מאובטחים.
DISABLE_REMOTE_INPUT במכשירים עם Android 6 או גרסאות קודמות, מושבתת הזנת טקסט להתראות במסכי מפתח מאובטחים. אין השפעה על Android מגרסה 7 ואילך.
FACE השבתה של אימות פנים במסכי מפתח מאובטחים.
IRIS השבתת אימות קשתית העין במסכי מפתח מאובטחים.
BIOMETRICS השבתת כל האימות הביומטרי במסכי מפתח מאובטחים.
SHORTCUTS השבתה של כל קיצורי הדרך במסך מגן המקשים המאובטח במכשירי Android מגרסה 14 ואילך.
ALL_FEATURES השבתת כל ההתאמות האישיות הקיימות והעתידיות של KeyGuard.

PersistentPreferredActivity

פעילות ברירת מחדל לטיפול באובייקטים מסוג Intent שתואמים למסנן Intent מסוים. הערה: כדי להגדיר קיוסק, צריך להשתמש ב-InstallType כדי KIOSK במקום להשתמש בפעילויות קבועות מועדפות.

ייצוג JSON
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
שדות
receiverActivity

string

הפעילות שאמורה להיות ה-handler של ה-Intent שמוגדר כברירת מחדל. השם צריך להיות שם של רכיב Android, לדוגמה: com.android.enterprise.app/.MainActivity. לחלופין, הערך עשוי להיות שם החבילה של אפליקציה, פעולה שגורמת ל-Android Device Policy לבחור פעילות מתאימה מהאפליקציה לטיפול ב-Intent.

actions[]

string

פעולות Intent שיש להתאים במסנן. אם מסנן כלשהו כולל פעולות, פעולת ה-Intent חייבת להיות אחד מהערכים האלה כדי שתהיה התאמה. אם לא נכללות פעולות, המערכת מתעלמת מפעולת ה-Intent.

categories[]

string

הקטגוריות של Intent שיש להתאים במסנן. אובייקט Intent כולל את הקטגוריות הנדרשות, וכולן צריכות להיכלל במסנן כדי שתהיה התאמה. במילים אחרות, הוספת קטגוריה למסנן לא משפיעה על ההתאמה, אלא אם הקטגוריה מצוינת ב-Intent.

SystemUpdate

הגדרה לניהול עדכוני המערכת

ייצוג JSON
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
שדות
type

enum (SystemUpdateType)

הסוג של עדכון המערכת שיש להגדיר.

startMinutes

integer

אם הסוג הוא WINDOWED, תחילת חלון התחזוקה, נמדדת כמספר הדקות אחרי חצות לפי הזמן המקומי של המכשיר. הערך צריך להיות בין 0 ל-1439, כולל.

endMinutes

integer

אם הסוג הוא WINDOWED, הסיום של חלון התחזוקה, נמדד כמספר הדקות אחרי חצות לפי הזמן המקומי של המכשיר. הערך צריך להיות בין 0 ל-1439, כולל. אם הערך הזה קטן מ-startMinutes, חלון התחזוקה ייפרס על פני חצות. אם חלון התחזוקה שצוין קטן מ-30 דקות, החלון בפועל תוארך ל-30 דקות מעבר לשעת ההתחלה.

freezePeriods[]

object (FreezePeriod)

תקופה שנתית שחוזרת על עצמה שבה עדכוני מערכת אלחוטיים (OTA) נדחים כדי להקפיא את גרסת מערכת ההפעלה שפועלת במכשיר. כדי למנוע הקפאת המכשיר לזמן בלתי מוגבל, צריך להפריד בין תקופת ההקפאה ל-60 ימים לפחות.

SystemUpdateType

סוג ההגדרה של עדכון המערכת.

טיפוסים בני מנייה (enums)
SYSTEM_UPDATE_TYPE_UNSPECIFIED פועלים לפי התנהגות ברירת המחדל לעדכון המכשיר, שבדרך כלל מחייבת את המשתמש לאשר את עדכוני המערכת.
AUTOMATIC התקנה אוטומטית ברגע שיש עדכון זמין.
WINDOWED

התקנה אוטומטית במסגרת חלון תחזוקה יומי. הפעולה הזו גם מגדירה שהאפליקציות מ-Play יעודכנו בתוך החלון. מומלץ מאוד להפעיל את האפשרות הזו במכשירי קיוסק, כי זו הדרך היחידה ב-Play לעדכן אפליקציות שמוצמדות לחזית באופן קבוע.

אם המדיניות autoUpdateMode מוגדרת לערך AUTO_UPDATE_HIGH_PRIORITY עבור אפליקציה מסוימת, המערכת תתעלם מחלון התחזוקה של אותה אפליקציה והוא מתעדכן בהקדם האפשרי, גם מחוץ לחלון התחזוקה.

POSTPONE אפשר לדחות את ההתקנה האוטומטית לתקופה של עד 30 יום. המדיניות הזו לא משפיעה על עדכוני אבטחה (למשל, תיקוני אבטחה חודשיים).

FreezePeriod

תקופת הקפאה של המערכת. כששעון המכשיר נמצא בתקופת ההקפאה, כל עדכוני המערכת הנכנסים (כולל תיקוני אבטחה) חסומים ולא יותקנו.

כשהמכשיר נמצא מחוץ לתקופות ההקפאה המוגדרות, חלה ההתנהגות הרגילה של המדיניות (אוטומטית, בחלון עם חלון או דחייה).

בחישובי תקופת ההקפאה המערכת מתעלמת משנים מעוברות, במיוחד:

  • אם 29 בפברואר מוגדר כתאריך ההתחלה או הסיום של תקופת ההקפאה, תקופת ההקפאה תתחיל או תסתיים ב-28 בפברואר במקום זאת.
  • כששעון המערכת של מכשיר מראה 29 בפברואר, ההתייחסות היא ל-28 בפברואר.
  • בחישוב מספר הימים בתקופת הקפאה או הזמן בין שתי תקופות הקפאה, לא נלקח בחשבון 29 בפברואר ולא נספר כיום.

הערה: כדי שתקופות הקפאה ייכנסו לתוקף, אי אפשר לציין SystemUpdateType כ-SYSTEM_UPDATE_TYPE_UNSPECIFIED, כי תקופות הקפאה מחייבות ציון מדיניות מוגדרת.

ייצוג JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
שדות
startDate

object (Date)

תאריך ההתחלה (כולל) של תקופת ההקפאה. הערה: לא ניתן להגדיר year. לדוגמה: {"month": 1,"date": 30}.

endDate

object (Date)

תאריך הסיום (כולל) של תקופת ההקפאה. התאריך חייב להיות עד 90 יום מתאריך ההתחלה. אם תאריך הסיום מוקדם מתאריך ההתחלה, תקופת ההקפאה נחשבת כתקופת ההקפאה של סוף השנה. הערה: לא ניתן להגדיר year. לדוגמה: {"month": 1,"date": 30}.

תאריך

מייצג תאריך קלנדרי שלם או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שאינם משמעותיים. התאריך הזה יחסי ללוח השנה הגרגוריאני. הערך הזה יכול לייצג את אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שאינם אפס שנה, חודש ויום.
  • חודש ויום, עם שנת אפס (למשל יום נישואין).
  • שנה בפני עצמה, עם חודש של אפס ויום אפס.
  • שנה וחודש, עם אפס יום (לדוגמה, תאריך תפוגת התוקף של כרטיס האשראי).

סוגים קשורים:

ייצוג JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

שנת התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.

month

integer

חודש בשנה. חייב להיות בין 1 ל-12, או 0 כדי לציין שנה ללא חודש ויום.

day

integer

היום בחודש. הערך חייב להיות בין 1 ל-31, והוא תקף לשנה ולחודש, או 0 כדי לציין שנה בלבד, או שנה וחודש שבהם היום לא משמעותי.

StatusReportingSettings

הגדרות שקובעות את ההתנהגות של דוחות הסטטוס.

ייצוג JSON
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean
}
שדות
applicationReportsEnabled

boolean

האם דוחות של אפליקציות מופעלים.

deviceSettingsEnabled

boolean

האם הדיווח על הגדרות המכשיר מופעל.

softwareInfoEnabled

boolean

האם מופעל דיווח על פרטי תוכנה.

memoryInfoEnabled

boolean

האם הדיווח על אירועי זיכרון מופעל.

networkInfoEnabled

boolean

האם הדיווח על פרטי הרשת מופעל.

displayInfoEnabled

boolean

האם הדיווח תצוגות מופעל. נתוני הדוחות לא זמינים במכשירים בבעלות אישית שיש להם פרופיל עבודה.

powerManagementEventsEnabled

boolean

האם דיווח על אירועים של ניהול צריכת חשמל מופעל. נתוני הדוחות לא זמינים במכשירים בבעלות אישית שיש להם פרופיל עבודה.

hardwareStatusEnabled

boolean

האם הדיווח על סטטוס החומרה מופעל. נתוני הדוחות לא זמינים במכשירים בבעלות אישית שיש להם פרופיל עבודה.

systemPropertiesEnabled

boolean

האם הדיווח של מאפייני המערכת מופעל.

applicationReportingSettings

object (ApplicationReportingSettings)

הגדרות דיווח של אפליקציות. רלוונטי רק אם הערך של applicationReportsEnabled הוא TRUE.

commonCriteriaModeEnabled

boolean

האם הפעלת דיווח על Common Criteria Mode.

ApplicationReportingSettings

הגדרות שקובעות את ההתנהגות של דוחות האפליקציות.

ייצוג JSON
{
  "includeRemovedApps": boolean
}
שדות
includeRemovedApps

boolean

אם אפליקציות שהוסרו נכללות בדוחות של האפליקציות.

PackageNameList

רשימה של שמות של חבילות.

ייצוג JSON
{
  "packageNames": [
    string
  ]
}
שדות
packageNames[]

string

רשימה של שמות של חבילות.

BatteryPluggedMode

מצבים לחיבור הסוללה.

טיפוסים בני מנייה (enums)
BATTERY_PLUGGED_MODE_UNSPECIFIED המערכת מתעלמת מהערך הזה.
AC מקור הכוח הוא מטען AC.
USB מקור הכוח הוא יציאת USB.
WIRELESS מקור הכוח הוא אלחוטי.

ProxyInfo

פרטי התצורה של שרת proxy מסוג HTTP. כדי להתחבר לשרת Proxy ישיר, צריך להגדיר את השדות host, port ו-excludedHosts. עבור שרת proxy לסקריפט PAC, מגדירים את השדה pacUri.

ייצוג JSON
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
שדות
host

string

המארח של שרת ה-proxy הישיר.

port

integer

היציאה של שרת ה-proxy הישיר.

excludedHosts[]

string

בשרת proxy ישיר, המארחים עוקפים את שרת ה-proxy. שמות המארחים עשויים להכיל תווים כלליים, כמו *.example.com.

pacUri

string

ה-URI של סקריפט ה-PAC המשמש להגדרת שרת ה-proxy.

ChoosePrivateKeyRule

המדיניות הזו שולטת בגישה של האפליקציות למפתחות פרטיים. הכלל קובע איזה מפתח פרטי יוענק לאפליקציה שצוינה, אם בכלל, תינתן גישה לאפליקציית KeyChain.choosePrivateKeyAlias (או לעומסי יתר) כדי לבקש כינוי של מפתח פרטי לכתובת URL נתונה או לכללים שאינם ספציפיים לכתובת URL (כלומר, אם urlPattern לא הוגדר או הוגדר למחרוזת הריקה או ל-.*) ב-Android 11 ואילך, ישירות כדי שהאפליקציה תוכל לבצע קריאה ראשונה ל-KeyChain.getPrivateKey, בלי להפעיל את הפקודה KeyChain.getPrivateKey.KeyChain.choosePrivateKeyAlias

כשאפליקציה מפעילה את KeyChain.choosePrivateKeyAlias אם יש התאמה ליותר מ-choosePrivateKeyRules אחד, כלל ההתאמה האחרון מגדיר איזה כינוי מפתח להחזיר.

ייצוג JSON
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
שדות
urlPattern

string

תבנית ה-URL שצריך להתאים לכתובת ה-URL של הבקשה. אם המדיניות לא מוגדרת או ריקה, היא תתאים לכל כתובות ה-URL. האפשרות הזו משתמשת בתחביר של הביטוי הרגולרי java.util.regex.Pattern.

packageNames[]

string

שמות החבילות שעליהם חל הכלל הזה. הגיבוב (hash) של אישור החתימה של כל אפליקציה מאומת מול הגיבוב שסופק על ידי Play. אם לא צוינו שמות חבילה, כתובת האימייל החלופית תסופק לכל האפליקציות שמתקשרות אל KeyChain.choosePrivateKeyAlias או לעומסי יתר (אבל לא בלי התקשרות ל-KeyChain.choosePrivateKeyAlias, גם ב-Android 11 ואילך). לכל אפליקציה עם אותו מזהה UID של Android שיש בחבילה שצוינה כאן תהיה גישה כשהם יתקשרו אל KeyChain.choosePrivateKeyAlias.

privateKeyAlias

string

הכינוי של המפתח הפרטי שבו יש להשתמש.

AlwaysOnVpnPackage

הגדרה לחיבור VPN שפועל כל הזמן.

ייצוג JSON
{
  "packageName": string,
  "lockdownEnabled": boolean
}
שדות
packageName

string

שם החבילה של אפליקציית ה-VPN.

lockdownEnabled

boolean

השבתת רשתות כשה-VPN לא מחובר.

LocationMode

המידה של זיהוי המיקום המופעלת בפרופיל עבודה ובמכשירים המנוהלים באופן מלא.

טיפוסים בני מנייה (enums)
LOCATION_MODE_UNSPECIFIED ברירת המחדל היא LOCATION_USER_CHOICE.
HIGH_ACCURACY

ב-Android מגרסה 8 ומטה, כל השיטות לזיהוי מיקום מופעלות, כולל GPS, רשתות וחיישנים אחרים. ב-Android מגרסה 9 ואילך, זה מקביל ל-LOCATION_ENFORCED.

SENSORS_ONLY

ב-Android מגרסה 8 ומטה, רק GPS וחיישנים אחרים מופעלים. ב-Android מגרסה 9 ואילך, זה מקביל ל-LOCATION_ENFORCED.

BATTERY_SAVING

ב-Android מגרסה 8 ומטה, רק ספק המיקום של הרשת מופעל. ב-Android מגרסה 9 ואילך, זה מקביל ל-LOCATION_ENFORCED.

OFF

ב-Android מגרסה 8 ומטה, הגדרות המיקום והדיוק מושבתות. ב-Android מגרסה 9 ואילך, זה מקביל ל-LOCATION_DISABLED.

LOCATION_USER_CHOICE הגדרת המיקום לא מוגבלת במכשיר הזה. לא מוגדרת או נאכפה התנהגות ספציפית.
LOCATION_ENFORCED הפעלה של הגדרת המיקום במכשיר.
LOCATION_DISABLED השבתה של הגדרת המיקום במכשיר.

ComplianceRule

כלל שמצהיר אילו פעולות מקלות יש לבצע כשמכשיר לא תואם למדיניות שלו. עבור כל כלל, תמיד תהיה פעולה מרומזת מצמצמת את האפשרות להגדיר את policyCompliant כ-FALSE עבור המשאב Device, והצגת הודעה במכשיר שמציינת שהמכשיר לא תואם למדיניות שלו. אפשר גם לבצע פעולות מקלות אחרות, בהתאם לערכי השדות בכלל.

ייצוג JSON
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

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

boolean

אם המדיניות מוגדרת כ-True, הכלל כולל פעולת מצמצמת להשבתת אפליקציות כדי שהמכשיר יושבת בפועל, אבל נתוני האפליקציות יישמרו. אם במכשיר פועלת אפליקציה במצב משימה נעול, האפליקציה תיסגר ויוצג ממשק משתמש שמפרט את הסיבה לאי-תאימות.

packageNamesToDisable[]

string

אם הכלל מוגדר, הוא כולל פעולת מצמצמת להשבתת אפליקציות שצוינו ברשימה, אבל נתוני האפליקציות נשמרים.

שדה איחוד condition. התנאי, שכאשר הוא מתקיים, מפעיל את הפעולות המקלות שמוגדרות בכלל. יש לקבוע בדיוק אחד מהתנאים. condition יכול להיות רק אחד מהבאים:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

תנאי שמתקיים אם קיים NonComplianceDetail אחד או יותר שתואמים למכשיר.

apiLevelCondition

object (ApiLevelCondition)

תנאי שמתקיים אם רמת ה-API של Android Framework במכשיר לא עומדת בדרישה המינימלית.

NonComplianceDetailCondition

תנאי של כלל תאימות שמתקיים אם קיים NonComplianceDetail אחד תואם למכשיר. NonComplianceDetail תואם לערך NonComplianceDetailCondition אם כל השדות שמוגדרים בתוך NonComplianceDetailCondition תואמים לשדות NonComplianceDetail המתאימים.

ייצוג JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
שדות
settingName

string

השם של הגדרת המדיניות. זהו השם של שדה ה-JSON של שדה Policy ברמה העליונה. אם לא מגדירים את התנאי, התנאי הזה תואם לכל שם של הגדרה.

nonComplianceReason

enum (NonComplianceReason)

הסיבה שבגללה המכשיר לא תואם להגדרה. אם לא מגדירים את התנאי, הוא תואם לכל סיבה שהיא.

packageName

string

שם החבילה של האפליקציה שלא עומד בדרישות. אם לא מגדירים את התנאי, התנאי הזה תואם לכל שם חבילה.

ApiLevelCondition

תנאי של כלל תאימות שמתקיים אם רמת ה-Android Framework API במכשיר לא עומדת בדרישה המינימלית. לכל מדיניות יכול להיות רק כלל אחד עם סוג התנאי הזה.

ייצוג JSON
{
  "minApiLevel": integer
}
שדות
minApiLevel

integer

רמת ה-API המינימלית הרצויה של Android Framework. אם המכשיר לא עומד בדרישה המינימלית, התנאי הזה מתקיים. חייב להיות גדול מאפס.

AppAutoUpdatePolicy

חלופה מומלצת: המאפיין autoUpdateMode, שמוגדר לכל אפליקציה, מספק גמישות רבה יותר לגבי תדירות העדכון.

כשהערך בשדה autoUpdateMode הוא AUTO_UPDATE_POSTPONED או AUTO_UPDATE_HIGH_PRIORITY, לשדה הזה אין השפעה.

מדיניות העדכון האוטומטי של אפליקציות, שקובעת מתי ניתן להחיל עדכונים אוטומטיים של אפליקציות.

טיפוסים בני מנייה (enums)
APP_AUTO_UPDATE_POLICY_UNSPECIFIED מדיניות העדכון האוטומטי לא מוגדרת. שווה ערך ל-CHOICE_TO_THE_USER.
CHOICE_TO_THE_USER המשתמש יכול לשלוט בעדכונים אוטומטיים.
NEVER אפליקציות אף פעם לא מתעדכנות באופן אוטומטי.
WIFI_ONLY האפליקציות מתעדכנות באופן אוטומטי רק באמצעות Wi-Fi.
ALWAYS האפליקציות מתעדכנות באופן אוטומטי בכל שלב. יכולים להיות חיובים על שימוש בחבילת הגלישה.

AppTrack

מסלול הפצה של אפליקציה ב-Google Play.

טיפוסים בני מנייה (enums)
APP_TRACK_UNSPECIFIED המערכת מתעלמת מהערך הזה.
PRODUCTION המסלול לסביבת הייצור שמספק את הגרסה היציבה האחרונה.
BETA מסלול הבטא, שכולל את גרסת הבטא האחרונה.

EncryptionPolicy

סוג ההצפנה

טיפוסים בני מנייה (enums)
ENCRYPTION_POLICY_UNSPECIFIED המערכת מתעלמת מהערך הזה, כלומר לא נדרשת הצפנה
ENABLED_WITHOUT_PASSWORD נדרשת הצפנה אך אין צורך בסיסמה כדי להפעיל
ENABLED_WITH_PASSWORD נדרשת הצפנה עם סיסמה כדי להפעיל

PlayStoreMode

ערכים אפשריים למדיניות המצב של חנות Play.

טיפוסים בני מנייה (enums)
PLAY_STORE_MODE_UNSPECIFIED לא צוין. ברירת המחדל היא WHITELIST.
WHITELIST רק האפליקציות שמצוינות במדיניות הזו זמינות, ואפליקציות שלא נכללות במדיניות יוסרו אוטומטית מהמכשיר.
BLACKLIST כל האפליקציות זמינות, וכל אפליקציה שלא צריכה להיות במכשיר צריכה להיות מסומנת באופן מפורש כ-'BLOCKED' במדיניות applications.

SetupAction

פעולה שבוצעה במהלך ההגדרה.

ייצוג JSON
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

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

object (UserFacingMessage)

הכותרת של הפעולה הזו.

description

object (UserFacingMessage)

תיאור הפעולה הזו.

שדה איחוד action. הפעולה שצריך לבצע במהלך ההגדרה. action יכול להיות רק אחד מהבאים:
launchApp

object (LaunchAppAction)

פעולה להפעלת אפליקציה. האפליקציה תופעל עם Intent שמכיל עוד מפתח, כאשר המפתח com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION מוגדר לערך הבוליאני true כדי לציין שמדובר בתהליך של פעולת הגדרה. אם SetupAction מפנה לאפליקציה, צריך להגדיר את installType התואם במדיניות האפליקציה כ-REQUIRED_FOR_SETUP. אחרת, ההגדרה תיכשל.

LaunchAppAction

פעולה להפעלת אפליקציה.

ייצוג JSON
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
שדות
שדה איחוד launch. התיאור של פעולת ההפעלה שתבוצע launch יכול להיות רק אחד מהבאים:
packageName

string

שם החבילה של האפליקציה שתופעל

PolicyEnforcementRule

כלל שמגדיר את הפעולות שיש לבצע אם מכשיר או פרופיל עבודה לא עומדים בדרישות המדיניות שצוינה ב-settingName. במקרה של התאמה מרובה או של כמה כללי אכיפה שמופעלים, מיזוג יתבצע עם הפעולה החמורה ביותר. עם זאת, עדיין מתבצע מעקב אחר כל הכללים המופעלים, כולל שעת ההפעלה הראשונית וכל הפרטים המשויכים לאי-תאימות. במצב שבו מתקיים כלל האכיפה החמור ביותר, תחול הפעולה המתאימה ביותר.

ייצוג JSON
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

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

object (BlockAction)

פעולה לחסימת הגישה לאפליקציות ולנתונים במכשיר שבבעלות חברה או בפרופיל עבודה. הפעולה הזו גם מפעילה הודעה למשתמשים עם מידע (אם אפשר) על תיקון של בעיית התאימות. הערה: יש לציין גם את wipeAction.

wipeAction

object (WipeAction)

איפוס של מכשיר בבעלות החברה או מחיקת פרופיל עבודה. הערה: יש לציין גם את blockAction.

שדה איחוד trigger. התנאי שיפעיל את הכלל הזה. trigger יכול להיות רק אחד מהבאים:
settingName

string

המדיניות ברמה העליונה שיש לאכוף. לדוגמה, applications או passwordPolicies.

BlockAction

פעולה לחסימת הגישה לאפליקציות ולנתונים במכשיר מנוהל או בפרופיל עבודה. הפעולה הזו גם מפעילה את המכשיר או פרופיל העבודה להציג למשתמש הודעה עם מידע (אם אפשר) על תיקון בעיית התאימות. הערה: יש לציין גם את wipeAction.

ייצוג JSON
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
שדות
blockAfterDays

integer

מספר הימים שהמדיניות לא עומדת בדרישות המדיניות לפני שהמכשיר או פרופיל העבודה ייחסמו. כדי לחסום את הגישה באופן מיידי, צריך להגדיר את הערך 0. blockAfterDays חייב להיות קטן מ-wipeAfterDays.

blockScope

enum (BlockScope)

מציין את ההיקף של BlockAction. ההגדרה הזו רלוונטית רק למכשירים בבעלות החברה.

BlockScope

מציין את ההיקף של BlockAction. ההגדרה הזו רלוונטית רק למכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
BLOCK_SCOPE_UNSPECIFIED לא צוין. ברירת המחדל היא BLOCK_SCOPE_WORK_PROFILE.
BLOCK_SCOPE_WORK_PROFILE פעולת החסימה חלה רק על אפליקציות בפרופיל העבודה. אפליקציות בפרופיל האישי לא מושפעות.
BLOCK_SCOPE_DEVICE פעולת החסימה חלה על המכשיר כולו, כולל אפליקציות בפרופיל האישי.

WipeAction

איפוס של מכשיר בבעלות החברה או מחיקת פרופיל עבודה. הערה: יש לציין גם את blockAction.

ייצוג JSON
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
שדות
wipeAfterDays

integer

מספר הימים שבהם המדיניות לא תעמוד בדרישות המדיניות לפני איפוס הנתונים במכשיר או בפרופיל העבודה. wipeAfterDays חייב להיות גדול מ-blockAfterDays.

preserveFrp

boolean

האם נתוני ההגנה מפני איפוס להגדרות המקוריות נשמרים במכשיר. ההגדרה הזו לא חלה על פרופילים של עבודה.

KioskCustomization

הגדרות שקובעות את התנהגות המכשיר במצב קיוסק. כדי להפעיל מצב קיוסק, צריך להגדיר את kioskCustomLauncherEnabled לערך true או לציין אפליקציה במדיניות עם installType KIOSK.

ייצוג JSON
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
שדות
powerButtonActions

enum (PowerButtonActions)

הגדרת ההתנהגות של מכשיר במצב קיוסק כשמשתמש לוחץ לחיצה ארוכה על לחצן ההפעלה.

systemErrorWarnings

enum (SystemErrorWarnings)

ההגדרה קובעת אם תיבות דו-שיח של שגיאות מערכת באפליקציות שקורסות או שלא מגיבות חסומות במצב קיוסק. אם האפליקציה תיחסם, המערכת תאלץ את עצירת האפליקציה כאילו המשתמש בוחר באפשרות 'סגירת האפליקציה' בממשק המשתמש.

systemNavigation

enum (SystemNavigation)

המדיניות הזו מציינת אילו תכונות ניווט מופעלות (למשל, 'דף הבית' ו'לחצני סקירה כללית') במצב קיוסק.

statusBar

enum (StatusBar)

ההגדרה קובעת אם פרטי המערכת וההתראות מושבתים במצב קיוסק.

deviceSettings

enum (DeviceSettings)

המדיניות הזו מציינת אם אפשר להשתמש באפליקציית ההגדרות במצב קיוסק.

PowerButtonActions

הגדרת ההתנהגות של מכשיר במצב קיוסק כשמשתמש לוחץ לחיצה ארוכה על לחצן ההפעלה.

טיפוסים בני מנייה (enums)
POWER_BUTTON_ACTIONS_UNSPECIFIED לא צוין, ברירת המחדל היא POWER_BUTTON_AVAILABLE.
POWER_BUTTON_AVAILABLE תפריט ההפעלה (למשל, כיבוי, הפעלה מחדש) מוצג כשמשתמש לוחץ לחיצה ארוכה על לחצן ההפעלה במכשיר במצב קיוסק.
POWER_BUTTON_BLOCKED תפריט ההפעלה (למשל, כיבוי או הפעלה מחדש) לא מוצג כשמשתמש לוחץ לחיצה ארוכה על לחצן ההפעלה במכשיר במצב קיוסק. הערה: פעולה זו עלולה למנוע ממשתמשים לכבות את המכשיר.

SystemErrorWarnings

ההגדרה קובעת אם תיבות דו-שיח של שגיאות מערכת באפליקציות שקורסות או שלא מגיבות חסומות במצב קיוסק.

טיפוסים בני מנייה (enums)
SYSTEM_ERROR_WARNINGS_UNSPECIFIED לא צוין, ברירת המחדל היא ERROR_AND_WARNINGS_MUTED.
ERROR_AND_WARNINGS_ENABLED מוצגות כל תיבות הדו-שיח של שגיאות המערכת, כמו קריסה ואפליקציה שלא מגיבה (ANR).
ERROR_AND_WARNINGS_MUTED כל תיבות הדו-שיח של שגיאות המערכת, כמו הקריסה והאפליקציה שלא מגיבה (ANR), חסומות. כשהאפליקציה חסומה, המערכת תאלץ את העצירה שלה כאילו המשתמש סוגר את האפליקציה מממשק המשתמש.

SystemNavigation

המדיניות הזו מציינת אילו תכונות ניווט מופעלות (למשל, 'דף הבית' ו'לחצני סקירה כללית') במצב קיוסק.

טיפוסים בני מנייה (enums)
SYSTEM_NAVIGATION_UNSPECIFIED לא צוין, ברירת המחדל היא NAVIGATION_DISABLED.
NAVIGATION_ENABLED לחצני דף הבית והסקירה הכללית מופעלים.
NAVIGATION_DISABLED אין גישה ללחצנים של דף הבית ושל הסקירה הכללית.
HOME_BUTTON_ONLY רק הלחצן הראשי מופעל.

StatusBar

ההגדרה קובעת אם פרטי המערכת וההתראות מושבתים במצב קיוסק.

טיפוסים בני מנייה (enums)
STATUS_BAR_UNSPECIFIED לא צוין, ברירת המחדל היא INFO_AND_NOTIFICATIONS_DISABLED.
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

במצב קיוסק, פרטי המערכת וההתראות מוצגים בשורת הסטטוס.

הערה: כדי שהמדיניות הזו תיכנס לתוקף, חובה להפעיל את לחצן דף הבית של המכשיר באמצעות kioskCustomization.systemNavigation.

NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED פרטי המערכת וההתראות מושבתים במצב קיוסק.
SYSTEM_INFO_ONLY רק פרטי המערכת מוצגים בשורת הסטטוס.

DeviceSettings

המדיניות קובעת אם המשתמש יכול לגשת לאפליקציית ההגדרות של המכשיר במצב קיוסק.

טיפוסים בני מנייה (enums)
DEVICE_SETTINGS_UNSPECIFIED לא צוין, ברירת המחדל היא SETTINGS_ACCESS_ALLOWED.
SETTINGS_ACCESS_ALLOWED הגישה לאפליקציית ההגדרות מותרת במצב קיוסק.
SETTINGS_ACCESS_BLOCKED הגישה לאפליקציית ההגדרות אסורה במצב קיוסק.

AdvancedSecurityOverrides

הגדרות אבטחה מתקדמות. ברוב המקרים אין צורך להגדיר אותן.

ייצוג JSON
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy)
}
שדות
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

המדיניות בנושא אפליקציות לא מהימנות (אפליקציות ממקורות לא ידועים) שנאכפה במכשיר. החלפה של installUnknownSourcesAllowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

האם אימות Google Play Protect נאכף. מחליף את ensureVerifyAppsEnabled (הוצא משימוש).

developerSettings

enum (DeveloperSettings)

שליטה בגישה להגדרות המפתח: אפשרויות למפתחים והפעלה בטוחה. מחליף את safeBootDisabled (הוצא משימוש) ו-debuggingFeaturesAllowed (הוצא משימוש).

commonCriteriaMode

enum (CommonCriteriaMode)

שולטת במצב Common Criteria – תקני האבטחה מוגדרים ב-Common Criteria for Information Technology Security Evaluation (CC). הפעלה של מצב Common Criteria מגדילה את רכיבי האבטחה של המכשיר, כולל הצפנת AES-GCM של מפתחות Bluetooth לטווח ארוך ומאגרים של הגדרות Wi-Fi.

אזהרה: מצב Common Criteria אוכף מודל אבטחה מחמיר שנדרש בדרך כלל רק למוצרי IT שנעשה בהם שימוש במערכות של אבטחה לאומית וארגונים אחרים בעלי רגישות גבוהה. ייתכן שתהיה השפעה על שימוש רגיל במכשירים. מופעל רק אם יש צורך.

personalAppsThatCanReadWorkNotifications[]

string

אפליקציות לשימוש אישי שיכולות לקרוא התראות מפרופיל העבודה באמצעות NotificationListenerService. כברירת מחדל, אף אפליקציה אישית (מלבד אפליקציות המערכת) לא יכולה לקרוא התראות מהעבודה. כל ערך ברשימה חייב להיות שם חבילה.

mtePolicy

enum (MtePolicy)

זה שינוי אופציונלי. שולטת בתוסף תיוג זיכרון (MTE) במכשיר. יש להפעיל מחדש את המכשיר כדי להחיל שינויים במדיניות MTE.

UntrustedAppsPolicy

המדיניות בנושא אפליקציות לא מהימנות (אפליקציות ממקורות לא ידועים) שנאכפה במכשיר. החלפה של installUnknownSourcesAllowed (deprecated).

טיפוסים בני מנייה (enums)
UNTRUSTED_APPS_POLICY_UNSPECIFIED לא צוין. ברירת המחדל היא DISALLOW_INSTALL.
DISALLOW_INSTALL ברירת מחדל. לאסור על התקנות של אפליקציות לא מהימנות בכל המכשיר.
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY במכשירים עם פרופיל עבודה, מומלץ לאפשר התקנות של אפליקציות לא מהימנות דרך הפרופיל האישי של המכשיר בלבד.
ALLOW_INSTALL_DEVICE_WIDE התרת התקנות של אפליקציות לא מהימנות במכשיר כולו.

GooglePlayProtectVerifyApps

האם אימות Google Play Protect נאכף. מחליף את ensureVerifyAppsEnabled (הוצא משימוש).

טיפוסים בני מנייה (enums)
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED לא צוין. ברירת המחדל היא Verify_APPS_ENFORCED.
VERIFY_APPS_ENFORCED ברירת מחדל. אילוץ הפעלה של אימות אפליקציות.
VERIFY_APPS_USER_CHOICE המשתמש יכול לבחור אם להפעיל אימות אפליקציות.

DeveloperSettings

שליטה בגישה להגדרות המפתח: אפשרויות למפתחים והפעלה בטוחה. מחליף את safeBootDisabled (הוצא משימוש) ו-debuggingFeaturesAllowed (הוצא משימוש).

טיפוסים בני מנייה (enums)
DEVELOPER_SETTINGS_UNSPECIFIED לא צוין. ברירת המחדל היא DEVELOPER_SETTINGS_DISABLED.
DEVELOPER_SETTINGS_DISABLED ברירת מחדל. משבית את כל ההגדרות למפתחים ומונעת מהמשתמש לגשת אליהן.
DEVELOPER_SETTINGS_ALLOWED התרת כל ההגדרות למפתחים. המשתמש יכול לגשת להגדרות ולבחור אם לקבוע אותן.

CommonCriteriaMode

שולטת במצב Common Criteria – תקני האבטחה מוגדרים ב-Common Criteria for Information Technology Security Evaluation (CC). הפעלה של מצב Common Criteria מגדילה את רכיבי האבטחה של המכשיר, כולל הצפנת AES-GCM של מפתחות Bluetooth לטווח ארוך ומאגרים של הגדרות Wi-Fi.

אזהרה: מצב Common Criteria אוכף מודל אבטחה מחמיר שנדרש בדרך כלל רק למוצרי IT שנעשה בהם שימוש במערכות של אבטחה לאומית וארגונים אחרים בעלי רגישות גבוהה. ייתכן שתהיה השפעה על שימוש רגיל במכשירים. מופעל רק אם יש צורך. אם מצב Common Criteria מושבת לאחר שהופעל בעבר, ייתכן שכל רשתות ה-Wi-Fi שהוגדרו על ידי המשתמשים יאבדו ויהיה צורך להגדיר מחדש את כל רשתות ה-Wi-Fi שהוגדרו בארגון שמחייבות קלט של משתמשים.

טיפוסים בני מנייה (enums)
COMMON_CRITERIA_MODE_UNSPECIFIED לא צוין. ברירת המחדל היא Common_CRITERIA_mode_DISABLED.
COMMON_CRITERIA_MODE_DISABLED ברירת מחדל. השבתה של מצב Common Criteria.
COMMON_CRITERIA_MODE_ENABLED הפעלת מצב Common Criteria.

MtePolicy

שולטת בתוסף תיוג זיכרון (MTE) במכשיר.

טיפוסים בני מנייה (enums)
MTE_POLICY_UNSPECIFIED לא צוין. ברירת המחדל היא MTE_USER_CHOICE.
MTE_USER_CHOICE המשתמש יכול לבחור להפעיל או להשבית MTE במכשיר אם המכשיר תומך בכך.
MTE_ENFORCED

MTE מופעל במכשיר והמשתמש לא יכול לשנות את ההגדרה הזו. אפשר להגדיר את זה במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה. nonComplianceDetail עם MANAGEMENT_MODE מדווח במצבי ניהול אחרים. יש דיווח על nonComplianceDetail עם DEVICE_INCOMPATIBLE אם המכשיר לא תומך ב-MTE.

התכונה נתמכת ב-Android מגרסה 14 ואילך. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-14.

MTE_DISABLED

MTE מושבת במכשיר והמשתמש לא יכול לשנות את ההגדרה הזו. הסעיף הזה רלוונטי רק למכשירים שמנוהלים באופן מלא. במקרים אחרים מתקבל דיווח על nonComplianceDetail עם MANAGEMENT_MODE. יש דיווח על nonComplianceDetail עם DEVICE_INCOMPATIBLE אם המכשיר לא תומך ב-MTE.

התכונה נתמכת ב-Android מגרסה 14 ואילך. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-14.

PersonalUsagePolicies

כללי מדיניות שחלים על שימוש אישי במכשירים בבעלות החברה שיש להם פרופיל עבודה.

ייצוג JSON
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ]
}
שדות
cameraDisabled

boolean

אם המדיניות מוגדרת כ-True, המצלמה תושבת בפרופיל האישי.

screenCaptureDisabled

boolean

אם הערך הוא True, צילום המסך מושבת לכל המשתמשים.

accountTypesWithManagementDisabled[]

string

סוגי חשבונות שהמשתמשים לא יכולים לנהל.

maxDaysWithWorkOff

integer

ההגדרה קובעת כמה זמן פרופיל העבודה יכול להישאר מושבת. משך הזמן המינימלי צריך להיות 3 ימים לפחות. פרטים נוספים מופיעים כאן:

  • אם משך הזמן מוגדר ל-0, התכונה מושבתת.
  • אם משך הזמן מוגדר לערך קטן ממשך הזמן המינימלי, התכונה תחזיר שגיאה.
הערה: אם רוצים למנוע השעיה של פרופילים אישיים למשך פרקי זמן ארוכים של השבתה, אפשר להגדיר באופן זמני ערך גדול לפרמטר הזה.

personalPlayStoreMode

enum (PlayStoreMode)

הנתונים משמשים יחד עם personalApplications כדי לקבוע איך מותר או לחסום אפליקציות בפרופיל האישי.

personalApplications[]

object (PersonalApplicationPolicy)

המדיניות חלה על אפליקציות בפרופיל האישי.

PlayStoreMode

הנתונים משמשים יחד עם personalApplications כדי לקבוע איך מותר או לחסום אפליקציות בפרופיל האישי.

טיפוסים בני מנייה (enums)
PLAY_STORE_MODE_UNSPECIFIED לא צוין. ברירת המחדל היא BLOCKLIST.
BLACKLIST

כל האפליקציות של חנות Play זמינות להתקנה בפרופיל האישי, מלבד אפליקציות שinstallType BLOCKED ב-personalApplications.

BLOCKLIST כל האפליקציות של חנות Play זמינות להתקנה בפרופיל האישי, מלבד אפליקציות שinstallType BLOCKED ב-personalApplications.
ALLOWLIST מותר להתקין בפרופיל האישי רק אפליקציות שצוינו במפורש ב-personalApplications שבהן installType מוגדר כ-AVAILABLE.

PersonalApplicationPolicy

כללי מדיניות שחלים על אפליקציות בפרופיל האישי של מכשיר בבעלות חברה עם פרופיל עבודה.

ייצוג JSON
{
  "packageName": string,
  "installType": enum (InstallType)
}
שדות
packageName

string

שם החבילה של האפליקציה.

installType

enum (InstallType)

סוג ההתקנה שצריך לבצע.

InstallType

סוגי התנהגויות ההתקנה שיכולות להיות לאפליקציית פרופיל אישי.

טיפוסים בני מנייה (enums)
INSTALL_TYPE_UNSPECIFIED לא צוין. ברירת המחדל היא AVAILABLE.
BLOCKED האפליקציה חסומה ואי אפשר להתקין אותה בפרופיל האישי. אם האפליקציה הותקנה בעבר במכשיר, היא תוסר.
AVAILABLE האפליקציה זמינה להתקנה בפרופיל האישי.

AutoDateAndTimeZone

הפעלה של התאריך, השעה ואזור הזמן האוטומטיים במכשיר בבעלות החברה.

טיפוסים בני מנייה (enums)
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED לא צוין. ברירת המחדל היא AUTO_DATE_AND_TIME_ZONE_USER_CHOICE.
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE התאריך, השעה ואזור הזמן שהוגדרו אוטומטית נתונים לבחירת המשתמש.
AUTO_DATE_AND_TIME_ZONE_ENFORCED אכיפה של תאריך, שעה ואזור זמן אוטומטיים במכשיר.

OncCertificateProvider

התכונה הזו לא זמינה לכלל המשתמשים.

ייצוג JSON
{
  "certificateReferences": [
    string
  ],

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

string

התכונה הזו לא זמינה לכלל המשתמשים.

שדה איחוד endpoint.

התכונה הזו לא זמינה לכלל המשתמשים. endpoint יכול להיות רק אחד מהבאים:

contentProviderEndpoint

object (ContentProviderEndpoint)

התכונה הזו לא זמינה לכלל המשתמשים.

ContentProviderEndpoint

התכונה הזו לא זמינה לכלל המשתמשים.

ייצוג JSON
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
שדות
uri

string

התכונה הזו לא זמינה לכלל המשתמשים.

packageName

string

התכונה הזו לא זמינה לכלל המשתמשים.

signingCertsSha256[]

string

חובה. התכונה הזו לא זמינה לכלל המשתמשים.

CrossProfilePolicies

ההגדרה הזו שולטת בנתונים מפרופיל העבודה שאפשר לגשת אליהם מהפרופיל האישי ולהפך. אם למכשיר אין פרופיל עבודה, יישלח דיווח על nonComplianceDetail עם MANAGEMENT_MODE.

ייצוג JSON
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
שדות
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

האם אפליקציות לשימוש אישי יכולות לגשת לאנשי קשר שמאוחסנים בפרופיל העבודה.

למידע נוסף, יש לעיין ב-exemptionsToShowWorkContactsInPersonalProfile.

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

אם ניתן להדביק טקסט שהועתק מפרופיל אחד (אישי או מהעבודה) בפרופיל השני.

crossProfileDataSharing

enum (CrossProfileDataSharing)

אם ניתן לשתף נתונים מפרופיל אחד (אישי או לצורכי עבודה) עם אפליקציות בפרופיל האחר. שולטת באופן ספציפי בשיתוף נתונים פשוט באמצעות כוונות Intent. ניהול של ערוצי תקשורת אחרים בין פרופילים, כמו חיפוש אנשי קשר, העתקה/הדבקה או אפליקציות מקושרות לעבודה ולאישיות, מוגדר בנפרד.

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

ההגדרה קובעת את התנהגות ברירת המחדל לווידג'טים של פרופיל עבודה. אם המדיניות לא מציינת workProfileWidgets לאפליקציה ספציפית, האפליקציה תפעל בהתאם לערך שמצוין כאן.

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

רשימת האפליקציות שלא נכללות בהגדרה ShowWorkContactsInPersonalProfile. כדי שניתן יהיה לקבוע את הערך הזה, צריך להגדיר את ShowWorkContactsInPersonalProfile לאחד מהערכים הבאים:

התכונה נתמכת ב-Android מגרסה 14 ואילך. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-14.

ShowWorkContactsInPersonalProfile

האם אפליקציות לשימוש אישי יכולות לגשת לאנשי הקשר מפרופיל העבודה, כולל חיפושים של אנשי קשר ושיחות נכנסות

הערה: ברגע שאיש הקשר בפרופיל העבודה נכנס אליו דרך אפליקציה לשימוש אישי, לא ניתן להבטיח שהוא יישאר באותה האפליקציה. הסיבה לכך היא שאפשר לשתף את איש הקשר או להעביר אותו לכל אפליקציה אחרת, בהתאם להתנהגות של האפליקציה שאושרה.

טיפוסים בני מנייה (enums)
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

לא צוין. ברירת המחדל היא SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED.

אם המדיניות הזו מוגדרת, לא ניתן להגדיר את exemptionsToShowWorkContactsInPersonalProfile.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED

ההגדרה מונעת מאפליקציות לשימוש אישי לגשת לאנשי קשר בפרופיל העבודה ולחפש אנשי קשר בעבודה.

אם המדיניות הזו מוגדרת, האפליקציות האישיות שצוינו ב-exemptionsToShowWorkContactsInPersonalProfile נכללות ברשימת ההיתרים, ויכולות לגשת ישירות לאנשי הקשר בפרופיל העבודה.

התכונה נתמכת ב-Android 7.0 ואילך. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-7.0.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

ברירת מחדל. ההגדרה הזו מאפשרת לאפליקציות בפרופיל האישי לגשת לאנשי הקשר מפרופיל העבודה, כולל חיפושים של אנשי קשר ושיחות נכנסות.

אם המדיניות הזו מוגדרת, האפליקציות האישיות שצוינו ב-exemptionsToShowWorkContactsInPersonalProfile מסומנות ברשימת החסימה. לא ניתן לגשת אליהן ישירות לאנשי הקשר בפרופיל העבודה.

התכונה נתמכת ב-Android 7.0 ואילך. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-7.0.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

ההגדרה הזו מונעת מרוב האפליקציות האישיות לגשת לאנשי קשר בפרופיל העבודה, כולל חיפושים של אנשי קשר ושיחות נכנסות, למעט האפליקציות 'חייגן', 'Messages' ו'אנשי קשר' שמוגדרות כברירת מחדל של ה-OEM. האפליקציות 'חייגן', 'Messages' ו'אנשי קשר' שהוגדרו על ידי המשתמש, וגם אפליקציות אחרות שמותקנות במערכת או ב-Play, לא יוכלו להריץ שאילתות ישירות על אנשי קשר מהעבודה.

אם המדיניות הזו מוגדרת, האפליקציות האישיות שצוינו ב-exemptionsToShowWorkContactsInPersonalProfile נכללות ברשימת ההיתרים, ויכולות לגשת לאנשי הקשר בפרופיל העבודה.

התכונה נתמכת ב-Android מגרסה 14 ואילך. אם המדיניות הזו מוגדרת במכשיר עם גרסת Android ישנה יותר מ-14, ההתנהגות תחזור להיות SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED ויתקבל דיווח על nonComplianceDetail עם API_LEVEL.

CrossProfileCopyPaste

אם ניתן להדביק טקסט שהועתק מפרופיל אחד (אישי או מהעבודה) בפרופיל השני.

טיפוסים בני מנייה (enums)
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED לא צוין. ברירת המחדל היא Copy_FROM_WORK_TO_PERSONAL_DISALLOWED
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED ברירת מחדל. משתמשים לא יכולים להדביק טקסט בפרופיל האישי שהועתק מפרופיל העבודה. את הטקסט שהועתק מהפרופיל האישי אפשר להדביק בפרופיל העבודה, ואת הטקסט שהועתק מפרופיל העבודה, אפשר להדביק אותו בפרופיל העבודה.
CROSS_PROFILE_COPY_PASTE_ALLOWED אם יש טקסט שהועתק בכל אחד מהפרופילים, אפשר להדביק אותו בפרופיל השני.

CrossProfileDataSharing

אם ניתן לשתף נתונים מפרופיל אחד (אישי או לצורכי עבודה) עם אפליקציות בפרופיל האחר. שולטת באופן ספציפי בשיתוף נתונים פשוט באמצעות כוונות Intent. ניהול של ערוצי תקשורת אחרים בין פרופילים, כמו חיפוש אנשי קשר, העתקה/הדבקה או אפליקציות מקושרות לעבודה ולאישיות, מוגדר בנפרד.

טיפוסים בני מנייה (enums)
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED לא צוין. ברירת המחדל היא DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED.
CROSS_PROFILE_DATA_SHARING_DISALLOWED מונע שיתוף של נתונים מהפרופיל האישי לפרופיל העבודה וגם מפרופיל העבודה לפרופיל האישי.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED ברירת מחדל. משתמשים לא יכולים לשתף נתונים מפרופיל העבודה עם אפליקציות בפרופיל האישי. ניתן לשתף מידע אישי עם אפליקציות לעבודה.
CROSS_PROFILE_DATA_SHARING_ALLOWED ניתן לשתף נתונים מכל אחד מהפרופילים עם הפרופיל האחר.

WorkProfileWidgetsDefault

המדיניות קובעת אם אפליקציות של פרופיל העבודה מורשות להוסיף ווידג'טים למסך הבית, שלא מוגדרת בו מדיניות ספציפית לאפליקציה. אחרת, המדיניות הספציפית לאפליקציה תקבל עדיפות על פני המדיניות הזו.

טיפוסים בני מנייה (enums)
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED לא צוין. ברירת המחדל היא WORK_PROFILE_ WIDGETS_DEFAULT_DISALLOWED.
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED ווידג'טים של פרופיל עבודה מותרים כברירת מחדל. המשמעות היא שאם המדיניות לא מציינת את workProfileWidgets בתור WORK_PROFILE_WIDGETS_DISALLOWED באפליקציה, תהיה אפשרות להוסיף ווידג'טים למסך הבית.
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED כברירת מחדל, הווידג'טים של פרופיל העבודה אסורים לשימוש. המשמעות היא שאם המדיניות לא מציינת את workProfileWidgets בתור WORK_PROFILE_WIDGETS_ALLOWED עבור האפליקציה, לא תהיה אפשרות להוסיף ווידג'טים למסך הבית.

PreferentialNetworkService

המדיניות הזו קובעת אם שירות הרשת המועדפת מופעל בפרופיל העבודה. את יכולה לראות עוד פרטים בכתובת preferentialNetworkService.

טיפוסים בני מנייה (enums)
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED לא צוין. ברירת המחדל היא PREFERENTIAL_NETWORK_SERVICES_DISABLED.
PREFERENTIAL_NETWORK_SERVICE_DISABLED שירות הרשת המועדף מושבת בפרופיל העבודה.
PREFERENTIAL_NETWORK_SERVICE_ENABLED שירות הרשת המועדף מופעל בפרופיל העבודה.

UsageLog

המדיניות הזו קובעת את הסוגים של יומני הפעילות במכשיר שנאספים מהמכשיר ומדווחים באמצעות התראות ב-Pub/Sub.

ייצוג JSON
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
שדות
enabledLogTypes[]

enum (LogType)

ההגדרה קובעת אילו סוגי יומנים מופעלים. חשוב לדעת שהמשתמשים יקבלו הודעות במכשיר כשרישום השימוש ביומן מופעל.

uploadOnCellularAllowed[]

enum (LogType)

ההגדרה קובעת אילו סוגי יומנים מופעלים אפשר להעלות באמצעות חבילת הגלישה. כברירת מחדל, היומנים ממתינים בתור להעלאה כשהמכשיר מתחבר ל-Wi-Fi.

LogType

הסוגים של יומני הפעילות במכשיר שדווחו מהמכשיר.

טיפוסים בני מנייה (enums)
LOG_TYPE_UNSPECIFIED הערך הזה לא בשימוש.
SECURITY_LOGS הפעלת רישום של אירועי אבטחה במכשיר, למשל אם מזינים את הסיסמה של המכשיר בצורה שגויה או כשמתקינים אמצעי אחסון נשלף. תיאור מלא של אירועי האבטחה שתועדו זמין בכתובת UsageLogEvent. נתמכת במכשירים שמנוהלים באופן מלא ב-Android 7 ואילך. נתמכת במכשירים בבעלות החברה עם פרופיל עבודה ב-Android מגרסה 12 ואילך, ושבהם מתועדים רק אירועי אבטחה מפרופיל העבודה. ניתן לדרוס על ידי ההיקף המואצל של האפליקציה SECURITY_LOGS
NETWORK_ACTIVITY_LOGS הפעלת רישום ביומן של אירועי רשת במכשיר, כמו חיפושי DNS וחיבורי TCP. בקטע UsageLogEvent יש תיאור מלא של אירועי הרשת שתועדו. נתמכת במכשירים מנוהלים ב-Android מגרסה 8 ומעלה. התכונה נתמכת במכשירים בבעלות החברה עם פרופיל עבודה ב-Android מגרסה 12 ואילך, ושבהם מתועדים רק אירועי רשת מפרופיל העבודה. ניתן לדרוס על ידי ההיקף המואצל של האפליקציה NETWORK_ACTIVITY_LOGS

CameraAccess

קובעת את השימוש במצלמה ואם למשתמש יש גישה למתג הגישה למצלמה. מתג הגישה למצלמה קיים ב-Android מגרסה 12 ואילך. באופן כללי, האפשרות להשבית את המצלמה חלה על המכשיר כולו במכשירים מנוהלים, ורק בתוך פרופיל העבודה במכשירים עם פרופיל עבודה. האפשרות להשבית את מתג הגישה למצלמה חלה רק על מכשירים מנוהלים. במקרה כזה, היא חלה על המכשיר כולו. לפרטים ספציפיים, עיין בערכי 'טיפוסים בני מנייה (enum)'.

טיפוסים בני מנייה (enums)
CAMERA_ACCESS_UNSPECIFIED אם cameraDisabled הוא TRUE, הוא שווה ל-CAMERA_ACCESS_DISABLED. אחרת, הערך הזה זהה לערך CAMERA_ACCESS_USER_CHOICE.
CAMERA_ACCESS_USER_CHOICE המערכת מתעלמת מהשדה cameraDisabled. זו התנהגות ברירת המחדל של המכשיר: כל המצלמות במכשיר זמינות. ב-Android מגרסה 12 ואילך, המשתמשים יכולים להשתמש במתג הגישה למצלמה.
CAMERA_ACCESS_DISABLED

המערכת מתעלמת מהשדה cameraDisabled. כל המצלמות במכשיר מושבתות (האפשרות הזו חלה על המכשיר כולו, ועל פרופילים של עבודה רק על פרופיל העבודה).

אין הגבלות מפורשות על מתג הגישה למצלמה ב-Android מגרסה 12 ואילך: במכשירים מנוהלים, מתג הגישה למצלמה לא משפיע כי כל המצלמות מושבתות. במכשירים עם פרופיל עבודה, המתג הזה לא משפיע על אפליקציות בפרופיל העבודה, אבל הוא משפיע על אפליקציות מחוץ לפרופיל העבודה.

CAMERA_ACCESS_ENFORCED המערכת מתעלמת מהשדה cameraDisabled. כל המצלמות במכשיר זמינות. במכשירים מנוהלים עם Android מגרסה 12 ואילך, המשתמש לא יכול להשתמש במתג הגישה למצלמה. במכשירים שלא מנוהלים באופן מלא או במכשירים עם Android מגרסה 11 ומטה, הערך הזה מקביל ל-CAMERA_ACCESS_USER_CHOICE.

MicrophoneAccess

במכשירים מנוהלים, האפשרות הזו קובעת את השימוש במיקרופון ואם למשתמש יש גישה למתג הגישה למיקרופון. ההגדרה הזאת לא משפיעה על מכשירים שלא מנוהלים באופן מלא. מתג הגישה למיקרופון קיים ב-Android מגרסה 12 ואילך.

טיפוסים בני מנייה (enums)
MICROPHONE_ACCESS_UNSPECIFIED אם unmuteMicrophoneDisabled הוא TRUE, הוא שווה ל-MICROPHONE_ACCESS_DISABLED. אחרת, הערך הזה זהה לערך MICROPHONE_ACCESS_USER_CHOICE.
MICROPHONE_ACCESS_USER_CHOICE המערכת מתעלמת מהשדה unmuteMicrophoneDisabled. זו התנהגות ברירת המחדל של המכשיר: המיקרופון במכשיר זמין. ב-Android מגרסה 12 ואילך, המשתמשים יכולים להשתמש במתג הגישה למיקרופון.
MICROPHONE_ACCESS_DISABLED

המערכת מתעלמת מהשדה unmuteMicrophoneDisabled. המיקרופון של המכשיר מושבת (האפשרות הזו חלה על מכשירים שמנוהלים באופן מלא).

מתג הגישה למיקרופון לא משפיע כי המיקרופון מושבת.

MICROPHONE_ACCESS_ENFORCED המערכת מתעלמת מהשדה unmuteMicrophoneDisabled. המיקרופון במכשיר זמין. במכשירים עם Android מגרסה 12 ומעלה, המשתמש לא יכול להשתמש במתג הגישה למיקרופון. במכשירים עם Android מגרסה 11 ומטה, זה מקביל ל-MICROPHONE_ACCESS_USER_CHOICE.

DeviceConnectivityManagement

כיסויים לפקדים לקישוריות של המכשיר, כמו Wi-Fi, גישה לנתונים ב-USB, חיבורי מקלדת/עכבר ועוד.

ייצוג JSON
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings)
}
שדות
usbDataAccess

enum (UsbDataAccess)

המדיניות הזו קובעת אילו קבצים ו/או נתונים אפשר להעביר באמצעות USB. התכונה נתמכת רק במכשירים בבעלות החברה.

configureWifi

enum (ConfigureWifi)

שליטה בהרשאות בהגדרת Wi-Fi. בהתאם לאפשרות שנבחרה, למשתמש תהיה שליטה מלאה או מוגבלת, או ללא שליטה מלאה בהגדרת רשתות ה-Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

הגדרה זו מאפשרת לקבוע את ההגדרות של Wi-Fi ישיר ולהשתמש בהן. התכונה נתמכת במכשירים בבעלות חברה עם Android 13 ומעלה.

tetheringSettings

enum (TetheringSettings)

שולטת בהגדרות של שיתוף אינטרנט בין מכשירים. על סמך הערך שהוגדר, למשתמש אסור להשתמש בצורות שונות של שיתוף אינטרנט בין מכשירים, או באופן חלקי או מלא.

UsbDataAccess

המדיניות הזו קובעת אילו קבצים ו/או נתונים אפשר להעביר באמצעות USB. אין השפעה על פונקציות הטעינה. התכונה נתמכת רק במכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
USB_DATA_ACCESS_UNSPECIFIED לא צוין. ברירת המחדל היא DISALLOW_USB_FILE_TRANSFER.
ALLOW_USB_DATA_TRANSFER מותר להשתמש בכל הסוגים של העברות נתונים בחיבור USB. המערכת מתעלמת מ-usbFileTransferDisabled.
DISALLOW_USB_FILE_TRANSFER העברת קבצים באמצעות USB אסורה. מותר להשתמש בסוגים אחרים של חיבורי נתונים בחיבור USB, כמו עכבר ומקלדת. המערכת מתעלמת מ-usbFileTransferDisabled.
DISALLOW_USB_DATA_TRANSFER אם המדיניות מוגדרת, כל הסוגים של העברות נתונים בחיבור USB אסורים. נתמכת במכשירים עם Android מגרסה 12 ומעלה עם USB HAL 1.3 ומעלה. אם ההגדרה לא נתמכת, המערכת תגדיר את DISALLOW_USB_FILE_TRANSFER. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-12. יישלח דיווח על nonComplianceDetail עם DEVICE_INCOMPATIBLE אם אין במכשיר USB HAL מגרסה 1.3 ואילך. המערכת מתעלמת מ-usbFileTransferDisabled.

ConfigureWifi

שליטה בהרשאות בהגדרת Wi-Fi. בהתאם לאפשרות שהוגדרה, למשתמש תהיה שליטה מלאה או מוגבלת או ללא שליטה בהגדרת רשתות Wi-Fi.

טיפוסים בני מנייה (enums)
CONFIGURE_WIFI_UNSPECIFIED לא צוין. ברירת המחדל היא ALLOW_CONFIGURING_WIFI, אלא אם הערך של wifiConfigDisabled מוגדר כ-True. אם המדיניות wifiConfigDisabled מוגדרת כ-True, הערך הזה שווה ערך ל-DISALLOW_CONFIGURING_WIFI.
ALLOW_CONFIGURING_WIFI המשתמש יכול להגדיר Wi-Fi. המערכת מתעלמת מ-wifiConfigDisabled.
DISALLOW_ADD_WIFI_CONFIG אין להוסיף הגדרות Wi-Fi חדשות. המשתמש יכול רק לעבור בין רשתות שכבר הוגדרו. נתמכת ב-Android 13 ואילך במכשירים מנוהלים ובפרופילי עבודה במכשירים שבבעלות החברה. אם ההגדרה לא נתמכת, הערך ALLOW_CONFIGURING_WIFI מוגדר. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13. המערכת מתעלמת מ-wifiConfigDisabled.
DISALLOW_CONFIGURING_WIFI המדיניות לא מאפשרת להגדיר רשתות Wi-Fi. המערכת מתעלמת מההגדרה wifiConfigDisabled כאשר הערך הזה מוגדר. נתמכת במכשירים מנוהלים ובפרופיל עבודה במכשירים בבעלות החברה, בכל רמות ה-API הנתמכות. במכשירים מנוהלים, ההגדרה הזו מסירה את כל הרשתות שהוגדרו ושומרת רק את הרשתות שהוגדרו באמצעות המדיניות openNetworkConfiguration. לפרופילי עבודה במכשירים שבבעלות החברה, הרשתות המוגדרות לא יושפעו ואין למשתמש הרשאה להוסיף, להסיר או לשנות רשתות Wi-Fi. הערה: אם לא ניתן להתחבר לרשת בזמן ההפעלה והגדרת ה-Wi-Fi מושבתת, חלון היציאה מהרשת יוצג כדי לרענן את מדיניות המכשיר (ראו networkEscapeHatchEnabled).

WifiDirectSettings

שליטה בהגדרות Wi-Fi ישיר. התכונה נתמכת במכשירים בבעלות חברה עם Android 13 ומעלה.

טיפוסים בני מנייה (enums)
WIFI_DIRECT_SETTINGS_UNSPECIFIED לא צוין. ברירת המחדל היא ALLOW_WIFI_DIRECT
ALLOW_WIFI_DIRECT המשתמש רשאי להשתמש ב-Wi-Fi ישיר.
DISALLOW_WIFI_DIRECT המשתמש אינו מורשה להשתמש ב-Wi-Fi ישיר. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13.

TetheringSettings

ההגדרה קובעת את המידה שבה מותר למשתמש להשתמש בצורות שונות של שיתוף אינטרנט בין מכשירים, כמו שיתוף אינטרנט בין מכשירים (tethering) באמצעות Wi-Fi, שיתוף אינטרנט בין מכשירים באמצעות Bluetooth וכו'.

טיפוסים בני מנייה (enums)
TETHERING_SETTINGS_UNSPECIFIED לא צוין. ברירת המחדל היא ALLOW_ALL_TETHERING, אלא אם הערך של tetheringConfigDisabled מוגדר כ-True. אם המדיניות tetheringConfigDisabled מוגדרת כ-True, הערך הזה שווה ערך ל-DISALLOW_ALL_TETHERING.
ALLOW_ALL_TETHERING מאפשר הגדרה ושימוש בכל הצורות של שיתוף אינטרנט בין מכשירים. המערכת מתעלמת מ-tetheringConfigDisabled.
DISALLOW_WIFI_TETHERING למשתמש לא תהיה אפשרות להשתמש בשיתוף אינטרנט בין מכשירים באמצעות Wi-Fi. התכונה נתמכת במכשירים בבעלות החברה עם Android מגרסה 13 ומעלה. אם ההגדרה לא נתמכת, המערכת תגדיר את ALLOW_ALL_TETHERING. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13. המערכת מתעלמת מ-tetheringConfigDisabled.
DISALLOW_ALL_TETHERING השבתת כל סוגי שיתוף האינטרנט בין מכשירים. תמיכה נתמכת במכשירים מנוהלים ובפרופיל עבודה במכשירים בבעלות החברה, בכל גרסאות Android הנתמכות. המערכת מתעלמת מההגדרה tetheringConfigDisabled.

DeviceRadioState

פקדים להגדרות הרדיו של המכשיר.

ייצוג JSON
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel)
}
שדות
wifiState

enum (WifiState)

המדיניות הזו קובעת אם החיבור לרשת ה-Wi-Fi יפעל, ואם המשתמש יכול לשנות את המצב.

airplaneModeState

enum (AirplaneModeState)

המדיניות קובעת אם המשתמש יכול להחליף מצב טיסה או לא.

ultraWidebandState

enum (UltraWidebandState)

קובעת את מצב ההגדרה של Ultra Wideband (UWB), ואם המשתמש יכול להפעיל או להשבית אותה.

cellularTwoGState

enum (CellularTwoGState)

המדיניות קובעת אם המשתמשים יכולים להחליף את המצב של רשת 2G סלולרית.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

רמת האבטחה המינימלית הנדרשת של רשתות Wi-Fi שהמכשיר יכול להתחבר אליהן.

WifiState

המדיניות הזו קובעת אם ה-Wi-Fi פועל או כבוי כמצב ואם המשתמש יכול לשנות את המצב הזה. התכונה נתמכת במכשירים בבעלות חברה עם Android 13 ומעלה.

טיפוסים בני מנייה (enums)
WIFI_STATE_UNSPECIFIED לא צוין. ברירת המחדל היא WIFI_STATE_USER_CHOICE
WIFI_STATE_USER_CHOICE המשתמש יכול להפעיל/להשבית את ה-Wi-Fi.
WIFI_ENABLED ה-Wi-Fi מופעל והמשתמש לא מורשה להשבית אותו. נשלח דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android נמוכה מ-13.
WIFI_DISABLED ה-Wi-Fi כבוי והמשתמש לא מורשה להפעיל אותו. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13.

AirplaneModeState

המדיניות הזו שולטת במצב הטיסה ובאפשרות להפעיל או להשבית אותו. התכונה נתמכת ב-Android 9 ואילך. נתמכת במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
AIRPLANE_MODE_STATE_UNSPECIFIED לא צוין. ברירת המחדל היא AIRPLANE_MODE_USER_CHOICE.
AIRPLANE_MODE_USER_CHOICE המשתמש יכול להפעיל או להשבית את מצב טיסה.
AIRPLANE_MODE_DISABLED מצב טיסה מושבת. המשתמש לא מורשה להפעיל את מצב הטיסה. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-9.

UltraWidebandState

המדיניות הזו קובעת את המצב של הגדרת Ultra Wideband (UWB), ואם המשתמש יכול להפעיל או להשבית אותה. התכונה נתמכת ב-Android מגרסה 14 ואילך. נתמכת במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
ULTRA_WIDEBAND_STATE_UNSPECIFIED לא צוין. ברירת המחדל היא ULTRA_WIDEBAND_USER_CHOICE.
ULTRA_WIDEBAND_USER_CHOICE המשתמש רשאי להפעיל או להשבית את Ultra Wideband.
ULTRA_WIDEBAND_DISABLED Ultra Wideband מושבת. המשתמש לא מורשה להפעיל את Ultra Wideband (UWB) דרך ההגדרות. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-14.

CellularTwoGState

קובעת את מצב ההגדרה של רשת 2G הסלולרית ואם המשתמשים יכולים להפעיל או להשבית אותה. התכונה נתמכת ב-Android מגרסה 14 ואילך. נתמכת במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
CELLULAR_TWO_G_STATE_UNSPECIFIED לא צוין. ברירת המחדל היא CELLULAR_TWO_G_USER_CHOICE.
CELLULAR_TWO_G_USER_CHOICE המשתמש רשאי להפעיל או להשבית את הרשת הסלולרית של 2G.
CELLULAR_TWO_G_DISABLED רשת 2G סלולרית מושבתת. המשתמש אינו רשאי להפעיל את החיבור לרשת 2G דרך ההגדרות. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-14.

MinimumWifiSecurityLevel

מגדירה את רמות האבטחה המינימליות השונות של Wi-Fi הנדרשות כדי להתחבר לרשתות Wi-Fi. התכונה נתמכת ב-Android מגרסה 13 ואילך. נתמכת במכשירים מנוהלים ובפרופילי עבודה במכשירים בבעלות החברה.

טיפוסים בני מנייה (enums)
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED ערך ברירת המחדל הוא OPEN_NETWORK_SECURITY, כלומר המכשיר יוכל להתחבר לכל סוגי רשתות ה-Wi-Fi.
OPEN_NETWORK_SECURITY המכשיר יוכל להתחבר לכל הסוגים של רשתות ה-Wi-Fi.
PERSONAL_NETWORK_SECURITY רשת אישית כמו WEP, WPA2-PSK היא רשת האבטחה המינימלית הנדרשת. המכשיר לא יוכל להתחבר לרשתות Wi-Fi פתוחות. המדיניות הזו מחמירה יותר מ-OPEN_NETWORK_SECURITY. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13.
ENTERPRISE_NETWORK_SECURITY רשת EAP של הארגון היא רמת האבטחה המינימלית הנדרשת. המכשיר לא יוכל להתחבר לרשת Wi-Fi שנמצאת מתחת לרמת האבטחה הזו. המדיניות הזו מחמירה יותר מ-PERSONAL_NETWORK_SECURITY. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13.
ENTERPRISE_BIT192_NETWORK_SECURITY רשת ארגונית של 192 ביט היא רמת האבטחה המינימלית הנדרשת. המכשיר לא יוכל להתחבר לרשת Wi-Fi שנמצאת מתחת לרמת האבטחה הזו. המדיניות הזו מחמירה יותר מ-ENTERPRISE_NETWORK_SECURITY. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-13.

CredentialProviderPolicyDefault

המדיניות הזו קובעת אילו אפליקציות מורשות לפעול כספקי פרטי כניסה ב-Android מגרסה 14 ואילך. האפליקציות האלה שומרות פרטי כניסה. פרטים נוספים זמינים כאן וכאן. למידע נוסף, יש לעיין ב-credentialProviderPolicy.

טיפוסים בני מנייה (enums)
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED לא צוין. ברירת המחדל היא CREDENTIAL_provider_DEFAULT_DISALLOWED.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED אפליקציות שלא צוין בהן credentialProviderPolicy לא יכולות לפעול כספק של פרטי כניסה.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM אפליקציות שלא צוין בהן credentialProviderPolicy לא מורשות לפעול כספקי פרטי כניסה, למעט ספקי פרטי הכניסה שמוגדרים כברירת מחדל אצל ה-OEM. ספקים של פרטי כניסה שמוגדרים כברירת מחדל אצל ה-OEM תמיד יכולים לפעול כספקי פרטי הכניסה.

PrintingPolicy

המדיניות קובעת אם ניתן להדפיס. התכונה הזו נתמכת במכשירים עם Android מגרסה 9 ומעלה.

טיפוסים בני מנייה (enums)
PRINTING_POLICY_UNSPECIFIED לא צוין. ברירת המחדל היא PRINTING_ALLOWED.
PRINTING_DISALLOWED ההדפסה אסורה. מתבצע דיווח על nonComplianceDetail עם API_LEVEL אם גרסת Android ישנה יותר מ-9.
PRINTING_ALLOWED מותר להדפיס.

שיטות

delete

מחיקת מדיניות.

get

מקבלת מדיניות.

list

פירוט כללי המדיניות של ארגון נתון.

patch

עדכון או יוצר מדיניות.