নীতি স্কিমা

Chrome নীতিগুলি স্কিমা পরিষেবা API দ্বারা নীতি স্কিমা হিসাবে উপস্থাপন করা হয়৷ প্রতিটি নীতি স্কিমার এটি সনাক্ত করার জন্য একটি অনন্য নাম রয়েছে, ক্ষেত্র এবং তাদের প্রকার নির্ধারণের একটি সংজ্ঞা এবং ইংরেজিতে সেটিংসের একটি মানব পাঠযোগ্য বর্ণনা রয়েছে।

উদাহরণ স্বরূপ, নিচে দেওয়া হল কিভাবে স্কিমা সার্ভিস API একটি সেটিং উপস্থাপন করে যা Chrome এর সিস্টেম ট্রেতে একটি সাইন আউট বোতাম উপস্থিত হতে দেয়৷ এই সেটিংটির একটি সরলীকৃত উপস্থাপনা হবে bool showLogoutButtonInTray । স্কিমা পরিষেবা 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.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 বিভাগ রয়েছে যা আপনার API অনুরোধগুলিতে পাস করা কী এবং মানগুলি বর্ণনা করে৷

আরও বিস্তারিত জানার জন্য, কোড নমুনাগুলিতে যান।

একটি উদাহরণ দেখান

{
  "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 ক্যালেন্ডার" Android অ্যাপের প্রতিনিধিত্ব করে
  • web:https://canvas.apps.chrome "ক্যানভাস" ওয়েব অ্যাপের প্রতিনিধিত্ব করে

বহু-মান ক্ষেত্র

LABEL_REPEATED লেবেল সহ ক্ষেত্রগুলি বহু-মানের ক্ষেত্রগুলিকে উপস্থাপন করে, যেমন তালিকা বা অ্যারে৷ আপনি এই ক্ষেত্রগুলিতে বেশ কয়েকটি মান দিতে পারেন। আরও বিশদ বিবরণের জন্য, কোডের নমুনাগুলি দেখুন।

পলিসি স্কিমার স্থিতি

প্রতিটি নীতির বর্তমান অবস্থা উপস্থাপন করার জন্য একটি policyApiLifecycle অবজেক্ট থাকে। এই অবজেক্টে নীতির স্থিতি সম্পর্কে বিশদ বিবরণ সহ নিম্নলিখিত ক্ষেত্র রয়েছে:

  • policyApiLifecycleStage ক্ষেত্রটি দেখায় যে নিম্নলিখিত সারণীর কোন ধাপটি নীতির বর্তমান অবস্থা সবচেয়ে ভালোভাবে বর্ণনা করে।
  • description ক্ষেত্র এই নীতির বর্তমান অবস্থা সম্পর্কে আরো বিস্তারিত দেয়।
  • endSupport ক্ষেত্র নীতির জন্য চূড়ান্ত সমর্থন তারিখ দেখায়, যদি একটি সংজ্ঞায়িত করা হয়।
  • নীতি ApiLifecycleStage API_DEPRECATED হলেই deprecatedInFavorOf সেট করা যাবে৷ এটি নতুন নীতিগুলির সম্পূর্ণরূপে যোগ্য নামস্থান(গুলি) দেখায় যেগুলির পক্ষে বর্তমান নীতি অবমূল্যায়িত হয়েছে৷
  • 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 রয়েছে যেগুলি নির্দিষ্ট নীতির ক্ষেত্রের নির্দিষ্ট মানগুলির জন্য true হিসাবে acknowledgement_required সেট করেছে৷ এই নীতিগুলির জন্য, মান সেট করার আগে আপনাকে একটি বিশেষ স্বীকৃতি ক্ষেত্র true সেট করতে হবে।

আরো বিস্তারিত জানার জন্য, কোড নমুনা দেখুন।

সমর্থিত প্ল্যাটফর্ম

supportedPlatforms হল একটি তালিকা যা নির্দেশ করে যে নীতি শুধুমাত্র এই প্ল্যাটফর্মের ডিভাইস বা ব্যবহারকারীদের জন্য প্রযোজ্য হবে। সমস্ত সমর্থিত প্ল্যাটফর্মগুলি নিম্নলিখিত টেবিলে তালিকাভুক্ত করা হয়েছে।

সমর্থিত প্ল্যাটফর্ম

প্ল্যাটফর্ম বর্ণনা
PLATFORM_UNSPECIFIED অনির্দিষ্ট প্ল্যাটফর্ম। সংরক্ষিত, ব্যবহার করবেন না।
CHROME_OS ChromeOS
CHROME_BROWSER MacOS/Windows/Linux-এর জন্য Chrome ব্রাউজার
CHROME_BROWSER_FOR_ANDROID অ্যান্ড্রয়েডের জন্য ক্রোম ব্রাউজার
CHROME_BROWSER_FOR_IOS iOS এর জন্য ক্রোম ব্রাউজার

পরবর্তী পদক্ষেপ