Ta strona została przetłumaczona przez Cloud Translation API.

Przykładowy kod dla zasad aplikacji

W poniższych żądaniach poniżej przedstawiono zarządzanie zasadami za pomocą interfejsu Policy API z wykorzystaniem zasad aplikacji. Zanim zaczniesz, zapoznaj się z omówieniem interfejsu Chrome Policy API i przewodnikiem po schematach zasad.

Wszystkie żądania przedstawione poniżej korzystają z tych zmiennych:

$TOKEN – token OAuth 2
$CUSTOMER – identyfikator klienta lub literał my_customer.

Wymuszanie instalacji aplikacji

Poniższe przykłady dotyczą jednostki organizacyjnej. Żądanie dotyczące grupy byłoby takie samo, ale z wyjątkiem zasobu targetResource, który przed identyfikatorem miałby ciąg „groups/” zamiast „orgunits/”.

W tym miejscu ustawiamy wymuszanie instalacji aplikacji Rysunki 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"

Pomyślna odpowiedź powinna być pusta:

{}

Ten przykład dotyczy aplikacji użytkownika. Żądanie zarządzanej sesji gościa byłoby identyczne z tą różnicą, że schemat zasad to chrome.devices.managedguest.apps.InstallType. Odpowiednie żądanie zasad aplikacji kiosku wygląda tak:

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"

Pomyślna odpowiedź powinna być pusta:

{}

Usuwanie aplikacji

Aplikację należy usunąć w jednostce organizacyjnej, w której została specjalnie dodana na potrzeby zarządzania. Podczas wywoływania rozstrzygania pole addedSourceKey zawiera jednostkę organizacyjną, do której zostało dodane na potrzeby zarządzania. Innymi słowy, właściwość delete powinna być wywoływana tylko w przypadku aplikacji, w których jednostka organizacyjna addedSourceKey jest równa jednostce w policyTargetKey.

Aby usunąć aplikację (wyraźnie usunąć ją z systemu zarządzania), należy wysłać żądanie batchInherit, w którym policySchema to schemat danego typu aplikacji, gdzie zamiast określonej zasady występuje gwiazdka (*). W tym przykładzie usuwamy aplikację Rysunki Google, która jest zainstalowana w jednostce organizacyjnej „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"

Pomyślna odpowiedź powinna być pusta:

{}

Żądania usunięcia aplikacji kiosku i aplikacji z zarządzanej sesji gościa używają odpowiednio schematu chrome.devices.kiosk.apps.\* i chrome.devices.managedguest.apps.\*.

Pobieranie zasad instalowania aplikacji w jednostce organizacyjnej

Aby pobrać zasadę dla określonej aplikacji, musisz w żądaniu określić zarówno zasadę, jak i identyfikator aplikacji. W tym przykładzie czytamy wartość zasady CheckType dla aplikacji Rysunki Google:

Prośba

  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"

Odpowiedź

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

Pobieranie zasad instalowania aplikacji dla wszystkich aplikacji w jednostce organizacyjnej

Jeśli identyfikator aplikacji zostanie pominięty w żądaniu w poprzednim przykładzie, staje się to żądaniem o wartości zasady RequestType w przypadku wszystkich aplikacji w tej jednostce organizacyjnej.

Prośba

  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"

Odpowiedź

{
  "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"
      }
    },
    ...
  ]
}

Wyświetlanie listy wszystkich zasad dotyczących aplikacji w jednostce organizacyjnej

Podobnie jak w żądaniu pobierania zasad dla wszystkich aplikacji możesz pominąć identyfikator aplikacji, możesz też pobrać wszystkie zasady dla danej aplikacji, używając symbolu wieloznacznego w zasadzie. W tym przykładzie pobieramy wartości wszystkich zasad aplikacji Rysunki Google.

Prośba

  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"

Odpowiedź

{
  "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"
      }
    },
    ...
  ]
}

Wyświetlanie listy wszystkich zasad dla wszystkich aplikacji w jednostce organizacyjnej

Identyfikator aplikacji można pominąć, a w zasadzie można użyć symbolu wieloznacznego, aby zażądać wszystkich ustawień aplikacji w jednostce organizacyjnej.

Prośba

  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"

Odpowiedź

{
  "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"
      }
    },
    ...
  ]
}

Czyszczę funkcję automatycznego uruchamiania aplikacji Kiosk Appsconfig

Aby wyczyścić aplikację AutoLaunchApp, parametr appId może mieć wartość „Brak”.

Pamiętaj, że gdy ustawisz wartość appId na „Brak”, wszystkie pozostałe ustawienia funkcji AutoLaunchApp zostaną zmienione na wartości domyślne. Wszelkie ustawienia AutoLaunchApp oprócz identyfikatora appId wysyłane w żądaniu zostaną w tym przypadku zignorowane.

Prośba

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"

Odpowiedź

Pomyślna odpowiedź jest pusta.

{}