কোড নমুনা

নীচের অনুরোধগুলি পলিসি API-এর সাথে নীতি ব্যবস্থাপনার চিত্র তুলে ধরে। আপনি শুরু করার আগে, নিশ্চিত করুন যে আপনি এই API-এর বৈশিষ্ট্যগুলির একটি উচ্চ-স্তরের সারাংশের জন্য Chrome নীতি API ওভারভিউ পর্যালোচনা করেছেন৷

নীচে উপস্থাপিত সমস্ত অনুরোধ নিম্নলিখিত ভেরিয়েবল ব্যবহার করে:

  • $TOKEN - OAuth 2 টোকেন
  • $CUSTOMER - গ্রাহকের আইডি বা আক্ষরিক my_customer

প্রিন্টার নীতির জন্য স্কিম তালিকা করুন

স্কিমা তালিকাভুক্ত করতে যেগুলি শুধুমাত্র প্রিন্টারগুলির জন্য নীতিগুলির জন্য, আমরা স্কিমা পরিষেবা তালিকা অনুরোধে filter প্যারামিটার প্রয়োগ করব৷ আপনি pageSize এবং pageToken প্যারামিটার ব্যবহার করে ফলাফলের পৃষ্ঠা সংখ্যা নিয়ন্ত্রণ করতে পারেন।

অনুরোধ

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas?filter=chrome.printers&pageSize=2"

প্রতিক্রিয়া

{
  "policySchemas": [
    {
      "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"
    },
    {
      "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForDevices",
      "policyDescription": "Allows a printer for devices in a given organization.",
      "additionalTargetKeyNames": [
        {
          "key": "printer_id",
          "keyDescription": "Id of printer as visible in Admin SDK printers API."
        }
      ],
      "definition": {
        "messageType": [
          {
            "name": "AllowForDevices",
            "field": [
              {
                "name": "allowForDevices",
                "number": 1,
                "label": "LABEL_OPTIONAL",
                "type": "TYPE_BOOL"
              }
            ]
          }
        ]
      },
      "fieldDescriptions": [
        {
          "field": "allowForDevices",
          "description": "Controls whether a printer is allowed for devices in a given organization."
        }
      ],
      "schemaName": "chrome.printers.AllowForDevices"
    }
  ],
  "nextPageToken": "AEbDN_obE8A98T8YhIeU9VCIZhEBylLBwZRQpGu_DUug-mU4bnzcDx30UnO2xMuuImvfVpmeuXRF6VhJ4OmZpZ4H6EaRvu2qMOPxVN_u"
}

স্কিমা অনুসন্ধান করুন

আপনি স্কিমা পরিষেবা তালিকা অনুরোধে filter= প্যারামিটার ব্যবহার করে জটিল অনুসন্ধান প্রশ্ন তৈরি করতে পারেন। উদাহরণস্বরূপ, আপনি যদি এমন স্কিমাগুলি অনুসন্ধান করতে চান যেগুলির নামের মধ্যে "প্রিন্টার" এবং বিবরণে "ডিভাইস" শব্দটি রয়েছে আপনি ফিল্টার name=printers AND description=devices নিম্নলিখিত মান প্রয়োগ করতে পারেন।

পলিসি স্কিমাগুলি কীভাবে তালিকাভুক্ত করবেন তা শিখুন।

অনুরোধ

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas?filter=name=printers%20AND%20description=devices"

প্রতিক্রিয়া

{
  "policySchemas": [
    {
      "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForDevices",
      "policyDescription": "Allows a printer for devices in a given organization.",
      "additionalTargetKeyNames": [
        {
          "key": "printer_id",
          "keyDescription": "Id of printer as visible in Admin SDK printers API."
        }
      ],
      "definition": {
        "messageType": [
          {
            "name": "AllowForDevices",
            "field": [
              {
                "name": "allowForDevices",
                "number": 1,
                "label": "LABEL_OPTIONAL",
                "type": "TYPE_BOOL"
              }
            ]
          }
        ]
      },
      "fieldDescriptions": [
        {
          "field": "allowForDevices",
          "description": "Controls whether a printer is allowed for devices in a given organization."
        }
      ],
      "schemaName": "chrome.printers.AllowForDevices"
    }
  ]
}

