يتم تمثيل سياسات Chrome على أنّها مخطّطات السياسات من خلال Schema Service API. لكل مخطط سياسة اسم فريد لتعريفه، وتعريف للإعداد وأنواعها، ووصف سهل القراءة على الإعدادات في الإنجليزية.
على سبيل المثال، في ما يلي كيف تمثل واجهة برمجة التطبيقات Schema Service API إعدادًا
يسمح بظهور زر الخروج في لوحة نظام Chrome. صورة
سيكون تمثيلاً لهذا الإعداد bool showLogoutButtonInTray
. (يُرجى النقر.)
"إظهار مثال" أدناه لمعرفة كيف تمثل واجهة برمجة تطبيقات Schema Service هذا
الإعداد.
عرض مثال
{ "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
"رسومات Google". تطبيق Chrome - يمثّل
android:com.google.android.calendar
"تقويم Google". تطبيق Android - يمثّل
web:https://canvas.apps.chrome
"لوحة الرسم". تطبيق الويب
الحقول متعددة القيم
تمثّل الحقول التي تحمل التصنيف LABEL_REPEATED
حقولاً متعددة القيم، مثل القوائم.
أو الصفائف. يمكنك تحديد عدة قيم لهذه الحقول. لمزيد من التفاصيل، يُرجى مراجعة
عيّنات التعليمات البرمجية:
حالة مخطّط السياسة
تتضمّن كل سياسة عنصر policyApiLifecycle
لتمثيل حالتها الحالية.
يحتوي هذا العنصر على الحقول التالية مع تفاصيل عن السياسة
الحالة:
- يعرض الحقل
policyApiLifecycleStage
أيًا من المراحل التالية: يصف بشكل أفضل الحالة الراهنة للسياسة. - يقدّم الحقل
description
المزيد من التفاصيل حول الحالة الحالية لهذه السياسة. - يعرض الحقل
endSupport
التاريخ النهائي لدعم السياسة، في حال توفّره. شجرة القرارات. - لا يمكن ضبط
deprecatedInFavorOf
إلا في حال ضبط policyApiLifecycleStage. API_DEPRECATED. تعرض مساحات الاسم المؤهلة بالكامل للسياسات الجديدة إيقاف السياسة الحالية لصالحها - يتجاوب الحقل
scheduledToDeprecatePolicies
مع موقوفةInFavorOf. يعرض هذا القسم مساحات الاسم المؤهلة بالكامل السياسات التي سيتم إيقافها بسبب إدخال هذه السياسة.
مراحل دورة الحياة
مسرح | الوصف |
---|---|
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 |