مخططات السياسات

يتم تمثيل سياسات 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

الخطوات التالية