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

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

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

• تفعيل واجهة برمجة تطبيقات سياسة Chrome وتفويض الطلبات
• إدراج مخططات السياسات باستخدام واجهة برمجة التطبيقات