একটি নির্দিষ্ট স্কিমা পান

উপরের ফলাফলে, আমরা সমর্থিত নীতি স্কিমার একটি তালিকা দেখতে পাচ্ছি। প্রতিটি স্কিমার একটি name ক্ষেত্র থাকে যা স্কিমাকে চিহ্নিত করে। ভবিষ্যতে, একবার আপনি স্কিমার নাম জানলে, আপনি অনুরোধ URL-এ স্কিমার নাম উল্লেখ করে সরাসরি নির্দিষ্ট স্কিমা পড়তে পারেন।

আসুন chrome.printers.AllowForUsers স্কিমার একটি উদাহরণ দেখি।

অনুরোধ

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policySchemas/chrome.printers.AllowForUsers"

প্রতিক্রিয়া

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

উপরের নীতি স্কিমার প্রতিক্রিয়া chrome.printers.AllowForUsers নীতির স্কিমা বর্ণনা করে৷ ক্ষেত্র additionalTargetKeyNames নোটিশ করুন। এই ক্ষেত্রটি ব্যাখ্যা করে যে এই নীতির সাথে কাজ করার সময় নীতির জন্য অতিরিক্ত কী/মান সরবরাহ করতে হবে। বিশেষ করে, এই নীতির জন্য আমাদের সর্বদা একটি প্রিন্টারের শনাক্তকারী প্রদান করতে হবে।

একটি নীতি মান পড়ুন

আসুন একটি নির্দিষ্ট প্রিন্টারের জন্য একটি নীতি chrome.printers.AllowForUsers পড়ি। অনুরোধে প্রিন্টার আইডি নির্দিষ্ট করতে ক্ষেত্র additionalTargetKeys ব্যবহার করে লক্ষ্য করুন।

আপনি একটি সাংগঠনিক ইউনিট বা একটি গ্রুপ থেকে একটি নীতি পড়তে পারেন.

প্রতিক্রিয়ায়, sourceKey ক্ষেত্রটি লক্ষ্য করুন, যা নির্দিষ্ট করে কোন সাংগঠনিক ইউনিট বা গ্রুপ থেকে নীতির মান এসেছে। সাংগঠনিক ইউনিটগুলির জন্য, নিম্নলিখিত সম্ভাবনা রয়েছে:

  • সোর্স অর্গানাইজেশনাল ইউনিট যদি অনুরোধে দেওয়া সাংগঠনিক ইউনিটের মতো হয়, তাহলে এর অর্থ হল এই সাংগঠনিক ইউনিটে নীতি স্থানীয়ভাবে প্রয়োগ করা হয়েছে।
  • সোর্স অর্গানাইজেশনাল ইউনিট যদি অনুরোধে দেওয়া সাংগঠনিক ইউনিটের থেকে আলাদা হয়, তাহলে এর অর্থ হল পলিসিটি উৎস সাংগঠনিক ইউনিট থেকে উত্তরাধিকারসূত্রে প্রাপ্ত।
  • যদি কোন sourceKey উপস্থিত না থাকে, বা প্রতিক্রিয়া খালি থাকে, তাহলে এর অর্থ হল নীতিটি গ্রাহকের জন্য সেট করা নেই এবং এটির ডিফল্ট সিস্টেম মান রয়েছে৷

গ্রুপগুলির জন্য, সোর্সকি সর্বদা অনুরোধে নির্দিষ্ট করা গ্রুপের মতোই হবে৷

