नीति के स्कीमा

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"
}
  

ऐप्लिकेशन की नीतियां

ऊपर दिए गए कुछ नेमस्पेस, ऐप्लिकेशन नीति के लिए हैं. जैसे, उपयोगकर्ता ऐप्लिकेशन, कीऑस्क ऐप्लिकेशन, मैनेज किए जा रहे गेस्ट सेशन ऐप्लिकेशन और कीऑस्क ऐप्लिकेशन कॉन्फ़िगरेशन से जुड़ी नीतियां. ऐप्लिकेशन की नीतियों का पालन करना ज़रूरी है app_id.

ऐप्लिकेशन टाइप और ऐप्लिकेशन आइडेंटिफ़ायर को जोड़कर app_id बनाया जाता है. उदाहरण के लिए:

• chrome:mkaakpdehdafacodkgkpghoibnmamcme "Google ड्रॉइंग" दिखाता है Chrome ऐप्लिकेशन
• android:com.google.android.calendar, "Google Calendar" को दिखाता है Android ऐप्लिकेशन
• web:https://canvas.apps.chrome से "कैनवस" का पता चलता है वेब ऐप्लिकेशन

एक से ज़्यादा वैल्यू वाले फ़ील्ड

LABEL_REPEATED लेबल वाले फ़ील्ड, सूचियों जैसे कई वैल्यू वाले फ़ील्ड को दिखाते हैं या अरे का इस्तेमाल करें. इन फ़ील्ड के लिए कई वैल्यू दी जा सकती हैं. ज़्यादा जानकारी के लिए, यह देखें कोड सैंपल.

नीति स्कीमा का स्टेटस

हर नीति का मौजूदा स्टेटस दिखाने के लिए, एक policyApiLifecycle ऑब्जेक्ट होता है. इस ऑब्जेक्ट में नीति की स्थिति:

• policyApiLifecycleStage फ़ील्ड की मदद से दिखाया जाता है कि इनमें से कौनसे स्टेज हैं टेबल में, नीति की मौजूदा स्थिति के बारे में सबसे सही जानकारी दी गई है.
• description फ़ील्ड में, इस नीति की मौजूदा स्थिति के बारे में ज़्यादा जानकारी मिलती है.
• अगर नीति से जुड़ी आखिरी तारीख तय की जा रही है, तो endSupport फ़ील्ड उसे दिखाता है परिभाषित है.
• deprecatedInFavorOf को सिर्फ़ तब सेट किया जा सकता है, जब policyApiलाइफ़साइकलस्टेज 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 पर एक खास सहमति फ़ील्ड सेट करना होगा. इसके बाद ही, वैल्यू.

ज़्यादा जानकारी के लिए, कोड सैंपल देखें.

डेटा डालने और 360 डिग्री में, वीडियो चलाने की सुविधा देने वाले प्लैटफ़ॉर्म

supportedPlatforms ऐसी सूची है जिससे पता चलता है कि यह नीति सिर्फ़ लागू होगी या इन प्लैटफ़ॉर्म के उपयोगकर्ताओं के लिए उपलब्ध है. इस सुविधा के साथ काम करने वाले सभी प्लैटफ़ॉर्म की जानकारी यहां दी गई टेबल में बताया गया है.

YouTube के साथ काम करने वाला प्लैटफ़ॉर्म

प्लैटफ़ॉर्म	ब्यौरा
PLATFORM_UNSPECIFIED	तय नहीं किया गया प्लैटफ़ॉर्म. रिज़र्व किया गया है, इसका इस्तेमाल न करें.
CHROME_OS	ChromeOS
CHROME_BROWSER	macOS/Windows/Linux के लिए Chrome ब्राउज़र
CHROME_BROWSER_FOR_ANDROID	Android के लिए Chrome ब्राउज़र
CHROME_BROWSER_FOR_IOS	iOS के लिए Chrome ब्राउज़र

अगले चरण

• Chrome Policy API चालू करना और अनुरोधों को अनुमति देना
• एपीआई की मदद से नीति के स्कीमा की सूची बनाना