يتم تمثيل سياسات Chrome على أنّها مخطّطات السياسات من خلال Schema Service API. يكون لكل مخطط سياسة اسم فريد لتعريفه، وتعريف لحقول الإعدادات وأنواعها، ووصفًا سهل القراءة للإعدادات باللغة الإنجليزية.
على سبيل المثال، في ما يلي الطريقة التي تمثل بها واجهة برمجة التطبيقات Schema Service API إعدادًا يسمح لزر تسجيل الخروج بالظهور في لوحة نظام Chrome. سيكون التمثيل المبسط
لهذا الإعداد bool showLogoutButtonInTray
. انقر على "إظهار مثال" أدناه للاطّلاع على كيفية تمثيل واجهة برمجة تطبيقات Schema Service API لهذا الإعداد.
عرض مثال
{ "name": "customers/C0202nabg/policySchemas/chrome.users.ShowLogoutButton", "policyDescription": "Show logout button in tray.", // description of the policy "definition": { // definition of the settings (fields names and types) "messageType": [ { "name": "ShowLogoutButton", "field": [ { "name": "showLogoutButtonInTray", // the setting showLogoutButtonInTray "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" // the setting showLogoutButtonInTray is of type boolean } ] } ] }, "fieldDescriptions": [ // human readable descriptions of the settings and their values { "field": "showLogoutButtonInTray", "knownValueDescriptions": [ { "value": "true", "description": "Show logout button in tray." // description for showLogoutButtonInTray=true }, { "value": "false", "description": "Do not show logout button in tray." // description for showLogoutButtonInTray=false } ] } ], "schemaName": "chrome.users.ShowLogoutButton" // unique name to identify the policy }
أسماء مخطّط السياسات
يُعد name
للمخطط معرّفه الفريد بالتنسيق التالي: {namespace}.{leafName}
.
في المثال أعلاه، يكون اسم المخطط الكامل هو chrome.users.ShowLogoutButton
.
مساحة الاسم هي chrome.users.
واسم ورقة الشجر هو ShowLogoutButton
.
يتم تجميع سياسات النطاق المماثل ضمن مساحة الاسم نفسها. على سبيل المثال، تكون جميع مخططات سياسات المستخدمين بادئة بمساحة اسم chrome.users.
، وجميع مخططات سياسات الطابعات تبدأ بمساحة اسم chrome.printers.
.
مساحات الاسم
مساحة الاسم | المفتاح | إذن دور المشرف المطلوب |
---|---|---|
chrome.users.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين > إدارة إعدادات التطبيقات |
chrome.users.appsconfig.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين > إدارة إعدادات التطبيقات | |
chrome.devices.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS | |
chrome.devices.managedguest.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS |
chrome.devices.kiosk.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS | |
chrome.printers.LEAF_NAME |
key="printer_id" |
الخدمات > إدارة Chrome > الإعدادات > إدارة الطابعات |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
الخدمات > إدارة Chrome > الإعدادات > إدارة الطابعات |
chrome.networks.globalsettings.LEAF_NAME |
الخدمات > إعدادات الأجهزة المشتركة | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
الخدمات > إعدادات الأجهزة المشتركة |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
الخدمات > إعدادات الأجهزة المشتركة |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
الخدمات > إعدادات الأجهزة المشتركة |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
الخدمات > إعدادات الأجهزة المشتركة |
مفاتيح مخطّط السياسة
تتطلّب بعض السياسات عرض سياق إضافي أو تعديله. مثلاً:
- لتعديل سياسة أحد التطبيقات، عليك تحديد التطبيق من خلال تعبئة
key="app_id"
. - لتعديل سياسة إعدادات الطابعة في وحدة تنظيمية، عليك تحديد الطابعة من خلال تعبئة
key="printer_id"
.
تتضمّن مخططات السياسات هذه قسم additionalTargetKeyNames
يصف المفاتيح والقيم المطلوب ضبطها في طلبات البيانات من واجهة برمجة التطبيقات.
لمزيد من التفاصيل، انتقِل إلى عيّنات التعليمات البرمجية.
عرض مثال
{ "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers", "policyDescription": "Allows a printer for users in a given organization.", "additionalTargetKeyNames": [ { "key": "printer_id", "keyDescription": "Id of printer as visible in Admin SDK printers API." } ], "definition": { "messageType": [ { "name": "AllowForUsers", "field": [ { "name": "allowForUsers", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "allowForUsers", "description": "Controls whether a printer is allowed for users in a given organization." } ], "schemaName": "chrome.printers.AllowForUsers" }
سياسات التطبيقات
بعض مساحات الاسم أعلاه مخصّصة لسياسات التطبيقات، مثل "تطبيقات المستخدم"، و"تطبيقات Kiosk"،
وتطبيقات جلسات الضيوف المُدارة، وسياسات إعداد تطبيقات Kiosk. تتطلب سياسات التطبيقات
إضافة app_id
.
يتم إنشاء app_id
من خلال الجمع بين نوع التطبيق ومعرّفه. مثلاً:
- يمثل
chrome:mkaakpdehdafacodkgkpghoibnmamcme
تطبيق Chrome "رسومات Google" - يمثّل
android:com.google.android.calendar
تطبيق "تقويم Google" المتوافق مع Android. - يمثّل "
web:https://canvas.apps.chrome
" تطبيق الويب "لوحة الرسم".
الحقول متعددة القيم
تمثّل الحقول التي تحمل التصنيف LABEL_REPEATED
حقولاً متعددة القيم، مثل القوائم أو الصفائف. يمكنك تحديد عدة قيم لهذه الحقول. لمزيد من التفاصيل، يُرجى الاطّلاع على
عيّنات التعليمات البرمجية.
حالة مخطّط السياسة
تتضمّن كل سياسة عنصر policyApiLifecycle
لتمثيل حالتها الحالية.
يحتوي هذا الكائن على الحقول التالية مع تفاصيل حالة السياسة:
- يعرض الحقل
policyApiLifecycleStage
أي من المراحل الواردة في الجدول التالي تصف الحالة الراهنة للسياسة على أفضل وجه. - يقدّم الحقل
description
المزيد من التفاصيل حول الحالة الحالية لهذه السياسة. - يعرض الحقل
endSupport
التاريخ النهائي لدعم السياسة، في حال تحديد تاريخ. - لا يمكن ضبط
deprecatedInFavorOf
إلا إذا كانت policyApiLifecycleStage API_DEPRECATED. يعرض مساحات الاسم المؤهلة بالكامل للسياسات الجديدة التي تم إيقاف السياسة الحالية لصالحها. - يتجاوب حقل
scheduledToDeprecatePolicies
مع deprecatedInFavorOf. يعرض هذا الدليل مساحات الاسم المؤهّلة بالكامل للسياسات القديمة والتي سيتم إيقافها بسبب طرح هذه السياسة.
مراحل دورة الحياة
مسرح | الوصف |
---|---|
API_UNSPECIFIED |
الحالة الحالية للسياسة غير معروفة. محجوزة، لا تستخدمها. |
API_PREVIEW |
لا تعمل السياسة بعد. يمكن نقل هذه المرحلة إلى API_CURRENT أو API_DEVELOPMENT . |
API_DEVELOPMENT |
لم يتم وضع اللمسات الأخيرة على السياسة بعد، وقد يتم إدخال تغييرات قد تؤدي إلى أعطال. يمكن نقل هذه المرحلة إلى API_CURRENT أو API_DEPRECATED . |
API_CURRENT |
تم وضع السياسة بتنسيق رسمي، ولكن قد يتم إجراء تغييرات غير متوقعة. يمكن تحويل هذه المرحلة إلى API_DEPRECATED . |
API_DEPRECATED |
تم إيقاف هذه السياسة نهائيًا وقد تتم إزالتها في المستقبل. على المشرفين التوقف عن استخدام هذه السياسة. |
عرض مثال
{ "name": "customers/C0202nabg/policySchemas/chrome.users.OutdatedPolicy", "policyDescription": "Just for demo, this is an outdated policy.", "definition": { "messageType": [ { "name": "OutdatedPolicy", "field": [ { "name": "outdatedField", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "outdatedField", "description": "This is an outdated field" } ], "schemaName": "chrome.users.OutdatedPolicy", "policyApiLifecycle": { // policy's current lifecycle status "policyApiLifecycleStage": "API_DEPRECATED", "description": "This policy is deprecated. Please stop using it", "endSupport": { "year": 2021, "month": 2, "day": 29 } "deprecatedInFavorOf": "chrome.users.NewPolicy" } } { "name": "customers/C0202nabg/policySchemas/chrome.users.NewPolicy", "policyDescription": "Just for demo, this is a new policy.", "definition": { "messageType": [ { "name": "NewPolicy", "field": [ { "name": "newField", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "newField", "description": "This is an new field" } ], "schemaName": "chrome.users.NewPolicy", "policyApiLifecycle": { // policy's current lifecycle status "policyApiLifecycleStage": "API_CURRENT, "scheduledToDeprecatePolicies": "chrome.users.OutdatedPolicy" } }
إشعارات مخطط السياسة
تتضمّن بعض السياسات notices
مرتبطة بها تم ضبط acknowledgement_required
على true
لقيم معيّنة من حقول سياسات معيّنة. بالنسبة إلى هذه السياسات،
يجب ضبط حقل إقرار خاص على true
قبل أن تتمكّن من ضبط
القيمة.
لمزيد من التفاصيل، يُرجى الاطّلاع على عيّنات التعليمات البرمجية.
المنصّات المعتمدة
وsupportedPlatforms
هي قائمة تشير إلى أنّ السياسة لن تسري
إلا على الأجهزة أو المستخدمين على هذه الأنظمة الأساسية. يتم إدراج جميع الأنظمة الأساسية المتوافقة في الجدول التالي
النظام الأساسي المتوافق
النظام الأساسي | الوصف |
---|---|
PLATFORM_UNSPECIFIED |
منصة غير محدّدة محجوزة، لا تستخدمها. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
متصفّح Chrome لنظام التشغيل macOS/Windows/Linux |
CHROME_BROWSER_FOR_ANDROID |
متصفح Chrome لنظام التشغيل Android |
CHROME_BROWSER_FOR_IOS |
متصفح Chrome لنظام التشغيل iOS |