নিম্নলিখিত উদাহরণটি একটি সাংগঠনিক ইউনিটের জন্য। টার্গেট রিসোর্স ব্যতীত একটি গ্রুপের অনুরোধ একই হবে, যার আইডির আগে "অর্গুনিট/" এর পরিবর্তে "গ্রুপ/" থাকবে।

অনুরোধ

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
        },
        policySchemaFilter: "chrome.printers.AllowForDevices"
    }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies:resolve"

প্রতিক্রিয়া

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/03ph8a2z1xdnme9"
        "additionalTargetKeys": {"printer_id":"0gjdgxs208tpef"}
      },
      "value": {
        "policySchema": "chrome.users.AllowForDevices",
        "value": {
          "allowForDevices": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/03ph8a2z3qhz81k"
      }
    }
  ]
}

নোট করুন যে অনুরোধ থেকে additionalTargetKeys বাদ দিয়ে লক্ষ্য সম্পদের সমস্ত সত্তা আনা যেতে পারে। উদাহরণস্বরূপ, যদি উপরের অনুরোধ থেকে additionalTargetKeys বাদ দেওয়া হয়, তবে এটি নির্দিষ্ট লক্ষ্য সংস্থানে সমস্ত প্রিন্টার ফিরিয়ে দেবে।

একাধিক নীতি পড়ুন

একটি তারকাচিহ্ন (যেমন, chrome.printers.* ) সহ একটি স্কিমা নামস্থান প্রদান করা আপনাকে একটি নির্দিষ্ট সাংগঠনিক ইউনিট বা গোষ্ঠীতে এই নামস্থানের অধীনে সমস্ত নীতির মান পড়তে দেয়৷ পলিসি স্কিমা সম্পর্কে আরও জানুন।

নিম্নলিখিত উদাহরণটি একটি সাংগঠনিক ইউনিটের জন্য। টার্গেট রিসোর্স ব্যতীত একটি গ্রুপের অনুরোধ একই হবে, যার আইডির আগে "অর্গুনিট/" এর পরিবর্তে "গ্রুপ/" থাকবে।

অনুরোধ

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
        },
        policySchemaFilter: "chrome.printers.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies:resolve"

প্রতিক্রিয়া

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "printer_id": "0gjdgxs0xd59y1"
        }
      },
      "value": {
        "policySchema": "chrome.printers.AllowForUsers",
        "value": {
          "allowForUsers": false
        }
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "printer_id": "0gjdgxs0xd59y1"
        }
      },
      "value": {
        "policySchema": "chrome.printers.AllowForDevices",
        "value": {
          "allowForDevices": false
        }
      }
    },
    //...
  ],
  "nextPageToken": "AEbDN_pFvDeGSbQDkvMxr4UA0Ew7UEUw8aJyw95VPs2en6YxMmFcWQ9OQQEIeSkjnWFCQNyz5GGoOKQGEd50e2z6WqvM2w7sQz6TMxVOBD_4NmEHRWtIJCYymeYXWHIrNH29Ezl1wkeyYBAOKnE="
}

নীতির মান পরিবর্তন করুন

পলিসি স্কিমা রেসপন্সে যেমন দেখা যায়, পলিসি chrome.printers.AllowForUsers একটি ক্ষেত্র আছে যার নাম allowForUsers । এই ক্ষেত্রটি একটি বুলিয়ান টাইপের। নীতির উদাহরণ মান {allowForUsers: false} বা {allowForUsers: true} হতে পারে। এই বিশেষ ক্ষেত্রে, আমাদের শুধুমাত্র একটি ক্ষেত্র আছে, তবে অন্যান্য নীতিতে একাধিক ক্ষেত্র থাকতে পারে।

