نمونه‌های کد برای خط‌مشی‌های برنامه

درخواست‌های زیر مدیریت خط‌مشی را بااستفاده از Policy API با خط‌مشی‌های برنامه به‌عنوان نمونه نشان می‌دهند. قبل‌از شروع، حتماً نمای کلی Chrome Policy API و راهنمای طرح‌واره‌های خط‌مشی را مرور کنید.

همه درخواست‌های ارائه‌شده در زیر از متغیرهای زیر استفاده می‌کنند:

  • $TOKEN - کد OAuth 2
  • $CUSTOMER - شناسه مشتری یا my_customer تحت‌اللفظی

نصب اجباری برنامه

نمونه‌های زیر برای «واحد سازمانی» است. درخواست «گروه» نیز یکسان خواهد بود، به‌جز targetResource که به‌جای «orgunits/» قبل‌از شناسه، «groups/» خواهد داشت.

در اینجا، برنامه Google Drawings را برای نصب اجباری تنظیم می‌کنیم:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.users.apps.InstallType",
                        value: {appInstallType: "FORCED"}
                        },
                updateMask: {paths: "appInstallType"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

پاسخ موفق باید خالی باشد:

{}

این مثال برای «برنامه کاربر» است. درخواست «جلسه مهمان مدیریت‌شده» یکسان خواهد بود، با این تفاوت که طرح‌واره خط‌مشی chrome.devices.managedguest.apps.InstallType خواهد بود. درخواست معادل خط‌مشی «برنامه کیوسکی» به‌شرح زیر است:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.apps.ForceInstall",
                        value: {forceInstall: false}
                        },
                updateMask: {paths: "forceInstall"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

پاسخ موفق باید خالی باشد:

{}

درحال حذف برنامه

حذف برنامه باید در «واحد سازمانی» که برنامه به‌طور صریح برای مدیریت به آن اضافه شده است انجام شود. هنگام فراخوانی حل‌وفصل، فیلد addedSourceKey حاوی «واحد سازمانی» است که برای مدیریت به آن اضافه شده است. به عبارت دیگر، delete فقط باید برای برنامه‌هایی فراخوانده شود که «واحد سازمانی» در addedSourceKey با «واحد سازمانی» در policyTargetKey برابر باشد.

برای حذف کردن برنامه (برداشتن صریح آن از مدیریت)، باید درخواست batchInherit ارسال کنید که در آن policySchema طرح‌واره نوع برنامه داده‌شده است و به‌جای خط‌مشی خاص، ستاره (*) قرار دارد. در این مثال، برنامه Google Drawings را که در «واحد سازمانی» «04fatzly4jbjho9» نصب شده است حذف می‌کنیم:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:gbchcmhmhahfdphkhkmpfmihenigjmpp"}
                        },
                policySchema: "chrome.users.apps.*",
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchInherit"

پاسخ موفق باید خالی باشد:

{}

درخواست‌های حذف برنامه‌های «کیوسک» و برنامه‌های «جلسه مهمان مدیریت‌شده» به‌ترتیب از طرح‌واره‌های chrome.devices.kiosk.apps.\* و chrome.devices.managedguest.apps.\* استفاده می‌کنند.

دریافت خط‌مشی نصب برنامه برای برنامه‌ای در «واحد سازمانی»

برای دریافت خط‌مشی برای برنامه‌ای خاص، باید هم خط‌مشی و هم شناسه برنامه را در درخواست مشخص کنید. در این مثال، مقدار خط‌مشی InstallType را برای برنامه Google Drawings می‌خوانیم:

درخواست

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

پاسخ

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    }
  ]
}

دریافت خط‌مشی نصب برنامه برای همه برنامه‌ها در «واحد سازمانی»

اگر شناسه برنامه از درخواست در مثال قبلی حذف شود، به درخواستی برای مقدار خط‌مشی InstallType برای همه برنامه‌های تحت آن واحد سازمانی تبدیل خواهد شد.

درخواست

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

پاسخ

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

فهرست کردن همه خط‌مشی‌های برنامه در «واحد سازمانی»

همان‌طور که می‌توانید شناسه برنامه را از درخواست بازیابی خط‌مشی‌ها برای همه برنامه‌ها حذف کنید، می‌توانید بااستفاده از نویسه عام در خط‌مشی، همه خط‌مشی‌های یک برنامه را نیز دریافت کنید. در این مثال، مقادیر همه خط‌مشی‌ها را برای برنامه Google Drawings دریافت می‌کنیم.

درخواست

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

پاسخ

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

فهرست کردن همه خط‌مشی‌ها برای همه برنامه‌ها در «واحد سازمانی»

می‌توان شناسه برنامه را حذف کرد و از نویسه عام در خط‌مشی استفاده کرد تا همه تنظیمات برنامه برای همه برنامه‌های تحت واحد سازمانی درخواست شود.

درخواست

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

پاسخ

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.AccessToKeys",
        "value": {
          "allowAccessToKeys": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

درحال پاک کردن Kiosk Appsconfig AutoLaunchApp

برای پاک کردن AutoLaunchApp، شناسه برنامه را می‌توان روی «هیچ‌کدام» تنظیم کرد.

توجه داشته باشید که وقتی appId روی «هیچ‌کدام» تنظیم شود، همه تنظیمات دیگر AutoLaunchApp روی مقادیر پیش‌فرضشان تنظیم خواهند شد. در این حالت، هرگونه تنظیمات AutoLaunchApp به‌جز appId که در درخواست ارسال می‌شود نادیده گرفته خواهد شد.

درخواست

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9"
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.appsconfig.AutoLaunchApp",
                        value: {appId: "None"}
                        },
                updateMask: {paths: "appId"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

پاسخ

پاسخ موفق خالی است.

{}