Uygulama politikaları için kod örnekleri

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ğer my_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ş.

{}