সংশোধনের অনুরোধে, আমাদের একটি updateMask নির্দিষ্ট করতে হবে। হালনাগাদ মাস্ক আমরা পরিবর্তন করতে চাই এমন সমস্ত ক্ষেত্র তালিকাভুক্ত করে। যদি নীতিটি ইতিমধ্যেই স্থানীয়ভাবে সাংগঠনিক ইউনিটে প্রয়োগ করা হয়, তাহলে আপডেট মাস্কের মাধ্যমে তালিকাভুক্ত নয় এমন ক্ষেত্রগুলি অস্পর্শ্য থাকবে। যদি নীতিটি ইতিমধ্যে সাংগঠনিক ইউনিটে স্থানীয়ভাবে প্রয়োগ করা না হয়, এবং আপডেট মাস্কের মাধ্যমে তালিকাভুক্ত নয় এমন সমস্ত ক্ষেত্র উপযুক্ত হলে মূল সাংগঠনিক ইউনিট থেকে তাদের মানগুলি অনুলিপি করবে এবং পুরো নীতি স্থানীয়ভাবে প্রয়োগ করা হবে।

নিম্নলিখিত উদাহরণগুলি একটি সাংগঠনিক ইউনিটের জন্য। টার্গেট রিসোর্স ব্যতীত গ্রুপের অনুরোধগুলি একই, যেগুলির আইডির আগে "অর্গুনিট/" এর পরিবর্তে "গ্রুপ/" থাকবে। এখানে আমরা সাংগঠনিক ইউনিট আইডি 04fatzly4jbjho9 ব্যবহারকারীদের জন্য একটি প্রিন্টার 0gjdgxs208tpef অস্বীকৃতি জানাব:

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForUsers",
                        value: {allowForUsers: false}
                        },
                updateMask: {paths: "allowForUsers"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

তালিকা বা অ্যারের মতো বহু-মূল্য ক্ষেত্রগুলিকে একটি "LABEL_REPEATED" লেবেল দিয়ে চিহ্নিত করা হয়েছে৷ বহু-মূল্য ক্ষেত্রগুলি পূরণ করতে, নিম্নলিখিত JSON অ্যারে বিন্যাসটি ব্যবহার করুন: [value1, value2, value3, ...]

উদাহরণস্বরূপ, "test1.com", "test2.com" এবং "test3.com" হিসাবে অ্যাপ এবং এক্সটেনশন প্যাকেজের জন্য উত্স url সেট করতে, আমাদের নিম্নলিখিত অনুরোধ পাঠাতে হবে:

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
        requests: [
          {
            policy_target_key: {
              target_resource: 'orgunits/03ph8a2z28rz85a'
            },
            updateMask: {
              paths: ['extensionInstallSources']
            },
            policy_value: {
              policy_schema: 'chrome.users.appsconfig.AppExtensionInstallSources', 
              value: {
                extensionInstallSources: ['test1.com', 'test2.com', 'test3.com']
              }
            }
          }
        ]
      }" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

NullableDuration ক্ষেত্র রয়েছে এমন সমস্ত নীতির জন্য দুটি সংস্করণ রয়েছে। মূল সংস্করণ শুধুমাত্র NullableDuration-এর জন্য ইনপুট হিসাবে স্ট্রিং গ্রহণ করে এবং এখন অবচয়। অনুগ্রহ করে V2 সংস্করণ ব্যবহার করুন যা একটি সংখ্যাসূচক ইনপুট দিয়ে সময়কালের ধরন প্রতিস্থাপন করে। উদাহরণস্বরূপ, সর্বাধিক ব্যবহারকারীর সেশনের দৈর্ঘ্য 10 মিনিট হিসাবে সেট করতে আমাদের নিম্নলিখিত অনুরোধ পাঠাতে হবে:

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
        requests: [
          {
            policy_target_key: {
              target_resource: 'orgunits/03ph8a2z28rz85a'
            },
            updateMask: {
              paths: ['sessionDurationLimit']
            },
            policy_value: {
              policy_schema: 'chrome.users.SessionLengthV2',
              value: {
                sessionDurationLimit: {
                  duration: 10
                }
              }
            }
          }
        ]
      }" \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

