Chrome Policy API の概要

Chrome Policy API は、Chrome 管理者が組織内の組織部門に割り当てられた Chrome ポリシーをプログラムで表示、管理できるようにする一連のサービスです。この API を使用すると、Chrome 管理者は組織内での ChromeOS デバイスと Chrome ブラウザの使用状況に関する分析情報を取得できます。

主なメリット

  • Google 管理コンソールの互換性: API に加えた変更は Google 管理コンソールの UI にも反映され、その逆も同様です。

  • 監査ロギング: この API に加えた変更は、標準の管理監査ログに記録されます。

  • データ駆動アプローチ: Chrome ポリシーはデータとして表現され、API インターフェースによって直接参照されることはありません。これによって、追加開発を行うことなく、将来の Chrome ポリシーを使用する際にも API クライアントを自動化できます。将来にわたって、API でサポートするポリシーの数は増えていきます。

  • Admin SDK API を補完: この API は、Chrome 管理者が次のタスクを実行できる Admin SDK API を補完します。

次の表に、この API で実行できる主なタスクを示します。リクエストとレスポンスの例を確認するには、コードサンプルをご覧ください。

URL は https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER に対する相対パスです。

タスクの説明 相対 URL HTTP メソッド リクエスト パラメータ
ポリシー スキーマを一覧表示する ./policySchemas GET 省略可: filter, pageSize, pageToken
ポリシー スキーマを取得する ./policySchemas/$SCHEMA_NAME GET  
組織部門またはグループのポリシーの取得または一覧表示 ./policies:resolve POST 必須: policySchemaFilter、policyTargetKey

省略可: pageSize, pageToken

組織部門のポリシーの変更 ./policies/orgunits:batchModify POST 必須: requests: {policyTargetKey, policyValue, updateMask}
組織部門のポリシーの継承 ./policies/orgunits:batchInherit POST 必須: requests: {policyTargetKey, policySchema}
グループのポリシーを変更する ./policies/groups:batchModify POST 必須: requests: {policyTargetKey, policyValue, updateMask}
グループ内のポリシーを削除する ./policies/groups:batchDelete POST 必須: requests: {policyTargetKey, policySchema}
グループ内の優先順位を一覧表示する ./policies/groups:listGroupPriorityOrdering POST 必須: requests: {policyTargetKey, policyNamespace}
グループ内の優先順位を更新する ./policies/groups:updateGroupPriorityOrdering POST 必須: requests: {policyTargetKey, policyNamespace, groupIds}
ポリシーのファイルのアップロード ./policies/files:uploadPolicyFile POST 必須: requests: {policyField}

使用量上限

この API は、Chrome のお客様の組織内でのみ使用できます。詳しくは、Chrome Policy API の利用規約をご覧ください。Google と提携して商用 API クライアントを作成するには、パートナー申請を行ってください。

次のステップ