عيّنات تعليمات برمجية لسياسات التطبيق

توضّح الطلبات أدناه إدارة السياسات من خلال Policy API باستخدام سياسات التطبيقات كمثال. قبل البدء، تأكد من مراجعة نظرة عامة على Chrome Policy API دليل مخططات السياسات:

تستخدِم جميع الطلبات المقدَّمة أدناه المتغيرات التالية:

• $TOKEN - رمز OAuth 2 المميز
• $CUSTOMER - معرّف العميل أو الحرف my_customer

تثبيت تطبيق تلقائيًا

الأمثلة التالية متعلقة بوحدة تنظيمية. سيكون طلب المجموعة نفس الشيء باستثناء targetResource، الذي سيحتوي على "groups/" بدلاً من "orgunits/ " قبل المعرّف.

في ما يلي، نعمل على ضبط تطبيق "رسومات Google" ليكون مثبَّتًا من المؤسّسة:

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 سياسة تطبيق Kiosk المكافئ يكون طلبك على النحو التالي:

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" المثبّت على "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"

يجب أن يكون الرد الناجح فارغًا:

{}

ستستخدم طلبات حذف تطبيقات Kiosk وتطبيقات "جلسات الضيف المُدارة" chrome.devices.kiosk.apps.\* وchrome.devices.managedguest.apps.\* على التوالي.

الحصول على سياسة تثبيت التطبيقات لتطبيق في وحدة تنظيمية

للحصول على سياسة لتطبيق معيّن، عليك تحديد كل من السياسة ومعرّف التطبيق. في الطلب. في هذا المثال، نقرأ قيمة InstallType سياسة تطبيق رسومات Google:

الطلب

  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/$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/$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".

الطلب

  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/$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/$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.CertificateManagement",
        "value": {
          "allowAccessToKeys": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

جارٍ محو تطبيق Kiosk Appsconfig AutoLaunchApp

لمحو تطبيق AutoLaunchApp، يمكن ضبط قيمة appId على "None".

عند ضبط قيمة appId على "None" ("بدون")، سيتم تطبيق جميع إعدادات 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"

الرد

الرد الناجح فارغ.

{}