একবারে একাধিক নীতি পরিবর্তন করুন

batchModify পদ্ধতি আপনাকে একই সময়ে একাধিক নীতি পরিবর্তন পাঠাতে দেয়। যাইহোক, সব নীতি একসাথে ব্যাচ করা যাবে না. আরও বিশদ বিবরণের জন্য, ব্যাচ আপডেট নীতিগুলি দেখুন।

এই উদাহরণে আমরা একই অনুরোধে, একই প্রিন্টারের জন্য দুটি ভিন্ন নীতি ( chrome.printers.AllowForDevices এবং chrome.printers.AllowForUsers ) পরিবর্তন করব৷

নিম্নলিখিত উদাহরণটি একটি সাংগঠনিক ইউনিটের জন্য। টার্গেট রিসোর্স ব্যতীত একটি গ্রুপের অনুরোধ একই হবে, যার আইডির আগে "অর্গুনিট/" এর পরিবর্তে "গ্রুপ/" থাকবে।

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForDevices",
                        value: {allowForDevices: true}
                        },
                updateMask: {paths: "allowForDevices"}
                },
                {
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policyValue: {
                        policySchema: "chrome.printers.AllowForUsers",
                        value: {allowForUsers: true}
                        },
                updateMask: {paths: "allowForUsers"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/C0202nabg/policies/orgunits:batchModify"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

একটি সাংগঠনিক ইউনিটে একটি নীতির মান উত্তরাধিকারসূত্রে প্রাপ্ত করুন৷

batchInherit পদ্ধতি আপনাকে একটি সাংগঠনিক ইউনিটে নীতির স্থিতিকে "স্থানীয়ভাবে প্রয়োগ করা" থেকে "উত্তরাধিকারসূত্রে" পরিবর্তন করতে দেয়। স্থানীয় মানগুলি সাফ করা হবে এবং নীতিটি প্রযোজ্য হলে একটি অভিভাবক সাংগঠনিক ইউনিট থেকে মানগুলিকে উত্তরাধিকার সূত্রে প্রাপ্ত করবে৷

batchInherit পদ্ধতি আপনাকে একই সময়ে একাধিক পলিসি ইনহেরিট অনুরোধ পাঠাতে দেয়। যাইহোক, সব নীতি একসাথে ব্যাচ করা যাবে না. আরও বিশদ বিবরণের জন্য, ব্যাচ আপডেট নীতিগুলি দেখুন।

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly12wd3ox",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policySchema: "chrome.printers.AllowForUsers"
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchInherit"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

একটি গ্রুপে একটি নীতি মান মুছুন

batchDelete পদ্ধতি আপনাকে একটি গ্রুপ থেকে একটি নীতি মুছে ফেলার অনুমতি দেয়। স্থানীয় মান সাফ করা হবে।

batchDelete পদ্ধতি আপনাকে একই সময়ে একাধিক নীতি মুছে ফেলার অনুরোধ পাঠাতে দেয়। যাইহোক, সব নীতি একসাথে ব্যাচ করা যাবে না. আরও বিশদ বিবরণের জন্য, ব্যাচ আপডেট নীতিগুলি দেখুন।

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "groups/04fatzly12wd3ox",
                        additionalTargetKeys: {"printer_id":"0gjdgxs208tpef"}
                        },
                policySchema: "chrome.printers.AllowForUsers"
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:batchDelete"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

একটি গ্রুপের জন্য অগ্রাধিকার ক্রম তালিকাভুক্ত করুন

listGroupPriorityOrdering পদ্ধতি আপনাকে একটি অ্যাপের জন্য গ্রুপের অগ্রাধিকার ক্রম তালিকাভুক্ত করতে দেয়।

যে গ্রুপ আইডিগুলি ফেরত দেওয়া হয়েছে তার ক্রম নির্দেশ করে যে অগ্রাধিকারে তাদের সেটিংস অ্যাপের জন্য প্রয়োগ করা হবে; পরবর্তী আইডির নীতিগুলি সেই নীতিগুলি দ্বারা ওভাররাইড করা হবে যাদের আইডিগুলি তালিকায় আগে আছে৷

মনে রাখবেন যে গ্রুপের অগ্রাধিকারগুলি সাংগঠনিক ইউনিট অগ্রাধিকারের চেয়ে বেশি।

এই অনুরোধে, আমরা "exampleapp" Chrome ব্যবহারকারী অ্যাপের জন্য অগ্রাধিকার ক্রম ফেরত দিচ্ছি।

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
                additionalTargetKeys: {"app_id":"chrome:exampleapp"}
                },
        policyNamespace: 'chrome.users.apps'
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:listGroupPriorityOrdering"

