Aşağıdaki isteklerde, uygulama politikaları örnek olarak kullanılarak Policy API ile politika yönetimi gösterilmektedir. Başlamadan önce Chrome Policy API'ye Genel Bakış ve Politika şemaları kılavuzunu incelediğinizden emin olun.
Aşağıda sunulan tüm istekler aşağıdaki değişkenleri kullanır:
$TOKEN
- OAuth 2 jetonu$CUSTOMER
- Müşterinin kimliği veya değişmez değermy_customer
Uygulamayı zorunlu olarak yükleme
Aşağıdaki örnekler bir Kuruluş Birimi içindir. targetResource hariç Grup isteği aynı olur. targetResource ile kimlikten önce "orgunits/" yerine "groups/" bulunur.
Burada, Google Çizimler uygulamasını zorunlu yüklenecek şekilde ayarlıyoruz:
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"
Başarılı bir yanıt boş olmalıdır:
{}
Bu örnek, bir kullanıcı uygulaması içindir. Yönetilen Misafir Oturumu isteği aynı olur. Tek fark, politika şemasının chrome.devices.managedguest.apps.InstallType
olmasıdır. Eşdeğer Kiosk Uygulaması politikası isteği aşağıdaki gibidir:
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"
Başarılı bir yanıt boş olmalıdır:
{}
Uygulama silme
Uygulama silme işlemi, uygulamanın yönetim için açıkça eklendiği Kuruluş Biriminde yapılmalıdır. Çözüm çağırırken addedSourceKey
alanında yönetim için eklendiği Kuruluş Birimi bulunur. Başka bir deyişle, delete
yalnızca addedSourceKey
bölgesindeki Kuruluş Birimi policyTargetKey
içindeki Kuruluş Birimine eşit olan uygulamalar için çağrılmalıdır.
Bir uygulamayı silmek (açıkça olarak yönetimden kaldırmak) için belirli bir uygulama türünün şeması olan policySchema
ve belirli bir politika yerine yıldız (*) içeren bir batchInherit
isteği göndermeniz gerekir. Bu örnekte, "04fatzly4jbjho9" Kuruluş Biriminde yüklü olan Google Çizimler uygulamasını siliyoruz:
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"
Başarılı bir yanıt boş olmalıdır:
{}
Kiosk uygulamalarını ve Yönetilen Misafir Oturumu uygulamalarını silme istekleri sırasıyla chrome.devices.kiosk.apps.\*
ve chrome.devices.managedguest.apps.\*
şemalarını kullanır.
Bir Kuruluş Birimindeki bir uygulama için Uygulama yükleme politikası alma
Belirli bir uygulamayla ilgili politika almak için istekte hem politikayı hem de Uygulama Kimliği'ni belirtmeniz gerekir. Bu örnekte, Google Çizimler uygulaması için Yükleme Türü politikasının değerini okuyoruz:
İstek
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"
Yanıt
{
"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"
}
}
]
}
Bir Kuruluş Birimindeki tüm uygulamalar için Uygulama yükleme politikası alma
Uygulama Kimliği önceki örnekte istekten çıkarılırsa bu, söz konusu kuruluş birimi altındaki tüm uygulamalar için UploadType politikasının değeri için bir istek haline gelir.
İstek
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"
Yanıt
{
"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"
}
},
...
]
}
Bir Kuruluş Birimindeki bir uygulama için tüm politikaları listeleme
Tüm uygulamalara ilişkin politikaları almak için Uygulama Kimliğini istekten çıkarabileceğiniz gibi, politikada bir joker karakter kullanarak tek bir uygulamaya ilişkin tüm politikaları da alabilirsiniz. Bu örnekte, Google Çizimler uygulamasıyla ilgili tüm politikaların değerlerini alıyoruz.
İstek
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"
Yanıt
{
"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"
}
},
...
]
}
Bir Kuruluş Birimindeki tüm uygulamalar için tüm politikaları listeleme
Bir kuruluş birimi altındaki tüm uygulamalar için tüm uygulama ayarlarını istemek amacıyla politikada uygulama kimliği atlanabilir ve joker karakter kullanılabilir.
İstek
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"
Yanıt
{
"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'i temizleme
AutoLaunchApp'i temizlemek için appId değeri "None" olarak ayarlanabilir.
appId değeri "None" olarak ayarlandığında diğer tüm AutoLaunchApp ayarlarının varsayılan değerlerine ayarlanacağını unutmayın. Bu durumda, istekte gönderilen appId dışındaki AutoLaunchApp ayarları yoksayılır.
İstek
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"
Yanıt
Başarılı bir yanıt boş.
{}