このページは Cloud Translation API によって翻訳されました。

アプリポリシーのコードサンプル

以下のリクエストは、アプリポリシーを例として、Policy API によるポリシー管理を示しています。始める前に、Chrome Policy API の概要とポリシースキーマガイドを確認してください。

以下に示すリクエストでは、次の変数を使用します。

$TOKEN - OAuth 2 トークン
$CUSTOMER - 顧客の ID またはリテラル my_customer

アプリを自動インストールする

次の例は組織部門の例です。グループリクエストは、targetResource を除き同じです。targetResource では、ID の前に「orgunits/」ではなく「groups/」が付いています。

ここでは、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 である点だけ異なっています。同等のキオスクアプリポリシーリクエストは次のとおりです。

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"

成功した場合のレスポンスは空です。

{}

アプリの削除

アプリの削除は、管理のためにアプリが明示的に追加された組織部門で行う必要があります。resolve を呼び出すと、addedSourceKey フィールドには、管理のために追加された組織部門が含まれます。つまり、delete は、addedSourceKey の組織部門が policyTargetKey の組織部門と一致するアプリでのみ呼び出す必要があります。

アプリを削除（管理から明示的に削除）するには、batchInherit リクエストを送信します。このリクエストでは、policySchema が特定のアプリタイプのスキーマであり、特定のポリシーの代わりにアスタリスク（*）が付いています。この例では、組織部門「04fatzly4jbjho9」にインストールされている Google 図形描画アプリを削除します。

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.\* のスキーマが使用されます。

組織部門のアプリについて、アプリインストールポリシーを取得する

特定のアプリのポリシーを取得するには、リクエストでポリシーとアプリ ID の両方を指定する必要があります。この例では、Google 図形描画アプリの InstallType ポリシーの値を読み取ります。

リクエスト

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

組織部門のすべてのアプリについて、アプリインストールポリシーを取得する

前の例のリクエストからアプリ ID を省略すると、その組織部門に属するすべてのアプリの 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"
      }
    },
    ...
  ]
}

組織部門のアプリについて、ポリシーの一覧を取得する

リクエストからアプリ ID を省略することで、すべてのアプリのポリシーを取得できるのと同様に、ポリシーにワイルドカードを使用することで、1 つのアプリに関するすべてのポリシーを取得できます。この例では、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"
      }
    },
    ...
  ]
}

組織部門のすべてのアプリについて、ポリシーの一覧を取得する

アプリ ID を省略し、ポリシーにワイルドカードを使用すると、組織部門のすべてのアプリについて、すべてのアプリ設定をリクエストできます。

リクエスト

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

キオスク Appsconfig AutoLaunchApp のクリア

AutoLaunchApp を消去するには、appId を「None」に設定します。

appId を「None」に設定すると、他の AutoLaunchApp の設定はすべてデフォルト値に設定されます。この場合、リクエストで送信された appId 以外の AutoLaunchApp 設定は無視されます。

リクエスト

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"

レスポンス

成功した場合のレスポンスは空です。

{}

アプリ ポリシーのコードサンプル コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

アプリを自動インストールする

アプリの削除

組織部門のアプリについて、アプリ インストール ポリシーを取得する

リクエスト

レスポンス

組織部門のすべてのアプリについて、アプリ インストール ポリシーを取得する

リクエスト

レスポンス

組織部門のアプリについて、ポリシーの一覧を取得する

リクエスト

レスポンス

組織部門のすべてのアプリについて、ポリシーの一覧を取得する

リクエスト

レスポンス

キオスク Appsconfig AutoLaunchApp のクリア

リクエスト

レスポンス

アプリポリシーのコードサンプル

組織部門のアプリについて、アプリインストールポリシーを取得する

組織部門のすべてのアプリについて、アプリインストールポリシーを取得する