প্রতিক্রিয়া

{
  "policyTargetKey": {
    "additionalTargetKeys": {
      "app_id": "chrome:exampleapp"
    }
  },
  "policyNamespace": "chrome.users.apps",
  "groupIds": [
    "03ep43zb2k1nodu",
    "01t3h5sf2k52kol",
    "03q5sasy2ihwnlz"
  ]
}

একটি গ্রুপের জন্য অগ্রাধিকার অর্ডার আপডেট করুন

updateGroupPriorityOrdering পদ্ধতি আপনাকে একটি অ্যাপের জন্য গ্রুপের অগ্রাধিকার ক্রম আপডেট করতে দেয়।

অনুরোধে গ্রুপ আইডিগুলির ক্রম নির্দেশ করে যে অগ্রাধিকারে তাদের সেটিংস অ্যাপের জন্য প্রয়োগ করা হবে; পরবর্তী আইডির নীতিগুলি সেই নীতিগুলি দ্বারা ওভাররাইড করা হবে যাদের আইডিগুলি তালিকায় আগে আছে৷ অনুরোধে অবশ্যই অ্যাপে প্রয়োগ করা প্রতিটি গ্রুপ আইডি অন্তর্ভুক্ত করতে হবে।

মনে রাখবেন যে গ্রুপের অগ্রাধিকারগুলি সাংগঠনিক ইউনিট অগ্রাধিকারের চেয়ে বেশি।

এই অনুরোধে, আমরা "exampleapp" Chrome ব্যবহারকারী অ্যাপের জন্য অগ্রাধিকার ক্রম নির্ধারণ করছি।

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
                additionalTargetKeys: {"app_id":"chrome:exampleapp"}
                },
        policyNamespace: 'chrome.users.apps',
        groupIds: ['03ep43zb2k1nodu', '01t3h5sf2k52kol', '03q5sasy2ihwnlz']
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/groups:updateGroupPriorityOrdering"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি।

{}

হ্যান্ডলিং নীতি যে স্বীকৃতি প্রয়োজন

কিছু নীতি স্কিমা একটি নির্দিষ্ট ক্ষেত্রের নির্দিষ্ট মানগুলির জন্য 'বিজ্ঞপ্তি' নির্দিষ্ট করে যার স্বীকৃতি প্রয়োজন।

নীতির উদাহরণ chrome.users.PluginVmAllowd :

{
  "name": "customers/C0202nabg/policySchemas/chrome.users.PluginVmAllowed",
  "policyDescription": "Parallels Desktop.",
  # ...
  "fieldDescriptions": [
    {
      "field": "pluginVmAllowed",
      "description": "N/A",
      "knownValueDescriptions": [
        {
          "value": "true",
          "description": "Allow users to use Parallels Desktop."
        },
        {
          "value": "false",
          "description": "Do not allow users to use Parallels Desktop."
        }
      ]
    },
    {
      "field": "ackNoticeForPluginVmAllowedSetToTrue",
      "description": "This field must be set to true to acknowledge the notice message associated with the field 'plugin_vm_allowed' set to value 'true'. Please see the notices listed with this policy for more information."
    }
  ],
  "notices": [
    {
      "field": "pluginVmAllowed",
      "noticeValue": "true",
      "noticeMessage": "By enabling Parallels Desktop, you agree to the Parallels End-User License Agreement specified at https://www.parallels.com/about/legal/eula/. Warning: Device identifiers may be shared with Parallels. Please see privacy policy for more details at https://www.parallels.com/about/legal/privacy/. The minimum recommended configuration includes an i5 processor, 16 GB RAM, and 128 GB storage: https://support.google.com/chrome/a/answer/10044480.",
      "acknowledgementRequired": true
    }
  ],
  "supportUri": "...",
  "schemaName": "chrome.users.PluginVmAllowed"
}

উপরের উদাহরণে, ক্ষেত্র pluginVmAllowed এর মান true সেট করা একটি নোটিশের সাথে যুক্ত যার acknowledgementRequired আছে। এই ক্ষেত্রের মানটিকে সঠিকভাবে true সেট করতে, আপনাকে একটি অনুরোধ পাঠাতে হবে যা স্বীকারোক্তি ক্ষেত্রটি ackNoticeForPluginVmAllowedSetToTrue কে true নির্দিষ্ট করে, অন্যথায়, আপনি আপনার অনুরোধে একটি ত্রুটি পাবেন৷

এই উদাহরণে, আপনাকে নিম্নলিখিত ব্যাচ পরিবর্তনের অনুরোধ পাঠাতে হবে।

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
  'requests': [
    {
      'policyTargetKey': {
        'targetResource': 'orgunits/03ph8a2z10ybbh2'
      },
      'policyValue': {
        'policySchema': 'chrome.users.PluginVmAllowed',
        'value': {
          'pluginVmAllowed': true,
          'ackNoticeForPluginVmAllowedSetToTrue': true
        }
      },
      'updateMask': {
        'paths': [
          'pluginVmAllowed',
          'ackNoticeForPluginVmAllowedSetToTrue'
        ]
      }
    }
  ]
}" \
"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

ফাইল নীতি সেট করা

কিছু নীতিতে UploadedFile হিসাবে ক্ষেত্র টাইপ করা আছে, BatchModify অনুরোধে ব্যবহার করার জন্য একটি URL পাওয়ার জন্য আপনাকে API সার্ভারে সেই নীতিগুলির মান হিসাবে সেট করতে চান এমন ফাইল আপলোড করতে হবে৷

এই উদাহরণে আমরা একটি JPEG ফাইল আপলোড করে chrome.users.Wallpaper সেট করব।

ফাইলটি আপলোড করুন

অনুরোধ

curl -X POST \
  -H "Content-Type: image/jpeg" \
  -H "Authorization: Bearer $TOKEN" \
  -T "/path/to/the/file" \
  "https://chromepolicy.googleapis.com/upload/v1/customers/$CUSTOMER/policies/files:uploadPolicyFile?policy_field=chrome.users.Wallpaper.wallpaperImage"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়াতে ফাইল অ্যাক্সেস করার URL থাকা উচিত:

{
  "downloadUri": "https://storage.googleapis.com/chromeos-mgmt/0gjdgxs370bkl6/ChromeOsWallpaper/32ac50ab-b5ae-4bba-afa8-b6b443912897"
}

ফাইল নীতি সেট করুন

অনুরোধ

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        },
                policyValue: {
                        policySchema: "chrome.users.Wallpaper",
                        value: {
                          wallpaperImage: {downloadUri: "https://storage.googleapis.com/chromeos-mgmt/0gjdgxs370bkl6/ChromeOsWallpaper/32ac50ab-b5ae-4bba-afa8-b6b443912897"}
                          }
                        },
                updateMask: {paths: "wallpaperImage"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া খালি হওয়া উচিত।

{}